- java.lang.Object
-
- jdk.incubator.http.HttpClient.Builder
-
- 含まれているクラス:
- HttpClient
public abstract static class HttpClient.Builder extends Object
不変のHttpClient
のビルダー。HttpClient.Builder
は、HttpClient.newBuilder()
を呼び出すことによって作成されます。
インキュベーション機能。将来のリリースで削除されます。このクラスの各セッター・メソッドは、ビルダーの状態を変更し、this (すなわち、同じインスタンス)を返します。 メソッドは同期されておらず、外部同期なしで複数のスレッドから呼び出されるべきではありません。
build()
は、呼び出されるたびに新しいHttpClient
を返します。- 導入されたバージョン:
- 9
-
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
Builder()
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract HttpClient.Builder
authenticator(Authenticator a)
HTTP認証に使用するオーセンティケータを設定します。abstract HttpClient
build()
このビルダーの現在の状態から構築されたHttpClient
を返します。abstract HttpClient.Builder
cookieManager(CookieManager cookieManager)
クッキー・マネージャを設定します。abstract HttpClient.Builder
executor(Executor executor)
非同期タスクに使用されるエグゼキュータを設定します。abstract HttpClient.Builder
followRedirects(HttpClient.Redirect policy)
リクエストがサーバーによって発行されたリダイレクトに自動的に従うかどうかを指定します。abstract HttpClient.Builder
priority(int priority)
このクライアントから送信されたHTTP/2リクエストのデフォルトの優先度を設定します。abstract HttpClient.Builder
proxy(ProxySelector selector)
このクライアントのProxySelector
を設定します。abstract HttpClient.Builder
sslContext(SSLContext sslContext)
SSLContext
を設定します。abstract HttpClient.Builder
sslParameters(SSLParameters sslParameters)
SSLParameters
を設定します。abstract HttpClient.Builder
version(HttpClient.Version version)
可能であれば、特定のHTTPプロトコル・バージョンをリクエストします。
-
-
-
メソッドの詳細
-
cookieManager
public abstract HttpClient.Builder cookieManager(CookieManager cookieManager)
クッキー・マネージャを設定します。- パラメータ:
cookieManager
- クッキー・マネージャ- 戻り値:
- このビルダー
-
sslContext
public abstract HttpClient.Builder sslContext(SSLContext sslContext)
SSLContext
を設定します。 セキュリティ・マネージャが設定されている場合、呼び出し側はNetPermission
("setSSLContext"
)このメソッドを呼び出さないと、デフォルトの
SSLContext
が使用されます。これは通常、プロトコルを指定する必要のないクライアント・アプリケーションやクライアント認証が必要なクライアント・アプリケーションに適しています。- パラメータ:
sslContext
- SSLContext- 戻り値:
- このビルダー
- 例外:
SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合
-
sslParameters
public abstract HttpClient.Builder sslParameters(SSLParameters sslParameters)
SSLParameters
を設定します。 このメソッドが呼び出されない場合は、デフォルトのパラメータ・セットが使用されます。 指定されたオブジェクトの内容がコピーされます。 HTTPプロトコル実装(アプリケーション・プロトコル・リスト)によって内部的に使用されるいくつかのパラメータは、呼び出し元によって無視されるため、設定しないでください。- パラメータ:
sslParameters
- SSLParameters- 戻り値:
- このビルダー
-
executor
public abstract HttpClient.Builder executor(Executor executor)
非同期タスクに使用されるエグゼキュータを設定します。 このメソッドが呼び出されない場合は、Executors.newCachedThreadPool
から返されるデフォルトのexecutorが設定されます。- パラメータ:
executor
- エグゼクティブ- 戻り値:
- このビルダー
-
followRedirects
public abstract HttpClient.Builder followRedirects(HttpClient.Redirect policy)
- パラメータ:
policy
- リダイレクト・ポリシー- 戻り値:
- このビルダー
-
version
public abstract HttpClient.Builder version(HttpClient.Version version)
可能であれば、特定のHTTPプロトコル・バージョンをリクエストします。 設定されていない場合、バージョンはデフォルトでHttpClient.Version.HTTP_2
になります。HttpClient.Version.HTTP_2
が設定されている場合、各リクエストはHTTP/2にアップグレードしようとします。 アップグレードが成功すると、このリクエストに対するレスポンスはHTTP/2を使用し、その後のすべてのリクエストと同じ「オリジン・サーバー」へのレスポンスはHTTP/2を使用します。 アップグレードが失敗した場合、レスポンスはHTTP/1.1を使用して処理されます- パラメータ:
version
- リクエストされたHTTPプロトコルのバージョン- 戻り値:
- このビルダー
-
priority
public abstract HttpClient.Builder priority(int priority)
このクライアントから送信されたHTTP/2リクエストのデフォルトの優先度を設定します。 指定する値は、1
と256
(inclusive)の間にある必要があります。- パラメータ:
priority
- 優先度の重み付け- 戻り値:
- このビルダー
- 例外:
IllegalArgumentException
- 指定された優先度が範囲外の場合
-
proxy
public abstract HttpClient.Builder proxy(ProxySelector selector)
このクライアントのProxySelector
を設定します。 セレクタが設定されていない場合、プロキシは使用されません。null
パラメータが指定されると、システム全体のデフォルト・プロキシ・セレクタが使用されます。- 実装上の注意:
ProxySelector.of(InetSocketAddress)
は、すべてのリクエストに対して1つのプロキシを使用するProxySelector
を提供します。- パラメータ:
selector
- ProxySelector- 戻り値:
- このビルダー
-
authenticator
public abstract HttpClient.Builder authenticator(Authenticator a)
HTTP認証に使用するオーセンティケータを設定します。- パラメータ:
a
- オーセンティケータ- 戻り値:
- このビルダー
-
build
public abstract HttpClient build()
このビルダーの現在の状態から構築されたHttpClient
を返します。- 戻り値:
- このビルダー
-
-