13.4.2. JAX-WS クライアントアプリケーションの開発

サービス

概要

Service は WSDL サービスを表す抽象化です。WSDL サービスは関連ポートの集合で、それぞれには特定のプロトコルおよび特定のエンドポイントアドレスにバインドされたポート型が含まれます。

通常、サービスは既存の WSDL コントラクトから残りのコンポーネントスタブが生成されるときに生成されます。WSDL コントラクトはデプロイされたエンドポイントの WSDL URL を介して利用できます。もしくは EAP_HOME/bin/ ディレクトリーで wsprovide.sh コマンドを使用してエンドポイントソースから作成することもできます。

このようなタイプの使用法は静的ユースケースと呼ばれます。この場合、コンポーネントスタブの 1 つとして作成された Service クラスのインスタンスを作成します。

Service.create メソッドを使用して、手動でサービスを作成することも可能です。このような使用法は 動的ユースケースと呼ばれます。

使用法

静的ユースケース

JAX-WS クライアントの静的ユースケースは WSDL コントラクトがすでに存在することを前提としています。WDSL コントラクトは、外部ツールで生成するか、AX-WS エンドポイントの作成時に正しい JAX-WS アノテーションを使用して生成します。

コンポーネントスタブを生成するには、EAP_HOME/bin/ に格納された wsconsume.sh または wsconsume.bat のスクリプトを使用します。スクリプトは、WSDL URL またはファイルをパラメーターとして取り、ディレクトリーツリー構造の複数のファイルを生成します。 Service を表すソースおよびクラスのファイルはそれぞれ CLASSNAME_Service.java と CLASSNAME_Service.class と名付けられます。

生成された実装クラスには、引数のないパブリックコンストラクターと 2 つの引数を持つパブリックコンストラクターの 2 つがあります。2 つの引数は WSDL の場所 (java.net.URL) とサービス名 (javax.xml.namespace.QName) を表します。

引数のないコンストラクターは最も頻繁に使用されます。この場合、WSDL の場所とサービス名は WSDL に記述された設定となります。これらは、生成されたクラスをデコレートする @WebServiceClient アノテーションから暗黙的に設定されます。

例13.19 生成されたサービスクラスの例

@WebServiceClient(name="StockQuoteService", targetNamespace="http://example.com/stocks", wsdlLocation="http://example.com/stocks.wsdl")
public class StockQuoteService extends javax.xml.ws.Service
{
   public StockQuoteService()
   {
      super(new URL("http://example.com/stocks.wsdl"), new QName("http://example.com/stocks", "StockQuoteService"));
   }

   public StockQuoteService(String wsdlLocation, QName serviceName)
   {
      super(wsdlLocation, serviceName);
   }

   ...
}

動的ユースケース

動的なケースでは、スタブは自動的には生成されず、代わりに Web サービスクライアントが Service.create メソッドを使用して Service インスタンスを作成します。以下のコードフラグメントは、このプロセスの例を示しています。

例13.20 手動によるサービスの作成

URL wsdlLocation = new URL("http://example.org/my.wsdl");
QName serviceName = new QName("http://example.org/sample", "MyService");
Service service = Service.create(wsdlLocation, serviceName);

ハンドラーリゾルバー

JAX-WS は、ハンドラー として知られるメッセージ処理モジュール向けの柔軟性の高いプラグインフレームワークを提供します。このようなハンドラーにより、JAX-WS ランタイムシステムの機能が拡張されます。Service インスタンスは、サービス、ポート、またはプロトコルバインディングごとにハンドラーのセットを設定できる getHandlerResolver メソッドと setHandlerResolver メソッドのペアを介して HandlerResolver へのアクセスを提供します。

Service インスタンスがプロキシまたは Dispatch インスタンスを作成する際には、現在サービスに登録されているハンドラーリゾルバーによって必要なハンドラーチェーンが作成されます。Service インスタンス用に設定されたハンドラーリゾルバーがそれ以降に変更されても、以前に作成されたプロキシや Dispatch インスタンスには影響を及ぼしません。

エグゼキューター

Service インスタンスは java.util.concurrent.Executor を使用して設定できます。Executor はアプリケーションが要求する任意の非同期コールバックを呼び出します。Service の setExecutor メソッドと getExecutor のメソッドはサービス用に設定された Executor を変更および取得できます。