29.2. インジェクションによるプロキシーのインスタンス化

Apache CXF で Spring Framework を使用すると、JAX-WS API を使用してサービスプロキシーを作成する手間を省くことができます。これにより、設定ファイルでクライアントエンドポイントを定義してから、実装コードにプロキシーを直接挿入できます。ランタイムが実装オブジェクトをインスタンス化すると、設定に基づいて外部サービスのプロキシーもインスタンス化されます。実装は、インスタンス化されたプロキシーを参照して渡されます。

プロキシーは設定ファイルの情報を使用してインスタンス化されるため、WSDL の場所をハードコーディングする必要はありません。展開時に変更できます。ランタイムがアプリケーションのクラスパスで WSDL を検索するように指定することもできます。

外部サービスのプロキシーをサービスプロバイダーの実装に挿入するには、次の手順を実行します。

アプリケーションの設定ファイルで jaxws:client 要素を使用して JAX-WS クライアントエンドポイントを設定します。これにより、指定のプロパティーの org.apache.cxf.jaxws.JaxWsClientProxy オブジェクトをインスタンス化するようにランタイムに指示します。このオブジェクトは、サービスプロバイダーに注入されるプロキシーです。

少なくとも、次の属性の値を指定する必要があります。

例29.1「サービス実装に注入されるプロキシーの設定」 は、JAX-WS クライアントエンドポイントの設定を示しています。

<beans ...
  xmlns:jaxws="http://cxf.apache.org/jaxws"
  ...
  schemaLocation="...
    http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
    ...">
  <jaxws:client id="bookClient"
                serviceClass="org.apache.cxf.demo.BookService"
                wsdlLocation="classpath:books.wsdl"/>
  ...
</beans>

JAX-WS クライアントの設定の詳細については、「コンシューマーエンドポイントの設定」 を参照してください。

例29.2「サービス実装へのプロキシーの注入」 に示すように、@Resource を使用して、設定したプロキシーをリソースとしてサービス実装に注入します。

package demo.hw.server;

import org.apache.hello_world_soap_http.Greeter;

@javax.jws.WebService(portName = "SoapPort", serviceName = "SOAPService",
                      targetNamespace = "http://apache.org/hello_world_soap_http",
                      endpointInterface = "org.apache.hello_world_soap_http.Greeter")
public class StoreImpl implements Store {

@Resource(name="bookClient") private BookService proxy;

}

アノテーションの name プロパティーは JAX-WS クライアントの id 属性の値に対応します。設定されたプロキシーは、アノテーションの直後に宣言された BookService オブジェクトに注入されます。このオブジェクトを使用して、プロキシーの外部サービスを呼び出すことができます。