アセンブリー・ツールを使用して、JAX-RPC Web サービス・クライアント・デプロイメント記述子を
構成することができます。
このタスクについて
J2EE クライアント・コンテナーで実行される管理対象クライアントを開発している場合は、
この作業を実行します。この作業は、EJB または Web モジュールのアセンブル後に行います。
次の手順で、
アセンブリー・ツールを使用して、クライアント・デプロイメント記述子を構成します。
プロシージャー
- アセンブリー・ツールを開始します。
Eclipse アセンブリー・ツール、Application Server Toolkit (AST)、および
アセンブリー・ツールには、コード成果物を作成し、
そのコード成果物を各種アーカイブ (モジュール) にアセンブルして、関連する Java 2 Platform,
Enterprise Edition (J2EE) バージョン 1.2、1.3、または 1.4 準拠のデプロイメント記述子を構成するための、
グラフィカル・インターフェースがあります。
- 「ファイル」>「インポート」とクリックし、EJB JAR ファイル、
WAR ファイル、またはアプリケーション・クライアント・ファイルをアセンブリー・ツールにインポートします。
- 「ウィンドウ」>「Open Perspective」>「J2EE」とクリックして J2EE パースペクティブを開きます。
- 「Navigator」タブをクリックして、「Navigator」ペインに切り替えます。
- 「Navigator」ペインで、クライアント・ファイルが入ったプロジェクトを検索します。
- META-INF または WEB-INF ディレクトリー、およびその内容が表示されるまで、プロジェクトのディレクトリーを展開します。
- クライアント・デプロイメント記述子ファイルを右マウス・ボタン・クリックします。 クライアント・デプロイメント記述子情報は、
Web クライアントの場合は web.xml ファイル、EJB クライアントの場合は ejb-jar.xml ファイル、
アプリケーション・クライアントの場合は、application-client.xml ファイルにあります。
- 「オープン」を選択します。 デプロイメント記述子エディターが開きます。
Project Explorer を
使用してデプロイメント記述子エディターを開くこともできます。モジュールのデプロイメント記述子リスト項目
をダブルクリックし、デプロイメント記述子エディターを開く方法もあります。
- エディター・ウィンドウの下部にある「参照」タブをクリックします。
- 構成する service_reference を選択します。
- Java Naming Directory Interface (JNDI) がサービスを探すために使用する名前を
「名前」フィールドに入力します。
このサービスの JNDI ルックアップ・ストリングは、java:comp/env/service-ref-name です。
慣例により、サービス参照名は常に service/ で始まります。
- 「説明」フィールドに、クライアントがアクセスするサービス名を入力します。
- この Web サービスのサービス・インターフェースである Java インターフェース
のクラス名 (パッケージを含む) を「Service interface name」フィールドに入力します。
- 「WSDL ファイル」フィールドに、クライアントが使用する Web サービス記述言語 (WSDL) ファイル名
を、モジュールのルートを基準とする相対パスの形で入力します。
- 「JAX RPC mapping file」フィールドに、Java マッピング・
ファイルのファイル名を、モジュールのルートを基準とする相対パスの形で入力します。
- Ctrl-S をクリックして、変更を保管します。
結果
クライアント・デプロイメント記述子が構成されました。
次の作業
Web サービス・クライアントをテストします。この作業では、
管理対象外クライアント Java アーカイブ (JAR) ファイルおよび管理対象外クライアント・アプリケーション
をテストする方法について説明します。