ユーザーがHTTPリクエストまたはHttpRequestインスタンスのユーザー・コードで設定できる、通常制限されたHTTPヘッダー名のカンマ区切りリストです。

デフォルトでは、リクエスト・ヘッダーconnection、content-length、expect、hostおよびupgradeはユーザー・コードで設定できません。この動作は、このプロパティを使用してオーバーライドできます。

名前の大文字と小文字は区別されず、空白は無視されます。このプロパティはテスト用であり、実際のデプロイメント用ではないことに注意してください。このプロパティを使用すると、プロトコル・エラーやその他の未定義の動作が発生する可能性があります。コンテキストによっては、他のヘッダーの設定が制限される場合があります。これには、関連するHttpClientにオーセンティケータ・セットがある場合、認可ヘッダーが含まれます。これらの制限は、このプロパティではオーバーライドできません。

16384 (16kB)

HTTP/2クライアント接続ウィンドウのサイズ(バイト単位)。

最大サイズは2^31-1です。この値をストリーム・ウィンドウ・サイズより小さくすることはできません。

16384 (16kB)

JavaロギングAPI (パッケージjava.util.loggingに含まれる)を介して、様々なイベントの高レベルのロギングを有効にします。

値には、次のいずれかの項目のカンマ区切りリストが含まれます:

• errors
• requests
• headers
• frames
• ssl
• trace
• channel

frames項目は、次のいずれかの項目のコロン区切りリストを使用して追加できます:

• control
• data
• window
• all

項目を指定すると、HTTPクライアントのログに追加されます。たとえば、次の値を指定すると、JavaロギングAPIによって、使用可能なすべてのHTTPクライアント・イベントが記録されます:

errors,requests,headers,frames:control:data:window,ssl,trace,channel

control:data:windowをallに置き換えることができます。

ロガーの名前はjdk.httpclient.HttpClientで、すべてのロギングはレベルINFOです。

16384 (16kB)

16777216 (16MB)

HTTP、java.net.HttpURLConnectionおよび新しいHTTPクライアントjava.net.http.HttpClientのレガシーURLプロトコル・ハンドラのJDK組込み実装がリモート・パーティから受け入れる最大レスポンス・ヘッダー・サイズ。この制限は、すべてのヘッダー名とヘッダー値の累積サイズに、ヘッダー名とヘッダー値のペアごとに32バイトのオーバーヘッドを加えたものとして計算されます。

この制限を超えると、リクエストはプロトコル例外で失敗します。

このプロパティにゼロまたは負の値がある場合、制限はありません。

IPv6を利用可能なオペレーティング・システムでは、ベースとなるネイティブ・ソケットは、デフォルトではIPv6ソケットです。これによりアプリケーションは、IPv4ホストとIPv6ホストの両方に接続したり、その両方のホストからの接続を受け入れたりできます。

アプリケーションでIPv4専用ソケットを使用する場合は、このプロパティをtrueに設定します。これは、アプリケーションがIPv6専用ホストと通信できないことを意味します。

IPv4アドレスとIPv6アドレスの両方を持つホストを扱う場合、IPv6を利用可能なオペレーティング・システムでは、IPv6アドレスよりもIPv4アドレスの使用を優先するのがデフォルトの動作です。これは、たとえば、IPv4アドレスの表現(192.168.1.1など)に依存するアプリケーションの下位互換性を確保するためです。

このプロパティをtrueに設定すると、このプリファレンスが変更され、可能な場合はIPv4アドレスよりIPv6アドレスが使用されます。

オペレーティング・システムによって返されるアドレスの順序を保持するには、このプロパティをsystemに設定します。

プロキシを介さずにアクセスするホストを示します。通常これは内部ホストを定義します。このプロパティの値は、|文字で区切られたホストのリストです。また、パターン一致にはアスタリスク(*)を使用できます。たとえば、次のように指定すると、プロキシ・サーバーが指定されている場合でも、exmaple.comドメインおよびlocalhost内のすべてのホストに直接アクセスする必要があります:

-Dhttp.nonProxyHosts="*.example.com|localhost"

デフォルト値には、ループバック・アドレスのあらゆる一般的なバリエーションが含まれません。

http.nonProxyHostsと同様に、このプロパティは、プロキシを介さずにアクセスするホストを示します。

デフォルト値には、ループバック・アドレスのあらゆる一般的なバリエーションが含まれません。

trueに設定すると、オペレーティング・システムのプロキシ設定が使用されます。

