モジュールjava.net.http
java.net.http APIで使用されるシステム・プロパティ
次に、JDKのjava.net.httpクライアント実装で使用されるシステム・ネットワーキング・プロパティのリストを示します。 数値を取る次のプロパティでは、数値として解析されない文字列が指定されている場合、デフォルト値が使用されます。 特に指定されていないかぎり、すべての値をconf/net.propertiesファイルに設定できます。 いずれの場合も、値をコマンド行でシステム・プロパティとして指定でき、その場合はconf/net.propertiesのすべての値がオーバーライドされます。 プロパティ値をSystem.setProperty()でプログラムで設定できるという保証はありません。 このAPIの他の実装では、これらのプロパティをサポートしないことを選択できます。
jdk.httpclient.allowRestrictedHeaders(default: 下記参照)
ユーザーがHTTPリクエストまたはHttpRequestインスタンスのユーザー・コードで設定できる、通常は制限されているHTTPヘッダー名のカンマ区切りリスト。 デフォルトでは、次のリクエスト・ヘッダーをユーザー・コードで設定することはできません: 接続、content-length、expect、hostおよびアップグレード。 この動作は、このプロパティを使用してオーバーライドできます。 名前の大文字と小文字は区別されず、空白は無視されます。 このプロパティはテスト用であり、実際のデプロイメント用ではないことに注意してください。 このプロパティを使用すると、プロトコル・エラーやその他の未定義の動作が発生する可能性があります。 コンテキストによっては、他のヘッダーの設定が制限される場合があります。 これには、関連するHttpClientにオーセンティケータ・セットがある場合、認可ヘッダーが含まれます。 これらの制限は、このプロパティではオーバーライドできません。jdk.httpclient.bufsize(default: 16384バイトまたは16 kB)
内部割当てバッファに使用するサイズ(バイト)。jdk.httpclient.connectionPoolSize(デフォルト: 0)
HTTP/1.1キープ・アライブ・キャッシュに保持する最大接続数。 0を指定すると、キャッシュの制限がなくなります。jdk.httpclient.connectionWindowSize(default: 2^26)
HTTP/2クライアント接続ウィンドウ・サイズ(バイト)。 最大サイズは2^31-1です。 この値は、jdk.httpclient.windowsizeシステム・プロパティを使用して構成できるストリーム・ウィンドウ・サイズより小さくすることはできません。jdk.httpclient.disableRetryConnect(default: false)
接続失敗の自動再試行が無効かどうか。 falseの場合、再試行が試みられます(再試行制限に従います)。jdk.httpclient.enableAllMethodRetry(default: false)
べき等ではないHTTPリクエストを自動的に再試行できるかどうか。jdk.httpclient.enablepush(デフォルト: 1)
HTTP/2プッシュ・プロミスが有効かどうか。 値1を指定するとプッシュ・プロミスが有効になります。値0を指定すると無効になります。jdk.httpclient.hpack.maxheadertablesize(default: 16384または16 kB)
HTTP/2クライアントの最大HPACKヘッダー表サイズ(バイト単位)。jdk.httpclient.HttpClient.log(default: none)
「プラットフォーム・ロギングAPI」を使用して、様々なイベントの大まかなロギングを有効にします。 値には、次のいずれかの項目のカンマ区切りリストが含まれます:- errors
- リクエスト
- headers
- content
- frames
- ssl
- trace
- channel
次のアイテムのいずれかをコロンで区切ったリストを使用して、フレーム・アイテムを追加できます:- コントロール
- data
- window
- all
項目を指定すると、HTTPクライアントのログに追加されます。 たとえば、次の値を指定すると、プラットフォーム・ロギングAPIは、使用可能なすべてのHTTPクライアント・イベントをログに記録します:
"errors,requests,headers,frames:control:data:window,ssl,trace,channel"
control:data:windowをallに置換できることに注意してください。 ロガーの名前は"jdk.httpclient.HttpClient"で、すべてのロギングはINFOレベルです。jdk.httpclient.keepalive.timeout(デフォルト: 30)
キープ・アライブ・キャッシュでアイドル状態のHTTP接続を維持する秒数。 このプロパティは、HTTP/1.1とHTTP/2の両方に適用されます。 HTTP/2の値は、jdk.httpclient.keepalive.timeout.h2 propertyでオーバーライドできます。jdk.httpclient.keepalive.timeout.h2(default: 下記参照)
アイドル状態のHTTP/2接続を維持する秒数。 設定されていない場合は、jdk.httpclient.keepalive.timeout設定が使用されます。jdk.httpclient.maxframesize(default: 16384または16kB)
HTTP/2クライアントの最大フレーム・サイズ(バイト単位)。 サーバーはこれより大きいフレームを送信できません。jdk.httpclient.maxstreams(1termktj: 100)
クライアントがサーバーを同時に開くことを許可するHTTP/2プッシュ・ストリームの最大数。jdk.httpclient.receiveBufferSize(default: オペレーティング・システムのデフォルト)
HTTPクライアント「ソケット受信サイズ」(バイト単位)。jdk.httpclient.redirects.retrylimit(デフォルト: 5)
リダイレクトまたはなんらかの理由で障害が発生した場合にHTTPリクエストを送信する最大試行回数。jdk.httpclient.websocket.writeBufferSize(default: 16384または16kB)
webソケット実装でソケット書込みに使用されるバッファ・サイズ。jdk.httpclient.windowsize(default: 16777216または16 MB)
HTTP/2クライアント・ストリームのウィンドウ・サイズ(バイト)。jdk.httpclient.auth.retrylimit(デフォルト: 3)
Basic認証フィルタが失敗した認証を再試行する試行回数。jdk.httpclient.sendBufferSize(default: オペレーティング・システムのデフォルト)
HTTPクライアント・ソケット「送信バッファ・サイズ」。 ゼロ以下の値は無視されます。jdk.internal.httpclient.disableHostnameVerification(default: false)
true (または空の文字列に設定)の場合、SSL証明書でのホスト名検証は無効になります。 これはシステム・プロパティのみで、conf/net.propertiesでは使用できません。 テスト目的でのみ提供されます。jdk.http.auth.proxying.disabledSchemes(default: conf/net.propertiesを参照してください)
HTTPプロキシ用のHTTPクライアント実装で使用できないHTTP認証スキーム名のカンマ区切りリスト。jdk.http.auth.tunneling.disabledSchemes(default: conf/net.propertiesを参照してください)
HTTP CONNECTトンネリングでHTTPクライアント実装で使用できないHTTP認証スキーム名のカンマ区切りリスト。
- モジュール・グラフ:
- 導入されたバージョン:
- 11
-
パッケージ
エクスポート