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

• フィールドへの指定例
  

  ... import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.xml.ws.WebServiceRef; import com.sample.AddNumbersImpl; import com.sample.AddNumbersImplService; public class TestClient extends HttpServlet { // サービスクラスの例 // サービスクラス型のフィールドにサービスクラスのインスタンスをインジェクトする @WebServiceRef private AddNumbersImplService service; // ポートの例 // ポート型のフィールドにポートのインスタンスをインジェクトする @WebServiceRef(AddNumbersImplService.class) private AddNumbersImpl port; @Override public void init() { // Webサービスクライアントの実行前にアプリケーションサーバがサービスクラスと // ポートをインジェクトするので，以下の処理は行う必要がない //service = new AddNumbersImplService(); //port = service.getAddNumbersImplPort(); } @Override public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException { ...

• setterメソッドへの指定例
  

  ... import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.xml.ws.WebServiceRef; import com.sample.AddNumbersImpl; import com.sample.AddNumbersImplService; public class TestClient extends HttpServlet { private AddNumbersImplService service; private AddNumbersImpl port; @Override public void init() { // アプリケーション開始時にアプリケーションサーバがsetterメソッドを使用して // サービスクラスとポートをインジェクトするので，以下の処理は行う必要がない //service = new AddNumbersImplService(); //port = service.getAddNumbersImplPort(); } // サービスクラスの例 @WebServiceRef public void setAddNumbersImplService(AddNumbersImplService service) { // 引数serviceにサービスクラスのインスタンスをインジェクトする this.service = service; } // ポートの例 @WebServiceRef(AddNumbersImplService.class) public void setAddNumbersImpl(AddNumbersImpl port) { // 引数portにポートのインスタンスをインジェクトする this.port = port; } @Override public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException { ...

J2EEアプリケーションの開始時にWebサービスクライアントのインスタンスを生成するには，次のように設定します。

サーブレットの場合

Webサービスクライアントが含まれるWARファイルのweb.xmlにload-on-startup要素を指定します。なお，load-on-startup要素を指定しないときは，最初のWebアプリケーション実行時にインスタンスを生成します。詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」を参照してください。

EJBの場合

Stateless Session Beanでのプーリングを有効に設定します。J2EEアプリケーション開始時に，Stateless Session Beanでのプーリングの最小値分だけインスタンス生成を実行します。なお，Stateless Session Beanでのプーリングを使用しないときは，最初のJ2EEアプリケーション実行時にインスタンスを生成します。詳細については，「アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」を参照してください。

注意事項

Webサービスクライアントと接続先のWebサービスが，同じJ2EEサーバ上にデプロイされている環境では，J2EEサーバの起動時にインジェクションに失敗します（KDJW40043-E）。

インジェクションが失敗する場合の対策方法を次に示します。

• javax.xml.ws.WebServiceRefアノテーションのwsdlLocation要素に，相対パスまたは絶対パスでローカルに格納したWSDL文書を指定してください。
• J2EEサーバを停止する前に，Webサービスクライアントが含まれるJ2EEアプリケーションを停止してください。J2EEサーバを再起動したあとに，Webサービスクライアントを開始してください。
• WebサービスとWebサービスクライアントを別のJ2EEサーバにデプロイして，WebサービスをデプロイしたJ2EEサーバを起動したあとにWebサービスクライアントをデプロイしたJ2EEサーバを起動してください。
• カタログ機能を使用して，サービスクラスまたはポートのインジェクションでローカルに格納したWSDL文書を参照するように設定してください。

javax.xml.ws.WebServiceRefアノテーションを指定してインジェクトしたサービスクラスまたはポートでハンドラフレームワークを使用する場合，APIを使用してハンドラチェインを設定します。ハンドラチェインの設定については，「36.9.2　Web サービスクライアント側のハンドラチェインの設定」を参照してください。なお，ハンドラチェインの設定は，ポートに対して一度だけ実行すればいいので，Webサービスクライアントの初期化処理での実行をお勧めします。Webサービスを呼び出すごとに設定する必要はありません。初期化処理を実行するメソッドを次に示します。

Webサービスクライアントをサーブレットとして実装する場合

initメソッドまたはjavax.annotation.PostConstructアノテーションを指定したメソッド

EJBとして実装する場合

javax.annotation.PostConstructアノテーションを指定したメソッド

ポート型のフィールドや，フィールドに対応するsetterメソッドに，javax.xml.ws.WebServiceRefアノテーションとフィーチャに対応するアノテーションを同時に指定すると，インジェクションを行うポートのフィーチャを有効化できます。ただし，フィーチャに対応するアノテーションを指定したフィールドまたはフィールドに対応するsetterメソッドに，javax.xml.ws.WebServiceRefアノテーションを指定しない場合は，フィーチャは有効になりません。また，サービスクラス型のフィールドやフィールドに対応するsetterメソッドに対しては，フィーチャに対応するアノテーションを指定できません。

フィーチャを有効化するときに，ポートに指定できるアノテーションを次に示します。各アノテーションについては，「16.2　JavaからWSDLへのマッピングのカスタマイズ」を参照してください。

• javax.xml.ws.soap.Addressing
• javax.xml.ws.soap.MTOM
• com.sun.xml.ws.developer.StreamingAttachment

インジェクションを行うポートでMTOM/XOP仕様形式の添付ファイルを利用できるように，フィーチャを有効化する場合の指定例を次に示します。

• フィールドへの指定例
  

  ... import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.xml.ws.WebServiceRef; import com.sample.AddNumbersImpl; import com.sample.AddNumbersImplService; public class TestClient extends HttpServlet { // インジェクションを行うポートでMTOM/XOP仕様形式の添付ファイルを有効化 @MTOM @WebServiceRef(AddNumberImplService.class) private AddNumbersImpl port; @Override public void init() { ... } @Override public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException { ...

• setterメソッドへの指定例
  

  ... import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.xml.ws.WebServiceRef; import com.sample.AddNumbersImpl; import com.sample.AddNumbersImplService; public class TestClient extends HttpServlet { private AddNumbersImpl port; @Override public void init() { ... } // インジェクションを行うポートでMTOM/XOP仕様形式の添付ファイルを有効化 @MTOM @WebServiceRef(AddNumberImplService.class) public void setAddNumbersImpl(AddNumbersImpl port) { this.port = port; } @Override public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException { ...

インジェクションを行うポートの要求コンテキストのプロパティを変更する際は，Webサービスクライアントの初期化処理での実行をお勧めします。初期化処理を実行するメソッドを次に示します。

サーブレットとして実装する場合

initメソッドまたはjavax.annotation.PostConstructアノテーションを指定したメソッド

EJBとして実装する場合

javax.annotation.PostConstructアノテーションを指定したメソッド

注意事項

複数スレッドでポートを共有するWebサービスクライアントで，複数スレッドの動作中にポートの要求コンテキストのプロパティを変更すると，通信が失敗したり，不正なSOAPメッセージが送信されたりします。このため，複数スレッドで共有するポートの要求コンテキストのプロパティの変更は，複数スレッドが動作する前に実行する必要があります。

サーブレットとして実装したWebサービスクライアントの，ポートの要求コンテキストのプロパティを変更する例を次に示します。

...
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.WebServiceRef;
 
import com.sample.AddNumbersImpl;
import com.sample.AddNumbersImplService;
 
public class TestClient extends HttpServlet {
 
    @WebServiceRef(AddNumbersImplService.class)
    AddNumbersImpl port;
 
    @Override
    public void init() {
        // 初期化処理で，要求コンテキストを設定する
        Map<String, Object> context = ((BindingProvider)port).getRequestContext();
        context.put("com.cosminexus.jaxws.connect.timeout", 60000);
    }
    ...
}