ハンドラー・クラスの webservices.xml デプロイメント記述子の構成
アセンブリー・ツールを使用して、 ユーザー提供のハンドラー・クラスの webservices.xml デプロイメント記述子を構成することができます。
始める前に
アプリケーション・サーバーで提供されるアセンブリー・ツールを使用して、 デプロイメント記述子を構成できます。
ハンドラー・クラスは、 リモート・プロシージャー・コール (RPC) の要求または応答を表す SOAP メッセージを変更 するために作成されるクラスです。ハンドラーは、Web サービスまたは Web サービス・クライアントに関連付けることができます。
Java™ API for XML-based RPC (JAX-RPC) Web サービスと同様に、デプロイメント記述子を使用して Java API for XML Web Services (JAX-WS) の Web サービスを記述することができます。JAX-WS Web サービスの場合、webservices.xml デプロイメント記述子はオプションで使用できます。これは、アノテーションを使用して、デプロイメント記述子ファイル内に含まれるすべての情報を指定することができるためです。デプロイメント記述子ファイルを使用して、 既存の JAX-WS アノテーションの拡張またはオーバーライドを行うことができます。webservices.xml デプロイメント記述子で定義した すべての情報により、アノテーションによって指定された対応するすべての情報がオーバーライドされます。
この作業を完了するには、 構成するアプリケーションのエンタープライズ・アーカイブ (EAR) ファイルが必要です。ロギングまたは トレースなどにハンドラーを使用する場合には、サーバー・アプリケーションまたは クライアント・アプリケーションのみ構成する必要があります。SOAP ヘッダーの情報の送信など、 その他のことにハンドラーを使用する場合には、クライアント・アプリケーションと サーバー・アプリケーションを、シンメトリック・ハンドラーと一緒に構成する必要があります。
このタスクについて
EAR ファイルのモジュールには、 構成するハンドラー・クラスが含まれます。これらのクラスには、 javax.xml.rpc.handler.Handler インターフェースが実装されています。ハンドラー・クラスの 作成について詳しくは、Web Services for Java EE 仕様の 第 6 章を参照してください。ご使用のプログラム・モデルのハンドラー・フレームワークについて詳しくは、JAX-WS 仕様の第 9 章、または JAX-RPC 仕様の第 12 章を参照してください。アプリケーション・モジュールは、webservices.xml デプロイメント記述子を含んでいる必要があります。Web サービス仕様および API 資料を参照して、サポートされる標準と仕様の完全なリストとともに JAX-RPC 仕様を検討してください。
手順
- アセンブリー・ツールを開始します。 Rational® Application Developer にある、 アセンブリー・ツールの開始に関する情報を参照してください。
- Java EE モジュールで機能するようにアセンブリー・ツールをまだ構成していない場合は、 ここで構成します。Java EE および Web カテゴリーが 使用可能になっていることを確認する必要があります。 Rational Application Developer にある、 アセンブリー・ツールの構成に関する情報を参照してください。
- Rational Application Developer アセンブリー・ツールに、アセンブリー・ツールキット、アプリケーション・アセンブリー・ツール (AAT)、またはその他のツールで作成した Web アプリケーション・アーカイブ (WAR) ファイルをマイグレーションします。 ファイルをマイグレーションするには、アセンブリー・ツールに WAR ファイルをインポートします。 Rational Application Developer にある、 アセンブリー・ツールへのコード成果物のマイグレーションに関する情報を参照してください。
- クライアント・デプロイメント記述子を構成します。 Rational Application Developer にある、 クライアント・デプロイメント記述子の構成に関する情報を参照してください。