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

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

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

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

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

®:

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

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

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

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

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