コマンド行によって生成された Web サービスのテスト

コマンド行ツールで作成した Web サービスをデプロイした後で、Web サービス・ エクスプローラーまたは Web サービス・クライアント・ウィザードを使用して、 あるいは生成されたクライアント・コードを新しい Java™ プロジェクト または Web プロジェクトにインポートすることによって、Web サービスを テストすることができます。
コマンド行ツールを使用して作成した Web サービスをテストする前に、EAR をサーバーにデプロイしておく必要があります。そのためには、 コマンド行ツールを使用した Web サービスのサーバーへのデプロイで概説している手順に従ってください。

Web サーバーの始動

Web サービスをテストする前に、まず、Web サーバーを始動する 必要があります。サーバーを始動する手順は、次のとおりです。

  1. 「サーバー」ビューに切り替えます (「ウィンドウ」>「Show View」>「サーバー」)。
  2. 「サーバー」ペインで、「サーバー」タブが表示されていることを確認します。
  3. 作成および構成したサーバーのポップアップ・メニューから、 「始動」を選択します。

これで、次の 3 つの方法のいずれかを使用して Web サービスのテストを行うことができます。

Web サービス・エクスプローラーによる Web サービスのテスト

Web サービス・エクスプローラーを使用して Web サービスをテストする手順は、次のとおりです。

  1. Web パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」> 「Web」)。
  2. 「プロジェクト・ナビゲーター」ペインで、次のいずれかの方法で、 WSDL ファイルを見つけます。
    • EAR ファイルに Java Bean が含まれている場合は、インポートされた Web プロジェクトの「WebContent」>「WEB-INF」>「wsdl」を展開します。
    • EAR ファイルに EJB Bean が含まれている場合は、インポートされた EJB プロジェクトの 「EJBModule」>「META-INF」>「wsdl」を展開します。
  3. WSDL ファイルを右クリックし、ポップアップ・メニューから、 「Web サービス」>「Test with Web Services Explorer」を選択します。

Web サービス・クライアント・ウィザードによる Web サービスのテスト

Web サービス・クライアント・ウィザードを使用してクライアント・プロキシーを生成し、 その後、生成した JSP コードを使用して Web サービスをテストすることができます。 

Web サービス・クライアント・ウィザードを使用して Web サービスをテストする手順は、次のとおりです。

  1. Web パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」> 「Web」)。
  2. 「プロジェクト・ナビゲーター」ペインで、次のいずれかの方法で、 WSDL ファイルを見つけます。
    • EAR ファイルに Java Bean が含まれている場合は、インポートされた Web プロジェクトの「WebContent」>「WEB-INF」>「wsdl」を展開します。
    • EAR ファイルに EJB Bean が含まれている場合は、インポートされた EJB プロジェクトの 「EJBModule」>「META-INF」>「wsdl」を展開します。
  3. テストする WSDL ファイルを選択します。
  4. 「ファイル」>「新規」>「その他」の順に選択する。リストから、 「Web サービス」と「Web Service Client」を選択します。 「次へ」をクリックします。
  5. 「Client Proxy type」が「Java Proxy」 であることと、「Test the Web service」ボックスにチェック・マークが 付いていることを確認します。「次へ」をクリックします。
  6. WSDL ファイルは事前に入力されています。入力されていない場合は、そのファイルを探してください。「次へ」をクリックします。
  7. 「Client Environment Configuration」ページで、(Web サービスのデプロイ時に) 作成 および構成したサーバーが、「サーバー」の下にリストされていることを 確認します。リストされていない場合は、「編集」を 選択してから、Existing Servers フォルダーの下に作成したサーバーを選択します。
  8. 「Client」プロジェクト・タイプを選択します。「Client Project」 フィールドに、このクライアント Web プロジェクトに固有のプロジェクト名を 入力して、別のクライアント Web プロジェクトに入れる Web サービス・クライアント・ コードを生成します。注: このフィールドに表示されるデフォルト名は、 インポートされた Web プロジェクトまたは EJB プロジェクトの名前であるため、 受け入れないでください。クライアント・プロジェクトに「EAR」を選択します。
  9. 「終了」をクリックします。
