path(String path)メソッド
説明
このオブジェクト(WebResourceオブジェクト)から新しくWebResourceオブジェクトを生成します。生成されるオブジェクトが保持するWebリソースのURIは,このオブジェクトが保持するWebリソースのURIにパラメタで指定されたパスが追加されたURIです。
構文
public WebResource path(String path)
パラメタ
- path
-
追加するパスです。
戻り値
新しく生成したWebResourceオブジェクトを返します。
注意事項
-
pathパラメタにnullが設定された場合,IllegalArgumentExceptionがスローされます。
-
pathパラメタにはnull以外の正しいパスを指定してください。無効な文字は,標準仕様に従って自動的にURLエンコードされます。
-
クエリストリングはパスの一部ではないため,疑問符(?)は無効な文字と見なされて自動的にURLエンコードされることに注意してください。エンコードされない文字は次のとおりです。
! $ & ' ( ) * + - / ; = @ _ ~ . ,
半角英数字(0〜9,A〜Z,a〜z)
すでにURLエンコードされたトークンは正しく認識されるため,二重にURLエンコードされることはありません。
-
このオブジェクト(WebResourceオブジェクト)が保持するWebリソースのURIとpathパラメタで指定されたパスの間には,必要に応じて自動的にスラッシュ(/)が挿入されます。またスラッシュ(/)が二重になるような場合は自動的に補正されます。
-
このオブジェクト(WebResourceオブジェクト)のエンティティは,このメソッドで新しく生成されたWebResourceオブジェクトにはコピーされません。