クラス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オブジェクトを設定します。

クラスで宣言されたメソッド HttpServer

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

修飾子と型	メソッド	説明
abstract void	bind(InetSocketAddress addr, int backlog)	現在バインドされていないHttpServerを指定されたアドレスとポート番号にバインドします。
abstract HttpContext	createContext(String path)	最初にハンドラを指定せずにHttpContextを作成します。
abstract HttpContext	createContext(String path, HttpHandler handler)	HttpContextを作成します。
abstract InetSocketAddress	getAddress()	このサーバーがリスニングしているアドレスを返します
abstract Executor	getExecutor()	このサーバーExecutorオブジェクトがHttpServer.setExecutor(Executor)で指定されている場合はそれを返し、何も指定されていない場合はnullを返します。
abstract void	removeContext(HttpContext context)	指定されたコンテキストをサーバーから削除します。
abstract void	removeContext(String path)	指定されたパスによって識別されるコンテキストをサーバーから削除します。
abstract void	setExecutor(Executor executor)	このサーバーExecutorオブジェクトを設定します。
abstract void	start()	新しいバックグラウンド・スレッドでこのサーバーを起動します。
abstract void	stop(int delay)	リスニング・ソケットを閉じ、新しい交換の処理を禁止することで、このサーバーを停止します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

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