アプリケーション成果物が生成されたので、
次はこれらの成果物をアセンブルして、Web サービス・アプリケーションで使用する
エンタープライズ・アーカイブ (EAR) ファイルを作成する必要があります。
始める前に
WebSphere Application Server に添付されているアセンブリー・ツールを使用して、Java ベースの Web サービス・モジュールをアセンブルできます。
使用する前に、
アセンブリー・ツールを構成する必要があります。
この作業を完了するには、
WSDL2Java コマンド行ツールで生成した次の成果物が必要です。
- インプリメンテーション、WSDL2Java コマンド行ツールによって生成されたすべてのクラス、
および ejb-jar.xml デプロイメント記述子または application-client.xml デプロイメント記述子
を含むアセンブル済みクライアント・モジュール。このモジュールには、以下のいずれかが該当します。
- META-INF/application-client.xml ファイルを含むアプリケーション・クライアント・モジュール。
- META-INF/ejb-jar.xml ファイルを含む Enterprise JavaBeans (EJB) モジュール。
- クライアントの作成に使用した WSDL ファイル。
- ibm-webservicesclient-ext.xmi および ibm-webservicesclient-bnd.xmi デプロイメント記述子
のテンプレート (使用されている場合)。
- XML ベース・リモート・プロシージャー・コール (JAX-RPC) マッピング・デプロイメント記述子用に生成された Java API。
このタスクについて
WebSphere Application Server に組み込まれたアセンブリー・ツールを使用して、
Web サービス対応のクライアント・アプリケーションをアセンブルできます。
次の手順に従って、
アプリケーション・クライアントが Web サービスにアクセスできるようにするクライアント・コードと
成果物をアセンブルします。
プロシージャー
- アセンブリー・ツールを開始します。 Eclipse アセンブリー・ツール、Application Server Toolkit (AST)、および Rational Application Developer には、
コード成果物を作成し、それらのコード成果物を各種アーカイブまたはモジュールにアセンブルし、関連する J2EE バージョン 1.2、1.3、1.4 準拠の
デプロイメント記述子を構成するためのグラフィカル・インターフェースがあります。
- 「ファイル」>「インポート
」をクリックして、エンタープライズ Bean Java アーカイブ (JAR) ファイル、
アプリケーション・クライアント JAR ファイル、または Web アーカイブ (WAR) ファイルを
アセンブリー・ツールにインポートします。
- 「ウィンドウ」>「パースペクティブのオープン」>「その他」>「J2EE」とクリックして J2EE パースペクティブを開きます。
- 「Navigator」タブをクリックして、「Navigator」ペインに切り替えます。
- 「Navigator」ペインで、インポートしたばかりのファイルのプロジェクトを検索します。
- ejbModule (エンタープライズ Bean
JAR ファイルの場合) または appClientModule (アプリケーション・クライアント JAR ファイルの場合) 記入項目を展開し、META-INF ディレクトリーを表示します。META-INF ディレクトリーを展開します。
- META-INF ディレクトリーを右マウス・ボタン・クリックして、「新規」>「Folder」とクリックします。META-INF ディレクトリーに、
wsdl という名前のサブフォルダーを作成します。
- wsdl ディレクトリーを右マウス・ボタン・クリックして、「インポート」>「File system」をクリックし、WSDL ファイルを META-INF¥wsdl ディレクトリーにコピーします。
この Web サービスの WSDL ファイルを参照して、「終了」をクリックします。
- ejb-jar.xml デプロイメント記述子
または application-client.xml デプロイメント記述子をコピーします。 デプロイメント記述子ファイルが
すでに JAR ファイルに存在する場合は、既存の ejb-jar.xml ファイル
または application-client.xml ファイルの <service-ref> エレメントを、
元の ejb-jar.xml ファイルまたは WSDL2Java ツールによって生成
した application-client.xml ファイルに手動でマージします。
- (オプション) ibm-webservicesclient-ext.xmi ファイル
および ibm-webservicesclient-bnd.xmi ファイルを使用する場合は、
META-INF サブディレクトリーに配置します。
- クライアントがコンテナーで実行されている場合は、標準的なアセンブリー技法を
使用して JAR ファイルをエンタープライズ・アーカイブ (EAR) ファイルにアセンブルします。
- META-INF ディレクトリーを右マウス・ボタン・クリックして、「新規」>「Folder」とクリックします。META-INF ディレクトリーに、wsdl という名前のサブフォルダーを作成します。
- wsdl ディレクトリーを右マウス・ボタン・クリックして、WSDL ファイルを META-INF¥wsdl ディレクトリーにコピーし、「インポート」>「File system」をクリックします。
この Web サービスの WSDL ファイルを参照して、「終了」をクリックします。
- WSDL ファイルのコピーと同じ方法で、JAX-RPC マッピング・ファイル
を META-INF サブディレクトリーにコピーします。 JAX-RPC マッピング・ファイルは、
ejb-jar.xml ファイルまたは application-client.xml ファイルのエレメントで示されます。
- (オプション) ibm-webservicesclient-ext.xmi ファイル
および ibm-webservicesclient-bnd.xmi ファイルを使用する場合は、
META-INF サブディレクトリーに配置します。 これらのファイルがすでにモジュールに
存在する場合は、WSDL2Java ツールで生成したファイルの内容を既存ファイルに手動でマージします。
結果
Web サービス用のクライアント・アプリケーションを使用可能にするために必要な成果物が、
EAR ファイルにアセンブルされました。
例
アセンブリー・プロセスのこの例では、次のような、
AddressBookClient.jar JAR
ファイルおよび
AddressBookClient.ear EAR ファイルを使用します。
META-INF/MANIFEST.MF
META-INF/application-client.xml
META-INF/wsdl/AddressBook.wsdl
META-INF/AddressBook_mapping.xml
com/ibm/websphere/samples/webservices/addr/Address.class
com/ibm/websphere/samples/webservices/addr/AddressBook.class
com/ibm/websphere/samples/webservices/addr/AddressBookClient.class
com/ibm/websphere/samples/webservices/addr/AddressBookService.class
...other generated classes...
AddressBookClient.jar ファイルを
AddressBookClient.ear ファイル
にアセンブルすると、
AddressBookClient.ear ファイルには、次のファイルが含まれるようになります。
META-INF/MANIFEST.MF
AddressBookClient.jar
META-INF/application.xml
次の作業
クライアント・デプロイメント記述子を構成します
。これでクライアント・モジュールのアセンブルが終了したので、
クライアントが、サーバーにデプロイされた Web サービスと通信できるようにするために、
バインディングを構成する必要があります。