queryParam(String key, String value)メソッド
説明
このオブジェクト(WebResourceオブジェクト)から新しくWebResourceオブジェクトを生成します。生成されるオブジェクトが保持するWebリソースのURIは,このオブジェクトが保持するWebリソースのURIに,パラメタに指定されたクエリパラメタが追加されたURIです。
構文
public WebResource queryParam(String key,
String value)
パラメタ
- key
-
クエリパラメタ名です。
- value
-
クエリパラメタの値です。
戻り値
新しく生成したWebResourceオブジェクトを返します。
注意事項
-
keyパラメタまたはvalueパラメタのどちらかにnullが設定された場合,IllegalArgumentExceptionがスローされます。
-
keyパラメタおよびvalueパラメタには正しいクエリパラメタの名称および値を指定してください。無効な文字は,標準仕様に従って自動的にURLエンコードされます。
-
エンコードされない文字は次のとおりです。
! $ ' ( ) * - / ; ? @ _ ~ . ,
半角英数字(0〜9,A〜Z,a〜z)
-
すでにURLエンコードされたトークンは正しく認識されるため,二重にURLエンコードされることはありません。
-
空白は「+」にエンコードされます。
-
新しく生成されるWebResourceオブジェクトのクエリパラメタは,このオブジェクト(WebResourceオブジェクト)のクエリパラメタに,パラメタに指定されたクエリパラメタが追加されたものです。なお,同じ名称のクエリパラメタがこのオブジェクトに存在している場合も含みます。
-
-
このオブジェクト(WebResourceオブジェクト)のエンティティは,このメソッドで新しく生成されたWebResourceオブジェクトにはコピーされません。