JAX-WS アプリケーションのための webservices.xml デプロイメント記述子の開発

デプロイメント記述子 は標準のテキスト・ファイルであり、XML を使用してフォーマットされており、Web サービス・アプリケーション内にパッケージ化されています。オプションで webservices.xml デプロイメント記述子を使用して、Java™ API for XML-Based Web Services (JAX-WS) Web サービス内のアノテーションに指定されているアプリケーションのメタデータを拡張またはオーバーライドできます。

このタスクについて

Java API for XML-based RPC (JAX-RPC) Web サービスと同様に、デプロイメント記述子を使用して JAX-WS Web サービスを記述できます。JAX-WS Web サービスの場合、webservices.xml デプロイメント記述子はオプションで使用できます。これは、アノテーションを使用して、デプロイメント記述子ファイル内に含まれるすべての情報を指定することができるためです。デプロイメント記述子ファイルを使用して、 既存の JAX-WS アノテーションの拡張またはオーバーライドを行うことができます。webservices.xml デプロイメント記述子で定義した すべての情報により、アノテーションによって指定された対応するすべての情報がオーバーライドされます。

JAX-WS Web サービスでは、javax.jws.WebService アノテーション、またはプロバイダー・エンドポイント用の javax.jws.WebServiceProvider アノテーションを使用して Java クラスにアノテーションを付ける必要があります。サーバー・サイドのデプロイメント記述子を使用して、アノテーションの該当する属性をオーバーライドするか、 またはアノテーションの情報を拡張できます。 デプロイメント記述子のエレメントと、@WebService や @WebServiceProvider のアノテーションとの間には、 定義された関係があります。デプロイメント記述子のエレメント、および @WebService や @WebServiceProvider のアノテーション属性へのマッピングについて詳しくは、 Web Services for Java Platform, Enterprise Edition (Java EE) 仕様、バージョン 1.2 の セクション 5.3 を参照してください。webservice.xml デプロイメント記述子には、 他のアノテーションにマップするエレメントもあります。例えば、デプロイメント記述子のエレメント <protocol-binding> は、@BindingType のアノテーションにマップし、デプロイメント記述子のエレメント <enable-mtom> は、@MTOM のアノテーションにマップします。 Web サービスのデプロイメント記述子のエレメントについて詳しくは、Web Services for Java Platform, Enterprise Edition (Java EE) 仕様のセクション 7.1 を参照してください。

手順

アセンブリー・ツールを使用して、webservice.xml デプロイメント記述子を生成します。

タスクの結果

JAX-WS のアノテーション属性のオーバーライド、 またはアノテーションによって定義されていない属性の指定に使用できる、デプロイメント記述子のテンプレートが作成されました。

以下の例では、JAX-WS Web サービスのサービス実装クラスに @WebService アノテーションが以下のように含まれます。
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
関連付けられた webservices.xml デプロイメント記述子では、 異なるファイル名を WSDL 文書に以下のように指定します。
<webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
	</webservice-description>
</webservices>
デプロイメント記述子で指定された値 META-INF/wsdl/ExampleService.wsdl が、 アノテーションの値をオーバーライドします。

次のタスク

webservice.xml デプロイメント記述子を構成します。デプロイメント記述子 の構成が終わったら、デプロイメント用の Web サービス・アプリケーションをアセンブルする必要があります。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxwsdeploydescriptor
ファイル名:twbs_jaxwsdeploydescriptor.html