13.5.2. JAX-WS 共通 API の参考資料

メッセージハンドラーのタイプ

論理ハンドラー

論理ハンドラーはメッセージコンテキストプロパティーおよびメッセージペイロードでのみ動作します。論理ハンドラーはプロトコルに依存しないため、メッセージのプロトコル固有の部分は影響を受けません。論理ハンドラーはインターフェース javax.xml.ws.handler.LogicalHandler を実装します。

プロトコルハンドラー

プロトコルハンドラーはメッセージコンテキストおよびプロトコル固有のメッセージでのみ動作します。プロトコルハンドラーは特定のプロトコルに固有で、プロトコル固有のメッセージアスペクトにアクセスし、変更することが可能です。 プロトコルハンドラーは javax.xml.ws.handler.Handler except javax.xml.ws.handler.LogicalHandler から派生する任意のインターフェースを実装します。

サービスエンドポイントハンドラー

サービスエンドポイントでは、ハンドラーは @HandlerChain アノテーションを使用して定義されます。ハンドラーチェーンファイルの場所は、externalForm 内の絶対 java.net.URL、あるいはソースファイルまたはクラスファイルからの相対パスで指定できます。

例13.30 サービスエンドポイントハンドラーの例

@WebService
@HandlerChain(file = "jaxws-server-source-handlers.xml")
public class SOAPEndpointSourceImpl
{
   ...
}

サービスクライアントハンドラー

JAX-WS クライアントでは、ハンドラーは サービスエンドポイント同様に @HandlerChain アノテーションを使用するか、動的に JAX-WS API を使用して定義します。

例13.31 API を使用したサービスクライアントハンドラーの定義

Service service = Service.create(wsdlURL, serviceName);
Endpoint port = (Endpoint)service.getPort(Endpoint.class);
     
BindingProvider bindingProvider = (BindingProvider)port;
List<Handler> handlerChain = new ArrayList<Handler>();
handlerChain.add(new LogHandler());
handlerChain.add(new AuthorizationHandler());
handlerChain.add(new RoutingHandler());
bindingProvider.getBinding().setHandlerChain(handlerChain);

setHandlerChain メソッドへの呼び出しが必要です。

論理メッセージコンテキスト

論理ハンドラーが呼び出されると、タイプ LogicalMessageContext のメッセージコンテキストを受信します。LogicalMessageContext は、メッセージペイロードを取得および変更するメソッドを使用して MessageContext を拡張します。これは、メッセージのプロトコル固有の部分へのアクセスは提供しません。プロトコルバインディングは、論理メッセージコンテキストを介して使用可能なメッセージコンポーネントを定義します。SOAP バインディングにデプロイされている論理ハンドラーは、SOAP ボディーのコンテンツにアクセス可能ですが、SOAP ヘッダーにはアクセスできません。一方、XML/HTTP バインディングは論理ハンドラーがメッセージの XML ペイロード全体にアクセスできることを定義します。

SOAP メッセージコンテキスト

SOAP ハンドラーが呼び出されると、SOAPMessageContext を受信します。 SOAPMessageContext は SOAP メッセージペイロードを取得および変更するメソッドを使用して MessageContext を拡張します。