HttpClientOptions クラス

public HttpClientOptions()

HttpClientOptions の新しいインスタンスを作成します。

public Configuration getConfiguration()

が使用する構成ストアを HttpClient 取得します。

Returns:

public Duration getConnectTimeout()

送信する要求の接続タイムアウトを取得します。

既定の接続タイムアウトは 10 秒です。

Returns:

public Duration getConnectionIdleTimeout()

アイドル状態の接続が閉じられるまでの時間を取得します。

既定の接続アイドル タイムアウトは 60 秒です。

Returns:

public Class getHttpClientProvider()

のインスタンスを HttpClientProvider 構築するために使用する実装の HttpClient型を取得します。

Returns:

public Integer getMaximumConnectionPoolSize()

基になる HTTP クライアントによって使用される最大接続プール サイズを取得します。

接続プールの最大サイズを変更すると、アプリケーションのパフォーマンスに影響を及ぼす可能性があります。 最大接続プールを増やすと、アプリケーションで使用できる接続が増えますが、ネットワーク リソースの競合が増える可能性があります。 アプリケーションに適した構成を見つけるために、さまざまな最大接続プール サイズに対してパフォーマンス分析を実行することをお勧めします。

この最大接続プール サイズはグローバル構成ではなく、この HttpClientOptionsを使用して作成された各 HttpClient インスタンス レベルの構成です。

既定の最大接続プール サイズは、基になる HTTP クライアントによって決まります。 最大接続プール サイズを null に設定すると、基になる HTTP クライアントによって決定される既定値を使用するように構成がリセットされます。

Returns:

public ProxyOptions getProxyOptions()

が ProxyOptions 使用する を HttpClient 取得します。

Returns:

public Duration getReadTimeout()

サーバー応答の読み取り時に使用される読み取りタイムアウト時間を取得します。

既定の読み取りタイムアウトは 60 秒です。

Returns:

public Duration getResponseTimeout()

サーバーの応答を待機するときに使用される応答タイムアウト時間を取得します。

既定の応答タイムアウトは 60 秒です。

Returns:

public Duration getWriteTimeout()

送信する要求の書き込みタイムアウトを取得します。

既定の書き込みタイムアウトは 60 秒です。

Returns:

public HttpClientOptions readTimeout(Duration readTimeout)

サーバー応答の読み取り時に使用される読み取りタイムアウト時間を設定します。

読み取りタイムアウトは、サーバー応答の受信後に最初の応答の読み取りがトリガーされると開始されます。 このタイムアウトは定期的にトリガーされますが、タイムアウトがトリガーされて完了するまでに別の読み取り操作が完了した場合、その操作は発生しません。

が null の場合readTimeout、または 60 秒のタイムアウトが使用されます。0 以下の場合、Duration応答読み取りにはタイムアウト期間は適用PROPERTY_AZURE_REQUEST_READ_TIMEOUTされません。 タイムアウトを適用する場合、最大 1 ミリ秒と の readTimeout 値が使用されます。

既定の読み取りタイムアウトは 60 秒です。

Parameters:

Returns:

public HttpClientOptions responseTimeout(Duration responseTimeout)

サーバーの応答を待機するときに使用される応答タイムアウト時間を設定します。

応答タイムアウトは、要求の書き込みが完了すると開始され、サーバー応答の受信時に最初の応答の読み取りがトリガーされると完了します。

が null PROPERTY_AZURE_REQUEST_RESPONSE_TIMEOUT の場合responseTimeout、または 60 秒のタイムアウトがDuration使用されます。0 以下の場合は、応答にタイムアウトは適用されません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の responseTimeout 値が使用されます。

既定の応答タイムアウトは 60 秒です。

Parameters:

Returns:

public HttpClientOptions setApplicationId(String applicationId)

アプリケーション ID を設定します。

applicationIdは、テレメトリ/監視の目的でを構成UserAgentPolicyするために使用されます。

詳細については、「 Azure Core: テレメトリ ポリシー 」を参照してください。

コード サンプル

アプリケーション ID 'myApplicationId' を使用して ClientOptions を作成する

ClientOptions clientOptions = new ClientOptions()
     .setApplicationId("myApplicationId");

Overrides:

Parameters:

public HttpClientOptions setConfiguration(Configuration configuration)

で使用する構成ストアを HttpClient 設定します。

Parameters:

Returns:

public HttpClientOptions setConnectTimeout(Duration connectTimeout)

送信する要求の接続タイムアウトを設定します。

接続タイムアウトは、要求がリモート ホストへの接続を試み、接続が解決されたときに終了すると開始されます。

が null PROPERTY_AZURE_REQUEST_CONNECT_TIMEOUT の場合connectTimeout、または 10 秒のタイムアウトが使用されます。0 以下の場合Duration、タイムアウトは適用されません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の connectTimeout 値が使用されます。

