javax.xml.ws.spi.http

クラス HttpContext

java.lang.Object

javax.xml.ws.spi.http.HttpContext

public abstract class HttpContext
extends Object

HttpContext は、Web サービスのルート URI パスから HttpHandler へのマッピングを表します。これは、関連付けられたコンテナ上のそのパスに送られる予定の要求を処理するために呼び出されます。

コンテナはこのための実装を提供し、Web サービス要求を対応する HttpContext オブジェクトに一致させます。

導入されたバージョン:

JAX-WS 2.2

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected HttpHandler	handler

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

コンストラクタ

コンストラクタと説明
HttpContext()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract Object	getAttribute(String name) JAX-WS ランタイムで使用可能な、コンテナの構成やその他のデータの属性値を返します。
abstract Set<String>	getAttributeNames() jax-ws ランタイムで使用できるコンテナの構成とその他のデータの属性名をすべて返します。
abstract String	getPath() このコンテキストのパスを返します。
void	setHandler(HttpHandler handler) JAX-WS ランタイムは Endpoint.publish(HttpContext) 時にそのハンドラを設定し、このコンテキストの HTTP 要求を処理します。

クラス java.lang.Object から継承されたメソッド

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

フィールドの詳細

handler

protected HttpHandler handler

コンストラクタの詳細

HttpContext

public HttpContext()

メソッドの詳細

setHandler

public void setHandler(HttpHandler handler)

JAX-WS ランタイムは Endpoint.publish(HttpContext) 時にそのハンドラを設定し、このコンテキストの HTTP 要求を処理します。コンテナまたはその拡張機能は、このハンドラを使用して要求を処理します。

パラメータ:

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

getPath

public abstract String getPath()

このコンテキストのパスを返します。このパスは、アプリケーション内にある端点を一意に識別します。パスは、アプリケーションのコンテキストパスに相対的なパスです。コンテナは、要求の URI とこの HttpContext オブジェクトをどのように一致させるかに基づき、このパスを示します。

サーブレットコンテナの場合は、通常、端点の url-pattern になります。

このコンテキストに対応する端点のアドレスは、次のように計算されます。

  HttpExchange exch = ...;
  String endpointAddress =
      exch.getScheme() + "://"
      + exch.getLocalAddress().getHostName()
      + ":" + exch.getLocalAddress().getPort()
      + exch.getContextPath() + getPath();
 

戻り値:

このコンテキストのパス

getAttribute

public abstract Object getAttribute(String name)

JAX-WS ランタイムで使用可能な、コンテナの構成やその他のデータの属性値を返します。

パラメータ:

name - 属性名

戻り値:

attribute value (属性値)

getAttributeNames

public abstract Set<String> getAttributeNames()

jax-ws ランタイムで使用できるコンテナの構成とその他のデータの属性名をすべて返します。

戻り値:

すべての属性名のセット