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

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

始める前に

前提条件:

このタスクについて

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

手順

  1. Java EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」>「Java EE」)。
  2. 「エンタープライズ・エクスプローラー」ビューで、サンプル・アプリケーションを生成する Web プロジェクトを選択します。
  3. ファイル」>「新規」>「その他」の順にクリックします。「Web サービス」を選択して、各種の Web サービス・ウィザードを表示します。「Web サービス・クライアント」ウィザードを選択します。「次へ」をクリックします。
  4. 「Web サービス」ページ: クライアントを生成するために使用する WSDL ファイルを選択します。 次の操作を実行するオプションもあります。
    1. スライダーを使用して完了させたい Web サービス・クライアント開発のステージを選択します。これにより、残りのウィザードのパネルでいくつかのデフォルト値が設定されます。
      • 開発: Web サービスの WSDL 定義および実装を開発します。 これには、生成されたコード、WSDL ファイル、デプロイメント記述子、および Java ファイル (該当する場合) が入るモジュールの作成などのタスクが含まれます。
      • アセンブル: これにより、Web サービス・クライアントをホストするプロジェクトが、ターゲット・アプリケーション・サーバーによって要求されたときに EAR に関連付けられるようになります。
      • デプロイ: これにより、クライアントのデプロイメント・コードが作成されます。
      • インストール: これにより、Web モジュールと EAR がターゲット・サーバーにインストールされ、構成されます。 WSDL ファイルのエンドポイントに対する変更が必要な場合、このステージで変更が行われます。
      • 始動: これにより、クライアントがサーバーにインストールされると、サーバーが始動するようになります。
      • テスト: これにより、Web サービス・エクスプローラーまたはサンプル JSP の使用などの、サービスをテストするためのさまざまなオプションが提供されます。
    2. サーバーの選択: デフォルト・サーバーが表示されます。 サービスを別のサーバーにデプロイしたい場合には、リンクをクリックして別のサーバーを指定してください。
    3. ランタイムの選択: デフォルトのランタイムが表示されます。 サービスを別のランタイムにデプロイしたい場合には、リンクをクリックして別のランタイムを指定してください。
    4. サービス・プロジェクトの選択: ワークスペースで選択されたプロジェクトを含むプロジェクトが表示されます。 別のプロジェクトと EAR を選択するためには、プロジェクト・リンクをクリックしてください。 クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、またはクライアントが生成した成果物によってサービスが上書きされるようになっていることを確認します。
    5. Web サービスのモニター: TCP/IP モニターを介して Web サービス・トラフィックを送信します。これにより、Web サービスによって生成される SOAP トラフィックを監視し、このトラフィックが WS-I に準拠しているかどうかをテストできます。 あるいは、TCP/IP モニターを使用した Web サービスのテストで説明するとおり、TCP/IP モニターを手動でセットアップすることもできます。 TCP/IP モニターを介して Web サービス・トラフィックを経路指定する場合は、Universal Test Client を使用して Web サービスをテストできないことに注意してください。
  5. 「Web サービス・プロキシー」ページ: このページには、プロキシーのオプションが表示されます。 ここにはプロキシーが生成されるフォルダーがリストされるので、オプションで、 プロキシーのセキュリティーを使用可能にしたり、名前空間とパッケージ間のカスタム・マッピングを 作成したりすることができます。「次へ」をクリックします。
  6. 「Web サービス・クライアントの名前空間からパッケージへのマッピング」ページ: 前ページで 「名前空間からパッケージへのカスタム・マッピングを定義」を選択した場合は、 このページで「追加」をクリックして、カスタム・マッピングのペアを入力することができます。 あるいは、「インポート」をクリックして、.properties ファイルから カスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 namespace=package というフォーマットでなければなりません。 プロパティー・ファイル内の一部の特殊文字をエスケープする必要があります。例えば、http://someNamespace=somePackagehttp¥://someNamespace=somePackage とする必要があります。そうしないと、コロン (:) は区切り文字として扱われ、その結果、http//someNamespace=somePackage にマップするよう試行されます。 Java のプロパティー・ファイルのフォーマットに関する詳細は、Java プラットフォーム API 資料: java.util.Properties のロード・メソッドを参照してください。
  7. 「Web サービス・クライアント・テスト」ページ: プロキシーのテストに使用するテスト機能と、プロキシーに組み込むメソッドを選択します。 TCP/IP モニターを介して Web サービス・トラフィックを経路指定する場合は、Universal Test Client を使用して Web サービスをテストできないことに注意してください。「次へ」をクリックします。
  8. 終了」をクリックします。プロキシーのテストを選択した場合、 テスト・クライアントはブラウザー・ウィンドウに表示されます。

タスクの結果

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

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

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


フィードバック