モジュールjdk.httpserver


モジュールjdk.httpserver
JDK固有のHTTPサーバーAPIを定義し、最小限のHTTPサーバーを実行するためのjwebserverツールを提供します。

com.sun.net.httpserverパッケージは、HTTPおよびHTTPSをサポートするサーバーを構築するための高レベルのAPIを定義します。 SimpleFileServerクラスは、テスト、開発およびデバッグを目的とした単純なHTTPのみのファイル・サーバーを実装します。 デフォルトの実装は、jwebserverツールおよびモジュールのメイン・エントリ・ポイントを介して提供され、java -m jdk.httpserverでも起動できます。

com.sun.net.httpserver.spiパッケージは、com.sun.net.httpserver APIに基づいてHTTPサーバー実装を検索するためのサービス・プロバイダ・インタフェース(SPI)を指定します。

HTTPサーバーAPIで使用されるシステム・プロパティ

次に、JDKのデフォルトのHTTPサーバー実装で使用されるJDK固有のシステム・プロパティのリストを示します。 数値を取る次のプロパティでは、数値として解析されない文字列が指定されている場合、デフォルト値が使用されます。

  • sun.net.httpserver.idleInterval (default: 30秒)
    アイドル接続を開いたままにする最大期間(秒)。
    このタイマーには実装固有の粒度があり、これはアイドル接続が指定された間隔より後にクローズされることを意味します。 ゼロ以下の値は、デフォルト設定にマップされます。

  • jdk.httpserver.maxConnections (デフォルト: -1)
    一度にオープンしている接続の最大数。
    これには、アクティブな接続とアイドル接続が含まれます。 ゼロまたは負の場合、制限は適用されません。

  • sun.net.httpserver.maxIdleConnections (default: 200)
    一度に最大アイドル接続数。
    ゼロまたは負の値に設定すると、接続は使用後にクローズされます。

  • sun.net.httpserver.drainAmount (default: 65536)
    HttpHandlerによって完全に消費されていないリクエスト本文から自動的に読取りおよび破棄される最大バイト数。
    残りの未読バイト数がこの制限より少ない場合、接続はアイドル接続キャッシュに配置されます。 そうでない場合、クローズされます。

  • sun.net.httpserver.maxReqHeaders (default: 200)
    リクエストで受け入れられるヘッダー・フィールドの最大数。
    ヘッダーの読取り中にこの制限を超えると、接続は終了し、リクエストは無視されます。 値がゼロ以下の場合は、デフォルト値が使用されます。

  • sun.net.httpserver.maxReqTime (デフォルト: -1)
    リクエスト・ヘッダーおよび本文を受信できる最大時間(ミリ秒)。
    実際、実際の時間は、リクエスト・サイズ、ネットワーク速度およびハンドラ処理の遅延の機能です。 ゼロ以下の値は、時間が制限されないことを意味します。 制限を超えると、接続は終了し、ハンドラはIOExceptionを受け取ります。 このタイマーには、指定した間隔より後にリクエストが中止される可能性がある実装固有の粒度があります。

  • sun.net.httpserver.maxRspTime (デフォルト: -1)
    レスポンス・ヘッダーおよび本文を受信できる最大時間(ミリ秒)。
    実際、実際の時間は、レスポンス・サイズ、ネットワーク速度およびハンドラ処理の遅延の機能です。 ゼロ以下の値は、時間が制限されないことを意味します。 制限を超えると、接続は終了し、ハンドラはIOExceptionを受け取ります。 このタイマーには、指定した間隔より後にレスポンスが中断される可能性がある実装固有の粒度があります。

  • sun.net.httpserver.nodelay (default: false)
    ブール値。trueの場合、すべての受信接続でTCP_NODELAYソケット・オプションを設定します。

モジュール・グラフ:
jdk.httpserverのモジュール・グラフjdk.httpserverのモジュール・グラフ
ツール・ガイド:
jwebserver
導入されたバージョン:
9
  • パッケージ

    エクスポート
    パッケージ
    説明
    組込みのHTTPサーバーの構築に使用できる、単純で高度なHTTPサーバーAPIを提供します。
    プラグイン可能なサービス・プロバイダ・インタフェースを提供します。これにより、HTTPサーバー実装をその他の実装と置き換えることができます。
  • サービス

    使用
    説明
    HttpServerのためのサービス・プロバイダ・クラス。