setFollowRedirects(Boolean redirect)メソッド
説明
HTTPリダイレクトに自動的に従うべきかどうかを設定します。
このメソッドは,getProperties()メソッドで取得したプロパティのマップにClientConfig.PROPERTY_FOLLOW_REDIRECTSプロパティを設定する場合と機能は同じです。
構文
public void setFollowRedirects(Boolean redirect)
パラメタ
- redirect
-
trueの場合,クライアントはステータスコードが300番台のHTTPレスポンスに記述されたURIに自動的にリダイレクトされます。
戻り値
ありません。
注意事項
-
redirectパラメタで設定した値によるクライアントの動作は,HttpURLConnectionクラスのsetInstanceFollowRedirects()メソッドと同じです。詳細については,JDKのドキュメントを参照してください。
-
JAX-RSエンジンはredirectパラメタに設定された値を検証しません。HTTP通信に先立って,そのままHttpURLConnectioinにコピーします。redirectパラメタには,Java SEのHttpURLConnectionクラスのsetInstanceFollowRedirects()メソッドの説明に従って値を設定してください。
-
クライアントのプロパティマップに,すでにClientConfig.PROPERTY_FOLLOW_REDIRECTS で指定した値が含まれている場合,redirectパラメタで指定された値が上書きされます。
-
redirectパラメタで指定された値によってHTTPリクエストまたはHTTPレスポンスの処理中に例外が発生した場合,エラーとなり(KDJJ18888-E),その例外をラップしたClientHandlerExceptionがスローされます。