モジュール jdk.httpserver
パッケージ com.sun.net.httpserver

クラスHttpsServer

java.lang.Object
com.sun.net.httpserver.HttpServer
com.sun.net.httpserver.HttpsServer
public abstract class HttpsServer extends HttpServer
このクラスは、HTTPSに対するサポートを提供するHttpServerの拡張です。

HttpsServerには、SSL接続のSSL構成を確立するために使用されるHttpsConfiguratorオブジェクトが関連付けられている必要があります。

他のすべての構成は、HttpServerの場合と同じです。

導入されたバージョン:
1.6

  • コンストラクタの詳細

    • HttpsServer

      protected HttpsServer()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • create

      public static HttpsServer create() throws IOException
      ローカル・アドレス/ポートに最初にバインドされていないHttpsServerインスタンスを作成します。 HttpsServerは、現在インストールされているHttpServerProviderから取得されます。 サーバーは、使用する前にHttpServer.bind(InetSocketAddress,int)を使用してバインドする必要があります。 サーバーには、setHttpsConfigurator(HttpsConfigurator)で確立されたHttpsConfiguratorも必要です。
      戻り値:
      HttpsServerのインスタンス
      例外:
      IOException - 入出力エラーが発生した場合

    • create

      public static HttpsServer create(InetSocketAddress addr, int backlog) throws IOException
      指定したInetSocketAddress (IPアドレスとポート番号)にバインドするHttpsServerインスタンスを作成します。 最大バックログも指定できます。 これは、待機中のソケットでキューに入れることができる着信接続の最大数です。 キューに入れられたTCP接続がこの上限を超える場合は、TCP実装で拒否されることがあります。 HttpsServerは、現在インストールされているHttpServerProviderから取得されます。 サーバーには、setHttpsConfigurator(HttpsConfigurator)で確立されたHttpsConfiguratorが必要です。
      パラメータ:
      addr - リスニングするアドレス。nullの場合は、HttpServer.bind(InetSocketAddress,int)を呼び出してアドレスを設定する必要があります
      backlog - ソケットのバックログ。 この値がゼロ以下の場合は、システム・デフォルト値が使用される。
      戻り値:
      HttpsServerのインスタンス
      例外:
      BindException - サーバーが要求されたアドレスをバインドできない場合、またはサーバーがすでにバインドされている場合
      IOException - 入出力エラーが発生した場合

    • create

      public static HttpsServer create(InetSocketAddress addr, int backlog, String path, HttpHandler handler, Filter... filters) throws IOException
      初期コンテキストでHttpsServerインスタンスを作成します。

      サーバーは、URI pathを交換handlerにマップする「初期コンテキスト」を使用して作成されます。 初期コンテキストは、createContext(path)の起動によって次のように作成されます。 filters(存在する場合)は、指定された順序で初期コンテキストに追加されます。 返されたサーバーは起動されていないため、必要に応じてさらに構成できます。

      サーバー・インスタンスは、指定されたInetSocketAddressにバインドされます。

      最大バックログも指定できます。 これは、待機中のソケットでキューに入れることができる着信接続の最大数です。 キューに入れられたTCP接続がこの上限を超える場合は、TCP実装で拒否されることがあります。 HttpsServerは、現在インストールされているHttpServerProviderから取得されます。

      サーバーには、setHttpsConfigurator(HttpsConfigurator)を使用してHttpsConfiguratorが確立されている必要があります。

      パラメータ:
      addr - リスニングするアドレス。nullの場合は、bindを呼び出してアドレスを設定する必要があります
      backlog - ソケットのバックログ。 この値がゼロ以下の場合は、システム・デフォルト値が使用される
      path - コンテキストのルートURIパスが絶対である必要があります
      handler - コンテキストのHttpHandler
      filters - コンテキストのフィルタ(オプション)
      戻り値:
      the HttpsServer
      例外:
      BindException - サーバーがアドレスにバインドできない場合
      IOException - 入出力エラーが発生した場合
      IllegalArgumentException - パスが無効な場合
      NullPointerException - 次のいずれかの場合: path, handler, filters、またはfiltersのすべての要素は、nullです
      導入されたバージョン:
      18

    • setHttpsConfigurator

      public abstract void setHttpsConfigurator(HttpsConfigurator config)
      このサーバーのHttpsConfiguratorオブジェクトを設定します。
      パラメータ:
      config - 設定するHttpsConfigurator
      例外:
      NullPointerException - configがnullの場合

    • getHttpsConfigurator

      public abstract HttpsConfigurator getHttpsConfigurator()
      このサーバーのHttpsConfiguratorオブジェクトが設定されている場合は、それを取得します。
      戻り値:
      このサーバーのHttpsConfigurator、設定されていない場合はnull