インタフェースHttpOption<T>
- 型パラメータ:
T- オプション値のタイプ
パブリック・シール済インタフェースHttpOption<T>
このインタフェースは、
HttpClient実装によるHTTPリクエスト/レスポンス交換の実行方法に関する追加のリクエスト構成オプション・ヒントを提供するために使用されます。 リクエスト構成オプションのヒントは、HttpRequest.Builder setOptionメソッドを使用してHttpRequestに提供できます。
このクラスとそのサブクラスの個別のインスタンスは不変です。
- APIのノート:
- このバージョンでは、
HttpOptionインタフェースがシールされ、H3_DISCOVERYオプションのみが許可されます。 ただし、将来的には追加オプションをサポートするように拡張できます。H3_DISCOVERYオプションを使用すると、HttpClientがHTTP/3要求/応答交換を実行するHTTP/3接続を選択または確立する方法を決定しやすくなります。 - 導入されたバージョン:
- 26
-
ネストされたクラスのサマリー
ネストされたクラス修飾子と型インタフェース説明static enumこの列挙は、HttpClientがHTTP/3交換を確立する方法を決定するのに役立ち、Builder.setOptionのH3_DISCOVERYオプションの値として指定できます。 -
フィールドのサマリー
フィールド修飾子と型フィールド説明static final HttpOption<HttpOption.Http3DiscoveryMode> HttpClientがリクエストを実行するHTTP/3接続を選択または確立する方法を構成するために使用できるオプションです。 -
メソッドのサマリー
-
フィールド詳細
-
H3_DISCOVERY
static final HttpOption<HttpOption.Http3DiscoveryMode> H3_DISCOVERYHttpClientがリクエストを実行するHTTP/3接続を選択または確立する方法を構成するために使用できるオプションです。HttpClient.Version.HTTP_3がリクエスト優先バージョンまたはHttpClient優先バージョンのいずれかとして選択されていない場合、リクエストに対してこのオプションを設定しても効果はありません。このオプションの名前は
"H3_DISCOVERY"です。- 実装上のノート:
HttpClientのJDK組込み実装は、リクエスト・オプションのH3_DISCOVERYヒントを理解します。
H3_DISCOVERYヒントが指定されておらず、HTTP/3バージョンがリクエスト優先バージョンまたはクライアント優先バージョンとして選択されている場合、JDK組込み実装では、HttpOption.Http3DiscoveryMode.ANYに従って交換が確立されます。redirectの場合、
H3_DISCOVERYオプション(存在する場合)は常に新しい要求に転送されます。この実装では、プロキシを介したHTTP/3はサポートされていません。
HttpOption.Http3DiscoveryMode.HTTP_3_URI_ONLYが指定されていないかぎり、proxyが request URIに対して selectedである場合、プロトコルバージョンはHTTP/2またはHTTP/1.1にダウングレードされ、H3_DISCOVERYオプションは無視されます。 一方、HttpOption.Http3DiscoveryMode.HTTP_3_URI_ONLYが指定されている場合、リクエストは失敗します。- 関連項目:
-
-
メソッドの詳細
-
name
-
type
-