クラス SimpleClientHttpRequestFactory

メソッドの詳細

• setProxy

  public void setProxy(ProxySE proxy)

  このリクエストファクトリに使用する ProxySE を設定します。

• setBufferRequestBody

  @DeprecatedSE(since="6.1", forRemoval=true) public void setBufferRequestBody(boolean bufferRequestBody)

  非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  6.1 リクエストは、このプロパティが false であるかのようにバッファリングされないため

  このリクエストファクトリがリクエストボディを内部でバッファリングするかどうかを示します。

  デフォルトは true です。POST または PUT を介して大量のデータを送信する場合、メモリが不足しないように、このプロパティを false に変更することをお勧めします。これにより、基になる HttpURLConnectionSE に直接ストリーミングする ClientHttpRequest（Content-Length が事前にわかっている場合）、または「チャンク転送エンコード」を使用する ClientHttpRequest が得られます（Content-Length が事前にわかっていない場合）。

  関連事項:

  • setChunkSize(int)
  • HttpURLConnection.setFixedLengthStreamingMode(int)SE

• setChunkSize

  public void setChunkSize(int chunkSize)

  リクエスト本文をローカルにバッファリングしない場合に、各チャンクに書き込むバイト数を設定します。

  このパラメーターは、bufferRequestBody が false に設定されている場合にのみ使用され、Content-Length は事前に認識されていないことに注意してください。

  関連事項:

  • setBufferRequestBody(boolean)

• setConnectTimeout

  public void setConnectTimeout(int connectTimeout)

  基礎となる URLConnection の接続タイムアウトを設定します（ミリ秒単位）。タイムアウト値 0 は、無限のタイムアウトを指定します。

  デフォルトは、システムのデフォルトのタイムアウトです。

  関連事項:

  • URLConnection.setConnectTimeout(int)SE

• setConnectTimeout

  public void setConnectTimeout(DurationSE connectTimeout)

  基礎となる URLConnection の接続タイムアウトを Duration として設定します。タイムアウト値 0 は、無限のタイムアウトを指定します。

  デフォルトは、システムのデフォルトのタイムアウトです。

  導入:

  6.1

  関連事項:

  • URLConnection.setConnectTimeout(int)SE

• setReadTimeout

  public void setReadTimeout(int readTimeout)

  基礎となる URLConnection の読み取りタイムアウトを設定します（ミリ秒単位）。タイムアウト値 0 は、無限のタイムアウトを指定します。

  デフォルトは、システムのデフォルトのタイムアウトです。

  関連事項:

  • URLConnection.setReadTimeout(int)SE

• setReadTimeout

  public void setReadTimeout(DurationSE readTimeout)

  基礎となる URLConnection の読み取りタイムアウトを設定します（ミリ秒単位）。タイムアウト値 0 は、無限のタイムアウトを指定します。

  デフォルトは、システムのデフォルトのタイムアウトです。

  導入:

  6.1

  関連事項:

  • URLConnection.setReadTimeout(int)SE

• setOutputStreaming

  @DeprecatedSE(since="6.1", forRemoval=true) public void setOutputStreaming(boolean outputStreaming)

  非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  6.1 以降、このプロパティが true であるかのように、リクエストは常にストリーミングされます。

  基になる URLConnection を「出力ストリーミング」モードに設定できる場合に設定します。デフォルトは true です。

  出力ストリーミングが有効な場合、認証とリダイレクトは自動的に処理できません。出力ストリーミングが無効になっている場合、基礎となる接続の HttpURLConnection.setFixedLengthStreamingMode(int)SE および HttpURLConnection.setChunkedStreamingMode(int)SE メソッドは呼び出されません。

  パラメーター:

  outputStreaming - 出力ストリーミングが有効な場合

• createRequest

  public ClientHttpRequest createRequest(URISE uri, HttpMethod httpMethod) throws IOExceptionSE

  インターフェースからコピーされた説明: ClientHttpRequestFactory

  指定された URI および HTTP メソッドの新しい ClientHttpRequest を作成します。

  返されたリクエストは、ClientHttpRequest.execute() を呼び出して書き込み、実行できます。

  次で指定:

  インターフェース ClientHttpRequestFactory の createRequest 

  パラメーター:

  uri - リクエストを作成する URI

  httpMethod - 実行する HTTP メソッド

  戻り値:

  作成されたリクエスト

  例外:

  IOExceptionSE - I/O エラーの場合

• openConnection

  protected HttpURLConnectionSE openConnection(URLSE url, @Nullable ProxySE proxy) throws IOExceptionSE

  指定された URL への接続を開いて返します。

  デフォルトの実装では、指定されたプロキシ（存在する場合）を使用して接続を開きます。

  パラメーター:

  url - 接続を開くための URL

  proxy - 使用するプロキシ。null の場合があります

  戻り値:

  開かれた接続

  例外:

  IOExceptionSE - I/O エラーの場合

• prepareConnection

  protected void prepareConnection(HttpURLConnectionSE connection, StringSE httpMethod) throws IOExceptionSE

  指定された HttpURLConnectionSE を準備するためのテンプレートメソッド。

  デフォルトの実装では、入力と出力の接続を準備し、HTTP メソッドを設定します。

  パラメーター:

  connection - 準備する接続

  httpMethod - HTTP リクエストメソッド (GET、POST など。)

  例外:

  IOExceptionSE - I/O エラーの場合