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

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

前提条件:

  1. サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、 それをインストールして、そのインスタンスを構成し、Apache Tomcat サーバーおよび Web プロジェクトの作成の記述に従って、 それをターゲットとした Web プロジェクトを作成する必要があります。
  2. WebSphere® サーバーを使用している場合には、 WebSphere サーバーおよび Web プロジェクトの作成の記述に従って、 適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。 WebSphere Application Server の開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。 このサーバーが立ち上がるまでに、ご使用のコンピューターの速度にもよりますが、数分かかることがあるからです。 サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して (「ウィンドウ」 > 「ビューの表示」 > 「サーバー」) 右クリックし、「開始」をクリックする。
  3. WSDL 文書をディスカバーし、Web プロジェクトにインポートする。  使用できる WSDL ファイルは、サービス・エレメントを含むもののみです。
ディスカバーした WSDL 文書から Java クライアント・プロキシーおよびサンプル・アプリケーションを生成するには、以下の手順を実行します。
  1. J2EE パースペクティブに切り替える (「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
  2. 「ナビゲーター」ビューで、サンプル・アプリケーションを生成する Web プロジェクトを選択する。
  3. 「ファイル」 > 「新規」 > 「その他」の順にクリックする。 各種の Web サービス・ウィザードを表示するために、「Web サービス」を選択する。 「Web サービス・クライアント」ウィザードを選択する。 「次へ」をクリックする。
  4. 「Web Services」ページ: 生成するプロキシーのタイプ、およびそのプロキシーをテストするかどうかを選択する。
  5. 「クライアント環境構成」ページ: ランタイム環境および Web サービス・クライアント用のサーバーを選択する。
    1. 「オプションの検討」 をクリックして、Apache Axis 1.0 ランタイム環境を選択し、Web サービス・クライアントを実行するためのサーバーを選択する。 IBM® SOAP ランタイム環境または IBM WebSphere ランタイム環境を使用する場合は、 それぞれ該当するタスクを参照してください。
    2. 作成された Web サービス・クライアントに必要なプロジェクトのタイプおよび名前を選択する。
      • 既存のプロジェクトの名前を入力する場合、 プロジェクト・タイプ・フィールドは、 その既存のプロジェクトのタイプ・フィールドと一致する必要があります。 クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、 またはクライアントが生成した作成物によってサービスが上書きされるようになっていることを確認します。
      • まだ存在していないプロジェクトの名前を入力する場合は、 ウィザードでプロジェクトを作成できます。
      • Axis および SOAP ランタイム・クライアントでサポートされているプロジェクト・タイプは、 Web プロジェクトのみである点に注意してください。 クライアントを Java、EJB、 または Application クライアント・プロジェクトに作成する場合、 使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
  6. 「Web サービス選択」ページ: クライアントの生成に使用する WSDL、WSIL、または HTML ファイルに URI を入力する。 オプションで、このファイルから WSIL ファイルを生成することもできます。
  7. 「Web サービス・プロキシー」ページ: このパネルにプロキシーのオプションが表示されます。 ここにはプロキシーが生成されるフォルダーがリストされ、 オプションで、名前空間とパッケージ間にカスタム・マッピングを作成できます。
  8. 「Web サービスの名前空間からパッケージへのマッピング」ページ: 前のページで「名前空間からパッケージへのカスタム・マッピングを定義する」を選択した場合、 「追加」をクリックして、このパネルでカスタム・マッピングのペアを入力できます。
  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