java.net.useSystemProxiesがtrueに設定されている場合でも、http.proxyHostなどのプロキシを明示的に設定したシステム・プロパティがシステム設定よりも優先されることに注意してください。

このプロパティは起動時に1回のみチェックされます。

HTTP CONNECTメソッドを使用してプロキシ経由でHTTPSをトンネリングするときに無効になる認証スキームをリストします。

このプロパティの値は、関連するRFCで定義されている、大/小文字を区別しない認証スキーム名のカンマ区切りリストです。スキームには、Basic、Digest、NTLM、KerberosおよびNegotiateが含まれます。不明またはサポートされていないスキームは無視されます。

HTTPのプロキシ時に無効になる認証スキームをリストします。

このプロパティの値は、関連するRFCで定義されている、大/小文字を区別しない認証スキーム名のカンマ区切りリストです。スキームには、Basic、Digest、NTLM、KerberosおよびNegotiateが含まれます。不明またはサポートされていないスキームは無視されます。

一部の環境では、HTTPまたはHTTPSのプロキシ時に特定の認証スキームが望ましくない場合があります。たとえば、Basicを使用すると、物理ネットワーク上でユーザーのパスワードが実際にクリアテキストで送信されます。

たとえば、-Dhttp.agent="foobar"が指定されている場合、JVMのバージョンが1.8.0であれば、User-Agentヘッダーにfoobar Java/1.8.0が含まれます。

他のHTTP認証スキームと同様に、New Technology LAN Manager (NTLM)は、必要に応じてjava.net.Authenticatorクラスを使用してユーザー名とパスワードを取得します。しかし、NTLMの場合はNTドメイン名も必要です。ドメインを指定するには、次の3つのオプションがあります。

1. ドメインを指定しない。環境によっては、実際にはドメインが必要とされないので、アプリケーションで指定する必要がありません。
2. ドメイン名は、ユーザー名の前にバックスラッシュ(\)を付けることで、ユーザー名内にエンコードできます。この方法では、ユーザーがこの表記方法を使用しなければならないということを意識すれば、Authenticatorクラスを使用する既存のアプリケーションを変更する必要がありません。
3. ドメイン名を2番目のオプションで指定せず、システム・プロパティhttp.auth.ntlm.domainが定義されている場合、このプロパティの値がドメイン名として使用されます。

永続(キープ・アライブ)接続をサポートするかどうかを示します。これを使用すると、複数のHTTP要求に対して再利用されるベースとなるソケット接続を許可することによって、パフォーマンスが改善されます。これがtrueに設定されている場合は、HTTP 1.1サーバーとの間で永続接続が要求されます。

永続接続の使用を無効にするには、このプロパティをfalseに設定します。

Windowsで透過的なNew Technology LAN Manager (NTLM) HTTP認証を有効にします。

NTLMスキームには透過的認証を使用できます。このスキームでは、現在ログインしているユーザーの名前とパスワードに基づくセキュリティ資格証明を、ユーザーにプロンプトを表示せずにオペレーティング・システムから直接取得できます。

この値が設定されていない場合、透過的認証は行われません。

このプロパティには、次の3つの値があります:

• disabled: 透過的認証は使用されません。
• allHosts: 透過的認証はすべてのホストに使用されます
• trustedHosts: 透過的認証は、Windowsインターネット設定で信頼されているホストに対して有効になります。

NTLMは厳密にセキュアな認証スキームではないため、有効にする前に注意してください。

$JAVA_HOME/conf/security/java.securityファイルで指定され、ネーム・サービスからの正常な名前検索のキャッシュ・ポリシーを示します。値は、成功した名前検索がキャッシュに保持される秒数に対応する整数です。

-1の値や、その他の負の値はすべて、「永久にキャッシュする」ことを意味します。0 (ゼロ)は、キャッシュを使用しないという意味です。

セキュリティ・マネージャがインストールされている場合のデフォルト値は-1 (永久)で、セキュリティ・マネージャがインストールされていない場合は実装固有となります。

値は、失敗した名前検索がキャッシュに保持される秒数に対応する整数です。-1の値や、その他の負の値はすべて、「永久にキャッシュする」ことを意味します。値0 (ゼロ)はキャッシュを使用しないという意味です。

値はキーワードのカンマ区切りリストで、メッセージが詳細情報で拡張される可能性がある例外タイプを参照します。

特に、値に文字列hostInfoが含まれている場合、ソケット・アドレスは例外メッセージ・テキスト(ホスト名やUNIXドメイン・ソケットのアドレス・パスなど)に含まれます。