コンストラクターの詳細

• HttpComponentsClientHttpRequestFactory

  public HttpComponentsClientHttpRequestFactory()

  システムプロパティに基づいて、デフォルトの HttpClient を使用して HttpComponentsClientHttpRequestFactory の新しいインスタンスを作成します。

• HttpComponentsClientHttpRequestFactory

  public HttpComponentsClientHttpRequestFactory(org.apache.http.client.HttpClient httpClient)

  指定された HttpClient インスタンスを使用して HttpComponentsClientHttpRequestFactory の新しいインスタンスを作成します。

  パラメーター:

  httpClient - このリクエストファクトリに使用する HttpClient インスタンス

メソッドの詳細

• setHttpClient

  public void setHttpClient(org.apache.http.client.HttpClient httpClient)

  同期実行に使用される HttpClient を設定します。

• getHttpClient

  public org.apache.http.client.HttpClient getHttpClient()

  同期実行に使用される HttpClient を返します。

• setConnectTimeout

  public void setConnectTimeout(int timeout)

  基になる RequestConfig の接続タイムアウトを設定します。タイムアウト値 0 は、無限のタイムアウトを指定します。

  カスタム HttpClient で RequestConfig インスタンスを指定することにより、追加のプロパティを構成できます。

  このオプションは、SSL ハンドシェイクまたは CONNECT リクエストの接続タイムアウトには影響しません。そのためには、HttpClient 自体で SocketConfig を使用する必要があります。

  パラメーター:

  timeout - ミリ秒単位のタイムアウト値

  関連事項:

  RequestConfig.getConnectTimeout(), SocketConfig.getSoTimeout()

• setConnectionRequestTimeout

  public void setConnectionRequestTimeout(int connectionRequestTimeout)

  基礎となる RequestConfig を使用して接続マネージャーに接続をリクエストするときに使用されるタイムアウトをミリ秒単位で設定します。タイムアウト値 0 は、無限のタイムアウトを指定します。

  カスタム HttpClient で RequestConfig インスタンスを指定することにより、追加のプロパティを構成できます。

  パラメーター:

  connectionRequestTimeout - ミリ秒単位の接続をリクエストするタイムアウト値

  関連事項:

  RequestConfig.getConnectionRequestTimeout()

• setReadTimeout

  public void setReadTimeout(int timeout)

  基礎となる RequestConfig のソケット読み取りタイムアウトを設定します。タイムアウト値 0 は、無限のタイムアウトを指定します。

  カスタム HttpClient で RequestConfig インスタンスを指定することにより、追加のプロパティを構成できます。

  パラメーター:

  timeout - ミリ秒単位のタイムアウト値

  関連事項:

  RequestConfig.getSocketTimeout()

• setBufferRequestBody

  public void setBufferRequestBody(boolean bufferRequestBody)

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

  デフォルトは true です。POST または PUT を介して大量のデータを送信する場合、このプロパティを false に変更して、メモリが不足しないようにすることをお勧めします。

  導入:

  4.0

• setHttpContextFactory

  public void setHttpContextFactory(BiFunctionSE<HttpMethod,URISE,org.apache.http.protocol.HttpContext> httpContextFactory)

  リクエストごとに HttpContext を事前に作成するようにファクトリを構成します。

  これは、たとえば、クライアント証明書ごとに異なる RestTemplate があり、特定の RestTemplate インスタンスを介して行われるすべての呼び出しが同じクライアント ID に関連付けられている相互 TLS 認証で役立つ場合があります。HttpClientContext.setUserToken(Object) を使用して、すべてのリクエストに固定ユーザートークンを指定できます。

  パラメーター:

  httpContextFactory - 使用するコンテキストファクトリ

  導入:

  5.2.7

• 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 エラーの場合

• createRequestConfig

  @Nullable
  protected org.apache.http.client.config.RequestConfig createRequestConfig(ObjectSE client)

  特定のクライアントで使用するデフォルトの RequestConfig を作成します。null を返して、カスタムリクエスト構成を設定する必要がなく、HttpClient のデフォルトを使用する必要があることを示すことができます。

  デフォルトの実装は、クライアントのデフォルトを、このファクトリインスタンスのローカルカスタマイズ（存在する場合）とマージしようとします。

  パラメーター:

  client - チェックする HttpClient （または HttpAsyncClient）

  戻り値:

  使用する実際の RequestConfig (null の場合があります)

  導入:

  4.2

  関連事項:

  mergeRequestConfig(RequestConfig)

• mergeRequestConfig

  protected org.apache.http.client.config.RequestConfig mergeRequestConfig(org.apache.http.client.config.RequestConfig clientConfig)

  必要に応じて、指定された HttpClient -level RequestConfig をファクトリレベルの RequestConfig とマージします。

  パラメーター:

  clientConfig - 現在の設定が保持している

  戻り値:

  マージされたリクエスト設定

  導入:

  4.2

• createHttpUriRequest

  protected org.apache.http.client.methods.HttpUriRequest createHttpUriRequest(HttpMethod httpMethod,
                                                                               URISE uri)

  指定された HTTP メソッドと URI 仕様の Commons HttpMethodBase オブジェクトを作成します。

  パラメーター:

  httpMethod - HTTP メソッド

  uri - URI

  戻り値:

  Commons HttpMethodBase オブジェクト

• postProcessHttpRequest

  protected void postProcessHttpRequest(org.apache.http.client.methods.HttpUriRequest request)

  HttpComponentsClientHttpRequest の一部として返される前に HttpUriRequest を操作できるようにするテンプレートメソッド。

  デフォルトの実装は空です。

  パラメーター:

  request - 処理するリクエスト

• createHttpContext

  @Nullable
  protected org.apache.http.protocol.HttpContext createHttpContext(HttpMethod httpMethod,
                                                                             URISE uri)

  指定された HTTP メソッドと URI の HttpContext を作成するテンプレートメソッド。

  デフォルトの実装は null を返します。

  パラメーター:

  httpMethod - HTTP メソッド

  uri - URI

  戻り値:

  http コンテキスト

• destroy

  public void destroy()
               throws ExceptionSE

  基盤となる ClientConnectionManager の接続プールがある場合はそれを閉じるシャットダウンフック。

  次で指定:

  インターフェース DisposableBean の destroy 

  例外:

  ExceptionSE - シャットダウンエラーの場合。例外はログに記録されますが、再スローされず、他の Bean もリソースを解放できます。