モジュール jdk.httpserver

パッケージ com.sun.net.httpserver

クラスHttpContext

java.lang.Object

com.sun.net.httpserver.HttpContext

public abstract class HttpContext extends Object

HttpContextは、アプリケーションのルートURIパスと、関連付けられたHttpServerまたはHttpsServerでそのパス宛てのリクエストを処理するために起動されるHttpHandlerとの間のマッピングを表します。

HttpContextインスタンスは、HttpServerおよびHttpsServerのcreateメソッドによって作成されます。

FilterオブジェクトのチェーンをHttpContextに追加できます。 コンテキストで処理されるすべての交換は、チェーン内の各Filterで前処理および後処理できます。

導入されたバージョン:

1.6

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッド	説明
abstract Map<String,Object>	getAttributes()	可変Mapを返します。これは、構成およびその他のデータをFilterモジュールおよびコンテキスト交換ハンドラに渡すために使用できます。
abstract Authenticator	getAuthenticator()	このコンテキストに現在設定されているAuthenticatorを返します(存在する場合)。
abstract List<Filter>	getFilters()	「フィルタ」のこのコンテキストListを返します。
abstract HttpHandler	getHandler()	このコンテキストのハンドラを返します。
abstract String	getPath()	このコンテキストが作成されたパスを返します。
abstract HttpServer	getServer()	このコンテキストが作成されたサーバーを返します。
abstract Authenticator	setAuthenticator(Authenticator auth)	このHttpContextのAuthenticatorを設定します。
abstract void	setHandler(HttpHandler handler)	このコンテキストのハンドラがまだ設定されていない場合は設定します。

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

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

コンストラクタの詳細

HttpContext

protected HttpContext()

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

メソッドの詳細

getHandler

public abstract HttpHandler getHandler()

このコンテキストのハンドラを返します。

戻り値:

このコンテキストのHttpHandler

setHandler

public abstract void setHandler(HttpHandler handler)

このコンテキストのハンドラがまだ設定されていない場合は設定します。

パラメータ:

handler - このコンテキスト用に設定するハンドラ

例外:

IllegalArgumentException - このハンドラのコンテキストがすでに設定されている場合。

NullPointerException - ハンドラがnullの場合

getPath

public abstract String getPath()

このコンテキストが作成されたパスを返します。

戻り値:

このパスのコンテキスト

getServer

public abstract HttpServer getServer()

このコンテキストが作成されたサーバーを返します。

戻り値:

このサーバーのコンテキスト

getAttributes

public abstract Map<String,Object> getAttributes()

可変Mapを返します。これは、構成およびその他のデータをFilterモジュールおよびコンテキスト交換ハンドラに渡すために使用できます。

このMapに格納されているすべての属性は、このコンテキストによって処理されるすべてのHttpExchangeに表示されます。

戻り値:

このコンテキストの属性を含むMap

getFilters

public abstract List<Filter> getFilters()

「フィルタ」のこのコンテキストListを返します。 これは、リクエストをディスパッチするときにサーバーによって使用される実際のリストであるため、このリストへの変更はただちに交換の処理に影響します。

戻り値:

このコンテキストのフィルタを含むList

setAuthenticator

public abstract Authenticator setAuthenticator(Authenticator auth)

このHttpContextのAuthenticatorを設定します。 コンテキストでオーセンティケータが確立されると、すべてのクライアント・リクエストが認証され、指定されたオブジェクトが呼び出されて各リクエストが検証されます。 このメソッドの各呼出しは、以前に設定された値を置き換えます。

パラメータ:

auth - 設定するAuthenticator。 nullの場合、以前に設定したAuthenticatorは削除され、クライアント認証は不要になります。

戻り値:

設定されている場合は以前のAuthenticator、そうでない場合はnull。

getAuthenticator

public abstract Authenticator getAuthenticator()

このコンテキストに現在設定されているAuthenticatorを返します(存在する場合)。

戻り値:

このHttpContext Authenticator。何も設定されていない場合はnull