10.21.2　Webサービスコンテキストのインジェクション

(1)　javax.annotation.Resourceアノテーションの指定

Webサービスコンテキストのインジェクションでjavax.annotation.Resourceアノテーションを使用する場合，Webサービス実装クラスまたはプロバイダ実装クラス（実装クラスの親クラスを含む）の次に示すフィールドまたはメソッドにjavax.annotation.Resourceアノテーションを指定できます。このフィールドとメソッド以外に指定した場合の動作は保証されません。また，フィールドとフィールドに対応するsetterメソッドに，同時に指定することはできません。

• javax.xml.ws.WebServiceContext型のフィールド（staticおよびfinalのフィールドを除く）

• javax.xml.ws.WebServiceContext型を引数とする公開対象にならないsetterメソッド^※（staticおよびfinalのメソッドを除く）

  注※

  非publicのsetterメソッド，またはexclude要素がtrueのjavax.jws.WebMethodアノテーションが指定されているsetterメソッドです。

また，Webサービスコンテキストのインジェクションでjavax.annotation.Resourceアノテーションを使用する場合，javax.annotation.Resourceアノテーションで要素は指定できません。指定した場合の動作は保証されません。

javax.annotation.Resourceアノテーションの指定例を次に示します。

• フィールドへの指定例

  import javax.annotation.Resource;
  import javax.jws.WebService;
  import javax.servlet.ServletContext;
  import javax.xml.ws.handler.MessageContext;
  import javax.xml.ws.WebServiceContext;
   
  @WebService
  public class AddNumbersImpl {
      // wsContextフィールドに現在処理中のリクエスト関連情報をインジェクトする
      @Resource
      private WebServiceContext wsContext;
   
      public int add(int number1, int number2) throws AddNumbersFault {
          // メッセージコンテキストを取得する
          MessageContext mContext = wsContext.getMessageContext();
          // プロパティを取得する
          ServletContext sContext = (ServletContext)mContext.get(MessageContext.SERVLET_CONTEXT);
          ...
      }
      ...
  }

• setterメソッドへの指定例

  import javax.annotation.Resource;
  import javax.jws.WebService;
  import javax.xml.ws.handler.MessageContext;
  import javax.xml.ws.WebServiceContext;
   
  @WebService
  public class AddNumbersImpl {
      // setterメソッドに対応するwsContextフィールドに現在処理中のリクエスト関連情報をインジェクトする
      private WebServiceContext wsContext;
   
      @Resource
      private void setWebServiceContext(WebServiceContext wsContext) {
          this.wsContext = wsContext;
      }
      public int add(int number1, int number2) throws AddNumbersFault {
          // メッセージコンテキストを取得する
          MessageContext mContext = wsContext.getMessageContext();
          // プロパティを設定する
          mContext.put("userPropKey", "userPropValue");
          ...
      }
      ...
  }

ページの先頭へ

(2)　ユーザ定義メッセージコンテキストプロパティ追加時の注意事項

ユーザ定義メッセージコンテキストプロパティを追加するときの注意事項について説明します。

import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;
 
public class ServiceSOAPHandlerImpl implements SOAPHandler<SOAPMessageContext> {
 
    public boolean handleMessage(SOAPMessageContext smContext) {
        // メッセージ方向の取得
        boolean outbound = (boolean)smContext.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);
        if(outbound) {
           // アウトバウンド処理
           ...
        } else {
           // インバウンド処理
 
           // プロパティをkey値("userPropKey"), value値("userPropValue")で
           // 設定する
           smContext.put("userPropKey", "userPropValue");
           // プロパティのスコープをAPPLICATIONスコープで設定する
           smContext.setScope("userPropKey", MessageContext.Scope.APPLICATION);
           ...
        }
        ...
    }
    ...
}

ページの先頭へ