生成した JSP を使用して、組み込み Web ブラウザーで Web サービスをテストします。

Web サービス・コマンド行で生成したクライアント・コードによる Web サービスのテスト

Web サービス・コマンド行で生成したクライアント・コードで Web サービスを テストするには、生成したコードを 新規の Java プロジェクト または Web プロジェクトにインポートします。注: このタスクで作成する 新規の Web プロジェクトまたは Java プロジェクトは、Web サービスの デプロイ時に EAR ファイルを使用してインポートした EJB および Web プロジェクトとは 別のものです。

WSDL2Client が生成したクライアント・エンタープライズ・アプリケーション (EJB およびサーブレット) の インポート

  1. J2EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」>「J2EE」)。
  2. J2EE 階層を右クリックして「インポート」>「EAR ファイル」を 選択し、EAR ファイルをインポートします。ターゲット・サーバーを選択します。「次へ」をクリックします。
  3. クライアント EAR ファイルを探し (通常は ClientProject/client-side の下にあります)、 必要ならプロジェクト名を変更します。「終了」をクリックします。
  4. サーバー・パースペクティブに切り替えます (「ウィンドウ」 > 「パースペクティブを開く」 > 「サーバー」)。サーバーが既に存在する場合は、 ステップ 7 に進んでください。
  5. 「サーバー構成」ペインで「サーバー」を右クリックし、 「新規」 > 「サーバーおよびサーバー構成」を選択します。
  6. 該当するサーバー・タイプを選択し (デフォルトは、 WebSphere® バージョン 5.1 での テスト環境)、サーバー名を入力します。「終了」をクリックします。
  7. 「サーバー構成」ペインで「サーバー」ツリーを展開し、 アプリケーションの宛先サーバーを右クリックして、 「プロジェクトの追加と除去」を選択します。
  8. 「選択可能プロジェクト」から新規にインポートされた クライアント・エンタープライズ・アプリケーションを選択し、「追加」をクリックしてから 「終了」をクリックします。

WSDL2Client が生成したクライアント・エンタープライズ・アプリケーション (J2EE アプリケーション) の インポート

  1. J2EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」>「J2EE」)。
  2. J2EE 階層を右クリックして「インポート」>「EAR ファイル」を 選択し、EAR ファイルをインポートします。「次へ」をクリックします。
  3. クライアント EAR ファイルを探し (通常は ClientProject/client-side の下にあります)、 必要ならプロジェクト名を変更します。「終了」をクリックします。
  4. ツールバーから「実行」 > 「実行...」を選択し、 WebSphere v5.1 Application Client または WebSphere v5 Application Client を選択して (インストール時にサーバーを インストールした場合)、「新規」をクリックします。
  5. 「エンタープライズ・アプリケーション」コンボ・ボックスからプロジェクトを選択して、 「実行」をクリックします。

