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 サービスにアクセスできるようにするクライアント・コードと成果物をアセンブルします。
手順
- アセンブリー・ツールを開始します。 Rational® Application Developer の文書にある、 アセンブリー・ツールの開始に関する情報を参照してください。
- Java EE モジュールで機能するようにアセンブリー・ツールをまだ構成していない場合は、 ここで構成します。Java EE および Web カテゴリーが 使用可能になっていることを確認する必要があります。 Rational Application Developer の文書にある、 アセンブリー・ツールの構成に関する情報を参照してください。
- コマンド行ツールで生成されたクライアント実装および成果物を、 アセンブリー・ツールにインポートします。
- Rational Application Developer アセンブリー・ツールで作成した JAR ファイルをマイグレーションします。 ファイルをマイグレーションするには、アセンブリー・ツールに JAR ファイルをインポートします。 Rational Application Developer の文書にある、 アセンブリー・ツールへのコード成果物のマイグレーションに関する情報を参照してください。
- クライアントがコンテナーで実行されている場合は、標準的なアセンブリー技法を 使用して JAR ファイルをエンタープライズ・アーカイブ (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 サービスと、クライアントが通信できるようにするために、クライアント・デプロイメント記述子バインディングをアセンブリー・ツールで構成する必要があります。