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

前提条件:

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

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

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

生成した 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