IBM SOAP ランタイム環境を使用した WSDL 文書からの Java クライアント・プロキシーおよびサンプル・アプリケーションの生成

「Web サービス・クライアント (Web Service Client)」ウィザードを使用すると、Java™ Bean プロキシーおよびサンプル・アプリケーションが簡単に生成できます。サンプル Web アプリケーションは、プロキシー・ファイルのコーディング方法を示します。

前提条件:
  1. WebSphere サーバーを使用している場合には、 WebSphere サーバーおよび Web プロジェクトの作成の記述に従って、 適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。
  2. WSDL 文書をディスカバーし、Web プロジェクトにインポートする。使用できる WSDL ファイルは、サービス・エレメントを含むもののみです。

ディスカバーした WSDL 文書から Java クライアント・プロキシーおよびサンプル・アプリケーションを生成するには、次の手順を実行します。

  1. J2EE パースペクティブに切り替える (「ウィンドウ」>「パースペクティブを開く」>「J2EE」)。
  2. 「プロジェクト・エクスプローラー」ビューで、サンプル・アプリケーションを生成する Web プロジェクトを選択する。
  3. 「ファイル」>「新規」>「その他」の順にクリックする。「Web サービス」を選択して、各種の Web サービス・ウィザードを表示する。 「Web サービス・クライアント (Web Service Client)」ウィザードを選択する。「次へ」をクリックする。
  4. 「Web Services (Web サービス)」パネル: 生成するプロキシーのタイプ、およびそのプロキシーをテストするかどうかを選択する。
  5. 「クライアント環境構成 (Client Environment Configuration)」ページ: ランタイム環境および Web サービス・クライアント用のサーバーを選択する。
    1. エクスプローラー・オプション」 をクリックし、IBM® SOAP ランタイム環境を選択し、Web サービス・クライアントを実行するサ ーバーを選択する。 Apache Axis 1.0 ランタイム環境または IBM WebSphere ランタイム環境を使用する場合は、該当するタスクを参照してください。
    2. Web サービス・クライアントを作成するプロジェクトのタ イプ および名前を選択する。
      • 既存のプロジェクトの名前を入力する場合、プロジェクト・タイプ・フィールドは、 その既存のプロジェクトのタイプ・フィールドと一致する必要があります。 クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、またはクライアントが生成した成果物によってサービスが上書きされるようになっていることを確認します。
      • まだ存在していないプロジェクトの名前を入力する場合は、 ウィザードでプロジェクトを作成できます。
      • Axis および SOAP ランタイム・クライアントでサポートされている プロジェクト・タイプは、Web プロジェクトのみである点に注意してください。 クライアントを Java、EJB、 またはアプリケーション・クライアント・プロジェクトに作成する場合、 使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
    3. 既存の EAR を選択するか、Web サービス・クライアント と、Web サービス EAR 以外の別の EAR とを関連付ける固有の名前を入力する。 注: Web サービスと Web サービス・クライアントについて異なる EAR を 選択すると、実行時エラーの発生頻度は減りますが、 より多くのシステム・リソースを使用します。
  6. 「Web サービス選択 (Web Service Selection)」パネル: Java Bean の生成に使用する WSDL、WSIL、または HTML ファイルに URI を入力する。オプションで、このファイルから WSIL ファイルを生成することもできます。
  7. 「Web サービス・バインディング・プロキシー生成 (Web Service Binding Proxy Generation)」パネル: バインディングとプロキシーのオプションを選択する。
  8. 「Web サービス・プロキシーのテスト (Web Service Proxy Test)」パネル: プロキシーのテストに使用するテスト機能と、プロキシーに組み込むメソッドを選択する。 Universal Test Client (UTC) は WebSphere サーバーにデプロイされている Web サービス・クライアントとしか互換性がないことに注意してください。 「完了」をクリックします。

®:

重要: 完全なエンドポイント情報を含むクライアント・プロキシーを生成するには、 WSDL バインディング文書ではなく、WSDL サービス文書を選択することをお勧めします。サービス・エレメントは、発行するビジネス・サービスの基盤となります。サービス・エレメントを含んでいない WSDL 文書を使用してビジネス・サービスを発行することはできません。WSDL バインディング文書からプロキシーを生成する場合は、そのプロキシー内で他のメソッドを呼び出す前に、setEndPoint() メソッドを呼び出してエンドポイント URL を設定しなければなりません。 エンドポイント URL は、WSDL バインディング文書から生成されるプロキシーに、自動的には付けられません。

生成した Java Bean プロキシーは、Web サービスへのリモート・プロシージャー・コール・インターフェースを提供します。 プロキシー・ファイルのコーディング方法を示すサンプル Web アプリケーションです。

Java クライアント・プロキシーを生成したら、Web サービスのサンプル JSP または Universal Test Client を使用して、そのプロキシーを利用して Web サービスの各種メソッドのテストができます。

Web プロジェクトの作成について詳しくは、Web アプリケーション開発の文書を参照してください。

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.