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