WSDL 文書からの Java クライアント・プロキシーおよびサンプル・アプリケーションの生成

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

前提条件:

WebSphere^® サーバーおよび Web プロジェクトの作成の説明に従って、動的な Web プロジェクトを作成します。 WebSphere Application Server が立ち上がるまでに、ご使用のコンピューターの速度にもよりますが、数分かかることがありますので、このサーバーの開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して (「ウィンドウ」 > 「ビューの表示」 > 「サーバー」) 右クリックし、「始動」をクリックする。
WSDL 文書をディスカバーし、Web プロジェクトにインポートします。使用できる WSDL ファイルは、サービス要素を含むもののみです。

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

J2EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」>「J2EE」)。
「プロジェクト・エクスプローラー」ビューで、サンプル・アプリケーションを生成する Web プロジェクトを選択します。
「ファイル」>「新規」>「その他」の順にクリックします。「Web サービス」を選択して、各種の Web サービス・ウィザードを表示します。「Web Service Client」ウィザードを選択します。「次へ」をクリックします。
「Web サービス」ページ: クライアントを生成するために使用する WSDL ファイルを選択します。次の操作を実行するオプションもあります。
1. スライダーを使用して完了させたい Web サービス・クライアント開発のステージを選択します。
  - 開発: Web サービスの WSDL 定義および実装を開発します。これには、生成されたコード、WSDL ファイル、デプロイメント記述子、および Java ファイル (該当する場合) が入るモジュールの作成などのタスクが含まれます。
  - アセンブル: これにより、Web サービス・クライアントをホストするプロジェクトが、ターゲット・アプリケーション・サーバーによって要求されたときに EAR に関連付けられるようになります。
  - デプロイ: これにより、クライアントのデプロイメント・コードが作成されます。
  - インストール: これにより、Web モジュールと EAR がターゲット・サーバーにインストールされ、構成されます。 WSDL ファイルのエンドポイントに対する変更が必要な場合、このステージで変更が行われます。
  - 始動: これにより、クライアントがサーバーにインストールされると、サーバーが始動するようになります。
  - テスト: これにより、Web Service Explorer またはサンプル JSP の使用などの、サービスをテストするためのさまざまなオプションが提供されます。
2. サーバーの選択: デフォルト・サーバーが表示されます。サービスを別のサーバーにデプロイしたい場合には、リンクをクリックして別のサーバーを指定してください。
3. ランタイムの選択: デフォルトのランタイムが表示されます。サービスを別のランタイムにデプロイしたい場合には、リンクをクリックして別のランタイムを指定してください。
4. サービス・プロジェクトの選択: ワークスペースで選択されたプロジェクトを含むプロジェクトが表示されます。別のプロジェクトと EAR を選択するためには、プロジェクト・リンクをクリックしてください。クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、またはクライアントが生成した成果物によってサービスが上書きされるようになっていることを確認します。
5. Web サービスのモニター: Web サービス・トラフィックを TCP/IP モニターを介して送信します。これにより、Web サービスによって生成される SOAP トラフィックを監視し、このトラフィックが WS-I に準拠しているかどうかをテストできます。あるいは、『TCP/IP モニターを使用した Web サービスのテスト (Using the TCP/IP Monitor to test Web services)』で説明されているように、TCP/IP モニターを手動でセットアップすることができます。
「Web Service Proxy」ページ: このページには、プロキシーのオプションが表示されます。ここにはプロキシーが生成されるフォルダーがリストされるので、オプションで、プロキシーのセキュリティーを使用可能にしたり、ネーム・スペースとパッケージ間のカスタム・マッピングを作成したりすることができます。「次へ」をクリックします。
「パッケージ・マッピングへの Web サービス・クライアント名前空間 (Web Service Client Namespace to Package Mappings)」ページ: Web サービス・クライアント・ウィザードは、指定された WSDL から多数の Java ファイルを生成します。デフォルトでは、WSDL ファイルに指定された名前空間に基づいてパッケージ名を作成します。このデフォルトの動作を無効にするには、WSDL ファイル内のいくつか、またはすべての名前空間に独自のパッケージ名を指定してください。前ページで「Define custom mapping for namespace to package」を選択した場合は、このページで「追加」をクリックして、カスタム・マッピングのペアを入力することができます。あるいは、「インポート」をクリックして、.properties ファイルからカスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 namespace=package というフォーマットでなければなりません。データ・バインディングを使用不可に設定して、WSDL から Java を生成するときに SOAP 要素を使用することもできます。「次へ」をクリックします。
「Web Service Client Test」ページ: プロキシーのテストに使用するテスト機能と、プロキシーに組み込むメソッドを選択します。 Universal Test Client (UTC) は、WebSphere サーバーにデプロイされている 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。「Object References」の下の「参照」ペインで、このプロキシー・スタブを展開して Web サービスのメソッドを表示します。テストするメソッドをクリックし、「パラメーター」ペインに値を入力して「Invoke」をクリックします。下に結果が生成されます。
Web サービス・エクスプローラーの使用による Web サービスのテストを選択すると、エクスプローラーが開きます。テストするオペレーションを選択し、必要な情報を入力して「Go」をクリックします。「状況」ペインに結果が表示されます。

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

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