既定の接続タイムアウトは 10 秒です。

Parameters:

Returns:

public HttpClientOptions setConnectionIdleTimeout(Duration connectionIdleTimeout)

アイドル状態の接続前の時間を設定します。

接続のアイドル タイムアウトは、接続が最後のネットワーク要求を完了すると開始されます。 接続が使用されるたびに、アイドル タイムアウトがリセットされます。

が null の場合 connectionIdleTimeout 、60 秒のタイムアウトが Duration 使用されます。0 以下の場合、タイムアウト期間は適用されません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の connectionIdleTimeout 値が使用されます。

既定の接続アイドル タイムアウトは 60 秒です。

Parameters:

Returns:

public HttpClientOptions setHeaders(Iterable

ClientOptions clientOptions = new ClientOptions()
     .setHeaders(Collections.singletonList(new Header("myCustomHeader", "myStaticValue")));

public HttpClientOptions setHttpClientProvider(Class httpClientProvider)

のインスタンスを HttpClientProvider 構築するために使用する実装の HttpClient型を設定します。 値が設定されていないか、空の文字列である場合、ServiceLoader によって最初HttpClientProviderに解決された が のインスタンスHttpClientの作成に使用されます。 値が設定され、ServiceLoaderIllegalStateException によって解決された値HttpClientProviderと一致しない場合、 のHttpClientインスタンスを作成しようとしたときに がスローされます。

Parameters:

Returns:

public HttpClientOptions setMaximumConnectionPoolSize(Integer maximumConnectionPoolSize)

基になる HTTP クライアントで使用される最大接続プール サイズを設定します。

接続プールの最大サイズを変更すると、アプリケーションのパフォーマンスに影響を及ぼす可能性があります。 最大接続プールを増やすと、アプリケーションで使用できる接続が増えますが、ネットワーク リソースの競合が増える可能性があります。 アプリケーションに適した構成を見つけるには、さまざまな最大接続プール サイズに対してパフォーマンス分析を実行することをお勧めします。

この最大接続プール サイズはグローバル構成ではなく、この HttpClientOptionsを使用して作成されたそれぞれのHttpClientインスタンス レベルの構成です。

既定の最大接続プール サイズは、基になる HTTP クライアントによって決まります。 接続プールの最大サイズを null に設定すると、基になる HTTP クライアントによって決定された既定値を使用するように構成がリセットされます。

Parameters:

Returns:

public HttpClientOptions setProxyOptions(ProxyOptions proxyOptions)

で使用する をProxyOptionsHttpClient設定します。

Parameters:

Returns:

public HttpClientOptions setReadTimeout(Duration readTimeout)

サーバー応答の読み取り時に使用される読み取りタイムアウト時間を設定します。

読み取りタイムアウトは、サーバー応答の受信後に最初の応答の読み取りがトリガーされると開始されます。 このタイムアウトは定期的にトリガーされますが、タイムアウトがトリガーされてから完了するまでに別の読み取り操作が完了した場合、その操作は発生しません。

が null の場合readTimeout、または 60 秒のタイムアウトが使用されます。0 以下の場合、Duration応答読み取りにはタイムアウト期間は適用PROPERTY_AZURE_REQUEST_READ_TIMEOUTされません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の readTimeout 値が使用されます。

既定の読み取りタイムアウトは 60 秒です。

Parameters:

Returns:

public HttpClientOptions setResponseTimeout(Duration responseTimeout)

サーバーの応答を待機するときに使用される応答タイムアウト時間を設定します。

応答タイムアウトは、要求の書き込みが完了すると開始され、サーバー応答の受信時に最初の応答の読み取りがトリガーされると完了します。

が null PROPERTY_AZURE_REQUEST_RESPONSE_TIMEOUT の場合responseTimeout、または 60 秒のタイムアウトがDuration使用されます。0 以下の場合は、応答にタイムアウトは適用されません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の responseTimeout 値が使用されます。

既定の応答タイムアウトは 60 秒です。

Parameters:

Returns:

public HttpClientOptions setWriteTimeout(Duration writeTimeout)

送信する要求の書き込みタイムアウトを設定します。

書き込みタイムアウトは、要求全体ではなく、ネットワーク経由で送信される各放出に適用されます。 たとえば、バッファーを出力 108KB する要求本文は書き込み操作をトリガー 10 します。送信バッファーは定期的にチェックされ、まだドレイン中かどうかを判断します。

が null PROPERTY_AZURE_REQUEST_WRITE_TIMEOUT の場合writeTimeout、または 60 秒のタイムアウトがDuration使用されます。ゼロ以下の場合、書き込みタイムアウトは適用されません。 タイムアウトを適用する場合は、最大 1 ミリ秒で、 の writeTimeout 値が使用されます。

既定の書き込みタイムアウトは 60 秒です。

Parameters:

Returns: