43.10. ハンドラーを使用するためのエンドポイントの設定

ハンドラーチェーンをコンシューマーに追加するには、ハンドラーのチェーンを明示的に構築する必要があります。その後、サービスプロキシーの Binding オブジェクトにハンドラーチェーンを直接設定します。

ハンドラーチェーンをコンシューマーに追加するには、次のようにします。

例43.14「コンシューマーへのハンドラーチェーンの追加」 は、ハンドラーチェーンをコンシューマーに追加するためのコードを示しています。

import javax.xml.ws.BindingProvider;
import javax.xml.ws.handler.Handler;
import java.util.ArrayList;
import java.util.List;

import org.apache.cxf.jaxws.binding.DefaultBindingImpl;
...
SmallNumberHandler sh = new SmallNumberHandler();
List<Handler> handlerChain = new ArrayList<Handler>();
handlerChain.add(sh);

DefaultBindingImpl binding = ((BindingProvider)proxy).getBinding();
binding.getBinding().setHandlerChain(handlerChain);

例43.14「コンシューマーへのハンドラーチェーンの追加」 のコードは、以下を行います。

ハンドラーをインスタンス化します。

チェーンを保持する List オブジェクトを作成する。

ハンドラーをチェーンに追加します。

Binding オブジェクトを DefaultBindingImpl オブジェクトとしてプロキシーから取得する。

ハンドラーチェーンをプロキシーのバインディングに割り当てます。

SEI または実装クラスのいずれかに @HandlerChain アノテーションを付けて、ハンドラーチェーンをサービスプロバイダーに追加します。アノテーションは、サービスプロバイダーが使用するハンドラーチェーンを定義するメタデータファイルを指します。

ハンドラーチェーンをサービスプロバイダーに追加するには、次のようにします。

javax.jws.HandlerChain アノテーションは、サービスプロバイダーの実装クラスに付けられます。アノテーションは、その file プロパティーで指定されたハンドラーチェーンの設定ファイルを読み込むようにランタイムに指示します。

アノテーションの file プロパティーは、読み込むハンドラーの設定ファイルを識別する 2 つの方法をサポートします。

例43.15「ハンドラーチェーンをロードするサービスの実装」に、handlers.xml と呼ばれるファイルに定義されたハンドラーチェーンを使用するサービスプロバイダーの実装を示します。handlers.xml は、サービスプロバイダーが実行されるディレクトリーに存在する必要があります。

import javax.jws.HandlerChain;
import javax.jws.WebService;
...

@WebService(name = "AddNumbers",
            targetNamespace = "http://apache.org/handlers",
            portName = "AddNumbersPort",
            endpointInterface = "org.apache.handlers.AddNumbers",
            serviceName = "AddNumbersService")
@HandlerChain(file = "handlers.xml")
public class AddNumbersImpl implements AddNumbers
{
...
}

ハンドラー設定ファイルは、JSR 109 (Web Services for Java EE、バージョン 1.2) に付属する XML 文法を使用してハンドラーチェーンを定義します。この文法は http://java.sun.com/xml/ns/javaee で定義されます。

ハンドラー設定ファイルのルート要素は、handler-chains 要素です。handler-chains 要素には、1 つまたは複数の handler-chain 要素があります。

handler-chain 要素は、ハンドラーチェーンを定義します。表43.1「サーバーサイドハンドラーチェーンの定義に使用される要素」で、handler-chain 要素の子を説明します。

handler-chain 要素に必要なのは、子要素としての handler 1 つだけです。ただし、完全なハンドラーチェーンを定義するのに、handler 要素を必要な数だけサポートします。チェーン内のハンドラーは、ハンドラーチェーン定義で指定された順序で実行されます。

protocol-binding などの他の子は、定義されたハンドラーチェーンのスコープを制限するために使用されます。たとえば、service-name-pattern 要素を使用する場合、ハンドラーチェーンは WSDL port 要素が指定の WSDL service 要素の子であるサービスプロバイダーにのみ割り当てられます。handler 要素では、これらの制限用の子の 1 つしか使用できません。

handler 要素は、ハンドラーチェーンの個々のハンドラーを定義します。handler-class 子要素は、ハンドラーを実装するクラスの完全修飾名を指定します。handler 要素は、ハンドラーに一意の名前を指定するオプションの handler-name 要素を持つこともできます。

例43.16「ハンドラー設定ファイル」 は、単一のハンドラーチェーンを定義するハンドラー設定ファイルを示しています。チェーンは 2 つのハンドラーで構成されています。

<handler-chains xmlns="http://java.sun.com/xml/ns/javaee"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="http://java.sun.com/xml/ns/javaee">
  <handler-chain>
    <handler>
      <handler-name>LoggingHandler</handler-name>
      <handler-class>demo.handlers.common.LoggingHandler</handler-class>
    </handler>
    <handler>
      <handler-name>AddHeaderHandler</handler-name>
      <handler-class>demo.handlers.common.AddHeaderHandler</handler-class>
    </handler>
  </handler-chain>
</handler-chains>