生成したクライアント・コードの Java プロジェクトへのインポート

  1. Java パースペクティブに 切り替えます (「ウィンドウ」>「パースペクティブを開く」>「Java」)。
  2. 「ファイル」>「新規」>「その他」と選択して、 新規 Java プロジェクトを作成します。リストから、「Java」と「Java Project」を選択します。「次へ」をクリックします。
  3. 新規 Java プロジェクトの名前を入力します。「終了」をクリックします。
  4. 「パッケージ・エクスプローラー」ペインで、新規 Java プロジェクトの ポップアップ・メニューから「プロパティー」を選択します。 「Java ビルド・パス」を 選択します。
  5. 「ライブラリー」タブをクリックします。「変数の追加」をクリックします。
  6. 「New Variable Classpath Entry」ダイアログで、リストから WAS_50_PLUGINDIR を選択します。「拡張」をクリックします。
  7. 「Variable Extension」ダイアログで、lib フォルダーを展開します。 選択するときに Ctrl キーを押したままにして、次の 5 つの JAR ファイルを 選択します。
    • commons-discovery.jar
    • commons-logging-api.jar
    • qname.jar
    • webservices.jar
    • wsdl4j.jar
  8. 「OK」をクリックします。
  9. 「パッケージ・エクスプローラー」ペインで、Java プロジェクトを選択します。
  10. 「ファイル」>「インポート」を選択します。 リストから「File System」を選択します。「次へ」をクリックします。
  11. 「参照」をクリックします。コマンド行のテスト・ディレクトリーを表示して、プロジェクト・ディレクトリー (Web サービス・コマンド行ツールの実行時に -project で 指定したディレクトリー) を展開します。
  12. Client-side フォルダーを展開します。各フォルダーの横のチェック・ ボックスが (META-INF を除いて) すべて選択されていることを確認します。
  13. 「終了」をクリックします。

生成したクライアント・コードの Web プロジェクトへのインポート

  1. Java パースペクティブに 切り替えます (「ウィンドウ」>「パースペクティブを開く」>「Java」)。
  2. 「ファイル」>「新規」>「その他」を選択して 新規 Web プ ロジェクトを作成します。リストから「Web」および「Dynamic Web Project」を選択します。
  3. 新規クライアント Web プロジェクトの名前を入力します。「Configure Advanced Options」 ボックスにチェック・マークが付いていることを確認します。「次へ」を クリックします。
  4. 「EAR Project」フィールドで、ドロップダウン・メニューから、 インポートした EAR ファイルを選択します。
    • サーバーのターゲット化が使用可能になっている場合 (「ウィンドウ」>「設定」>「J2EE」>「Enable server targeting support」を選択)、WebSphere Application Server v5.1 を選択することによって、このページにターゲット・サーバーを選択するオプションが表示されます。ステップ 6 から 11 までは省略できます。「終了」をクリックして、 ステップ 12 に進んでください。
  5. 「終了」をクリックします。
  6. 「パッケージ・エクスプローラー」ペインで、クライアント Web プロジェクトの ポップアップ・メニューから「プロパティー」を選択します。 「Java ビルド・パス」を 選択します。
  7. 「ライブラリー」タブをクリックします。「変数の追加」をクリックします。
  8. 「New Variable Classpath Entry」ダイアログで、リストから WAS_50_PLUGINDIR を選択します。「拡張」をクリックします。
  9. 「Variable Extension」ダイアログで、lib フォルダーを展開します。 選択するときに Ctrl キーを押したままにして、次の 6 つの JAR ファイルを 選択します。
    • commons-discovery.jar
    • commons-logging-api.jar
    • j2ee.jar
    • qname.jar
    • webservices.jar
    • wsdl4j.jar
  10. 「OK」をクリックします。
  11. 「パッケージ・エクスプローラー」ペインで、クライアント Web プロジェクトの JavaSource フォルダーを選択します。「ファイル」>「インポート」を 選択します。
  12. リストから「File System」を選択します。「次へ」をクリックします。
  13. 「参照」をクリックします。コマンド行のテスト・ディレクトリーを表示して、プロジェクト・ディレクトリー (Web サービス・コマンド行ツールの実行時に -project で指定したディレクトリー) を展開します。
  14. Client-side フォルダーを展開します。各フォルダーの横のチェック・ ボックスが (META-INF を除いて) すべて選択されていることを確認します。
  15. 「終了」をクリックします。

Web サービスのテストが終了したら、クライアント・アプリケーションを作成して Web サービスに アクセスすることができます。

関連タスク
コマンド行ツールを使用した WebSphere JAX-RPC ランタイム環境 Web サービスおよびクライアントの作成
コマンド行ツールを使用した Web サービスのサーバーへのデプロイ
フィードバック