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ランタイムで使用できるコンテナの構成とその他のデータの属性名をすべて返します。

戻り値:

すべての属性名のセット