36.9.1　Webサービス側のハンドラチェインの設定

Webサービス側でハンドラチェインを設定する場合，javax.jws.HandlerChainアノテーションでSEI，Webサービス実装クラス，またはプロバイダ実装クラスをアノテートし，javax.jws.HandlerChainアノテーションのfile要素でハンドラチェイン設定ファイルを指定します。

javax.jws.HandlerChainアノテーションでWebサービス実装クラスをアノテートした例を示します。

package com.sample;
 
@javax.jws.WebService
@javax.jws.HandlerChain(file="handlers.xml")
public class AddNumbersImpl{
 
    public int add( int number1, int number2 ) throws AddNumbersFault{
      ...
    }
 
}

この例では，Webサービス実装クラスcom.sample.AddNumbersImplにハンドラチェイン設定ファイルhandlers.xmlで定義されたハンドラチェインを関連づけています。

ハンドラチェイン設定ファイルは，Webサービスごとに必要になります。複数のWebサービスで共有してもかまいませんが，その場合は，同じ設定が適用されます。

javax.jws.HandlerChainアノテーションについては，「16.2.3　javax.jws.HandlerChainアノテーション」を参照してください。

〈この項の構成〉

• (1)　ハンドラチェイン設定ファイル

• (2)　SOAPロールとアクタの設定

• (3)　soap:mustUnderstand属性の設定

<?xml version="1.0" encoding="UTF-8"?>
<handler-chains xmlns="http://java.sun.com/xml/ns/javaee">
  <handler-chain>
    <handler>
      <handler-class>org.test.handler.LoggingHandler</handler-class>
    </handler>
  </handler-chain>
</handler-chains>