パッケージ jakarta.xml.ws.spi.http

クラス HttpContext

  • public abstract class HttpContext
extends ObjectSE
    HttpContext は、Web サービスのルート URI パスから、関連付けられたコンテナー上のそのパス宛てのリクエストを処理するために呼び出される HttpHandler へのマッピングを表します。

    コンテナーはこのための実装を提供し、Web サービスリクエストを対応する HttpContext オブジェクトに照合します。

    導入:
    1.7、JAX-WS 2.2
    作成者:
    Jitendra Kotamraju

    • フィールドの詳細

      • handler

        protected HttpHandler handler
        このコンテキストに設定するハンドラー。

    • コンストラクターの詳細

      • HttpContext

        public HttpContext()

    • メソッドの詳細

      • setHandler

        public void setHandler​(HttpHandler handler)
        Jakarta XML Web Services ランタイムは、Endpoint.publish(HttpContext) 中にハンドラーを設定して、このコンテキストの HTTP リクエストを処理します。コンテナーまたはその拡張機能は、このハンドラーを使用してリクエストを処理します。
        パラメーター:
        handler - このコンテキストに設定するハンドラー

      • getPath

        public abstract StringSE getPath()
        このコンテキストのパスを返します。このパスは、アプリケーション内のエンドポイントを一意に識別し、パスはアプリケーションのコンテキストパスを基準にしています。コンテナーは、リクエスト URI をこの HttpContext オブジェクトに一致させる方法に基づいてこのパスを指定する必要があります。

        サーブレットコンテナーの場合、これは通常、エンドポイントの URL パターンです。

        このコンテキストのエンドポイントのアドレスは、次のように計算できます。

          HttpExchange exch = ...;
  String endpointAddress =
      exch.getScheme() + "://"
      + exch.getLocalAddress().getHostName()
      + ":" + exch.getLocalAddress().getPort()
      + exch.getContextPath() + getPath();
        戻り値:
        このコンテキストのパス

      • getAttribute

        public abstract ObjectSE getAttribute​(StringSE name)
        Jakarta XML Web Services ランタイムで使用できるコンテナーの構成およびその他のデータの属性値を返します。
        パラメーター:
        name - 属性名
        戻り値:
        属性値

      • getAttributeNames

        public abstract SetSE<StringSE> getAttributeNames()
        Jakarta XML Web Services ランタイムで使用できるコンテナーの構成およびその他のデータのすべての属性名を返します。
        戻り値:
        すべての属性名のセット