モジュール 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

コンストラクタのサマリー

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッド	説明
static HttpsServer	create()	ローカル・アドレス/ポートに最初にバインドされていないHttpsServerインスタンスを作成します。
static HttpsServer	create(InetSocketAddress addr, int backlog)	指定したInetSocketAddress (IPアドレスとポート番号)にバインドするHttpsServerインスタンスを作成します。
static HttpsServer	create(InetSocketAddress addr, int backlog, String path, HttpHandler handler, Filter... filters)	初期コンテキストでHttpsServerインスタンスを作成します。
abstract HttpsConfigurator	getHttpsConfigurator()	このサーバーのHttpsConfiguratorオブジェクトが設定されている場合は、それを取得します。
abstract void	setHttpsConfigurator(HttpsConfigurator config)	このサーバーのHttpsConfiguratorオブジェクトを設定します。

クラスcom.sun.net.httpserver.HttpServerで宣言されたメソッド

bind, createContext, createContext, getAddress, getExecutor, removeContext, removeContext, setExecutor, start, stop

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

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