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

アプリケーション成果物が生成されたので、次はこれらの成果物をアセンブルして、Web サービス・アプリケーションで使用するエンタープライズ・アーカイブ (EAR) ファイルを作成する必要があります。

始める前に

Java™ API for XML-Based Web Services (JAX-WS) の Web サービス・アプリケーションでは、このタスクを完了するために WSDL ファイルから始動したときに wsimport コマンド行ツールが生成する、移植可能な成果物が必要です。wsimport ツールは WSDL ファイルを入力データとして処理し、 以下の移植可能な成果物を生成します。
  • サービス・エンドポイント・インターフェース (SEI)
  • サービス・クラス
  • wsdl:fault クラスからマップされる 例外クラス (ある場合)
  • Java Architecture for XML Binding (JAXB) で生成されるタイプ値 (XML スキーマ・タイプからマップされる Java クラス)
  • 実装、wsimport コマンド行ツールによって生成されたすべてのクラス、 および ejb-jar.xml デプロイメント記述子または application-client.xml デプロイメント記述子 を含むアセンブル済みクライアント・モジュール。このモジュールには、以下のいずれかが該当します。
    • META-INF/application-client.xml ファイルを含むアプリケーション・クライアント・モジュール。
    • META-INF/ejb-jar.xml ファイルを含む Enterprise JavaBeans (EJB) モジュール。
Java API for XML-based RPC (JAX-RPC) の 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 デプロイメント記述子 のテンプレート (使用されている場合)。
  • 生成済み Java API for XML-based remote procedure call (JAX-RPC) マッピング・デプロイメント記述子。
制約事項: アプリケーション・アーカイブ内にパッケージされるファイルの名前には、ポンド記号 (#) を含めないでください。 内部処理の関係で、アプリケーション・アーカイブ内のファイル名にポンド記号が含まれている場合には、アプリケーション・サーバーはアプリケーションを正しくデプロイできません。 この障害が発生したときには、アプリケーションの処理中に例外が発生することがあります。 また、アプリケーションのデプロイ後にアプリケーションの一部が欠落する可能性があります。 この問題に対処するには、アプリケーション・アーカイブ内のファイル名を変更して、ポンド記号が含まれないようにしてください。

このタスクについて

WebSphere® Application Server に組み込まれたアセンブリー・ツールを使用して、Web サービス対応のクライアント・アプリケーションをアセンブルできます。

次の手順に従って、アプリケーション・クライアントが Web サービスにアクセスできるようにするクライアント・コードと成果物をアセンブルします。

手順

  1. アセンブリー・ツールを開始します。 Rational® Application Developer の文書にある、 アセンブリー・ツールの開始に関する情報を参照してください。
  2. Java EE モジュールで機能するようにアセンブリー・ツールをまだ構成していない場合は、 ここで構成します。Java EE および Web カテゴリーが 使用可能になっていることを確認する必要があります。 Rational Application Developer の文書にある、 アセンブリー・ツールの構成に関する情報を参照してください。
  3. コマンド行ツールで生成されたクライアント実装および成果物を、 アセンブリー・ツールにインポートします。
  4. Rational Application Developer アセンブリー・ツールで作成した JAR ファイルをマイグレーションします。 ファイルをマイグレーションするには、アセンブリー・ツールに JAR ファイルをインポートします。 Rational Application Developer の文書にある、 アセンブリー・ツールへのコード成果物のマイグレーションに関する情報を参照してください。
  5. クライアントがコンテナーで実行されている場合は、標準的なアセンブリー技法を 使用して JAR ファイルをエンタープライズ・アーカイブ (EAR) ファイルにアセンブルします。

タスクの結果

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

次のタスク

Java API for XML-Based Web Services (JAX-WS) アプリケーションでは、Web サービス・クライアント・アプリケーションをデプロイする準備ができています。

Java API for XML-based RPC (JAX-RPC) アプリケーションでは、サーバーにデプロイされる Web サービスと、クライアントが通信できるようにするために、クライアント・デプロイメント記述子バインディングをアセンブリー・ツールで構成する必要があります。


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



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