16.6.2. JAX-WS Common API Reference

メッセージハンドラーの種類

論理ハンドラー

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

プロトコルハンドラー

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

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

サービスエンドポイントでは、ハンドラーは@HandlerChain注釈。ハンドラーチェーンファイルの場所は、絶対的なものにすることができますjava.net.URLのexternalFormまたは、ソースファイルまたはクラスファイルからの相対パス。

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

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

Copy to Clipboard Toggle word wrap

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

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

例16.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);

Copy to Clipboard Toggle word wrap

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

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

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

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

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