WebSphere Application Server - Express, Version 6.0.x   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows

             目次と検索結果のパーソナライズ化

Web サービス対応クライアント JAR ファイルの EAR ファイルへのアセンブル

アプリケーション成果物が生成されたので、 次はこれらの成果物をアセンブルして、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 サービスにアクセスできるようにするクライアント・コードと 成果物をアセンブルします。

プロシージャー

  1. アセンブリー・ツールを開始します Eclipse アセンブリー・ツール、Application Server Toolkit (AST)、および Rational Application Developer には、 コード成果物を作成し、それらのコード成果物を各種アーカイブまたはモジュールにアセンブルし、関連する J2EE バージョン 1.2、1.3、1.4 準拠の デプロイメント記述子を構成するためのグラフィカル・インターフェースがあります。
  2. ファイル」>「インポート 」をクリックして、エンタープライズ Bean Java アーカイブ (JAR) ファイル、 アプリケーション・クライアント JAR ファイル、または Web アーカイブ (WAR) ファイルを アセンブリー・ツールにインポートします。
  3. ウィンドウ」>「パースペクティブのオープン」>「その他」>「J2EE」とクリックして J2EE パースペクティブを開きます。
  4. Navigator」タブをクリックして、「Navigator」ペインに切り替えます。
  5. Navigator」ペインで、インポートしたばかりのファイルのプロジェクトを検索します。
  6. ejbModule (エンタープライズ Bean JAR ファイルの場合) または appClientModule (アプリケーション・クライアント JAR ファイルの場合) 記入項目を展開し、META-INF ディレクトリーを表示します。META-INF ディレクトリーを展開します。
  7. META-INF ディレクトリーを右マウス・ボタン・クリックして、「新規」>「Folder」とクリックします。META-INF ディレクトリーに、 wsdl という名前のサブフォルダーを作成します。
    1. wsdl ディレクトリーを右マウス・ボタン・クリックして、「インポート」>「File system」をクリックし、WSDL ファイルを META-INF¥wsdl ディレクトリーにコピーします。 この Web サービスの WSDL ファイルを参照して、「終了」をクリックします。
    2. ejb-jar.xml デプロイメント記述子 または application-client.xml デプロイメント記述子をコピーします。 デプロイメント記述子ファイルが すでに JAR ファイルに存在する場合は、既存の ejb-jar.xml ファイル または application-client.xml ファイルの <service-ref> エレメントを、 元の ejb-jar.xml ファイルまたは WSDL2Java ツールによって生成 した application-client.xml ファイルに手動でマージします。
    3. (オプション) ibm-webservicesclient-ext.xmi ファイル および ibm-webservicesclient-bnd.xmi ファイルを使用する場合は、 META-INF サブディレクトリーに配置します。
  8. クライアントがコンテナーで実行されている場合は、標準的なアセンブリー技法を 使用して JAR ファイルをエンタープライズ・アーカイブ (EAR) ファイルにアセンブルします。
  9. META-INF ディレクトリーを右マウス・ボタン・クリックして、「新規」>「Folder」とクリックします。META-INF ディレクトリーに、wsdl という名前のサブフォルダーを作成します。
    1. wsdl ディレクトリーを右マウス・ボタン・クリックして、WSDL ファイルを META-INF¥wsdl ディレクトリーにコピーし、「インポート」>「File system」をクリックします。 この Web サービスの WSDL ファイルを参照して、「終了」をクリックします。
    2. WSDL ファイルのコピーと同じ方法で、JAX-RPC マッピング・ファイル を META-INF サブディレクトリーにコピーします。 JAX-RPC マッピング・ファイルは、 ejb-jar.xml ファイルまたは application-client.xml ファイルのエレメントで示されます。
    3. (オプション) 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 サービスと通信できるようにするために、 バインディングを構成する必要があります。




関連概念
Web サービス
関連タスク
Web サービス対応クライアントのテスト
タスクの概説: Web サービス・アプリケーションのインプリメント
Web サービス・クライアントの開発とデプロイ
Web サービス・クライアント・アプリケーションのデプロイ
アセンブリー・ツールを使用した JAX-RPC Web サービス・クライアント・デプロイメント 記述子の構成
関連資料
Web サービスの開発に使用する成果物
タスク・トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 11:31:28 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/twbs_assembclient.html