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