コンストラクターの詳細

• HttpComponentsClientHttpRequestFactory

  public HttpComponentsClientHttpRequestFactory()

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

• HttpComponentsClientHttpRequestFactory

  public HttpComponentsClientHttpRequestFactory(HttpClient httpClient)

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

  パラメーター:

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

メソッドの詳細

• setHttpClient

  public void setHttpClient(HttpClient httpClient)

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

• getHttpClient

  public 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 を使用して、すべての呼び出しが同じクライアント ID に関連付けられた特定の RestTemplate インスタンスを介して行われる相互 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 RequestConfig createRequestConfig(ObjectSE client)

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

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

  パラメーター:

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

  戻り値:

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

  導入:

  4.2

  関連事項:

  mergeRequestConfig(RequestConfig)

• mergeRequestConfig

  protected RequestConfig mergeRequestConfig(RequestConfig clientConfig)

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

  パラメーター:

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

  戻り値:

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

  導入:

  4.2

• createHttpUriRequest

  protected HttpUriRequest createHttpUriRequest(HttpMethod httpMethod,
                                                URISE uri)

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

  パラメーター:

  httpMethod - HTTP メソッド

  uri - URI

  戻り値:

  Commons HttpMethodBase オブジェクト

• postProcessHttpRequest

  protected void postProcessHttpRequest(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 もリソースを解放できます。