「Web サービス・クライアント」ウィザードを使用すると、
Java™ Bean
プロキシーおよびサンプル・アプリケーションを簡単に生成できます。
このサンプル Web アプリケーションは、プロキシー・ファイルのコーディング方法を実物で示します。
前提条件:
- サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、
それをインストールして、そのインスタンスを構成し、Apache Tomcat サーバーおよび Web プロジェクトの作成の記述に従って、
それをターゲットとした Web プロジェクトを作成する必要があります。
- WebSphere® サーバーを使用している場合には、
WebSphere
サーバーおよび Web プロジェクトの作成の記述に従って、
適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。
WebSphere Application Server の開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。
このサーバーが立ち上がるまでに、ご使用のコンピューターの速度にもよりますが、数分かかることがあるからです。
サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して
(「ウィンドウ」 > 「ビューの表示」 > 「サーバー」)
右クリックし、「開始」をクリックする。
- WSDL 文書をディスカバーし、Web プロジェクトにインポートする。
使用できる WSDL ファイルは、サービス・エレメントを含むもののみです。
ディスカバーした WSDL 文書から
Java
クライアント・プロキシーおよびサンプル・アプリケーションを生成するには、以下の手順を実行します。
- J2EE パースペクティブに切り替える
(「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
- 「ナビゲーター」ビューで、サンプル・アプリケーションを生成する Web プロジェクトを選択する。
- 「ファイル」 > 「新規」 > 「その他」の順にクリックする。
各種の Web サービス・ウィザードを表示するために、「Web サービス」を選択する。
「Web サービス・クライアント」ウィザードを選択する。
「次へ」をクリックする。
- 「Web Services」ページ: 生成するプロキシーのタイプ、およびそのプロキシーをテストするかどうかを選択する。
- 「クライアント環境構成」ページ: ランタイム環境および Web サービス・クライアント用のサーバーを選択する。
- 「オプションの検討」
をクリックして、Apache Axis 1.0 ランタイム環境を選択し、Web サービス・クライアントを実行するためのサーバーを選択する。 IBM® SOAP ランタイム環境または
IBM WebSphere ランタイム環境を使用する場合は、
それぞれ該当するタスクを参照してください。
- 作成された Web サービス・クライアントに必要なプロジェクトのタイプおよび名前を選択する。
- 既存のプロジェクトの名前を入力する場合、
プロジェクト・タイプ・フィールドは、
その既存のプロジェクトのタイプ・フィールドと一致する必要があります。
クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、
またはクライアントが生成した作成物によってサービスが上書きされるようになっていることを確認します。
- まだ存在していないプロジェクトの名前を入力する場合は、
ウィザードでプロジェクトを作成できます。
- Axis および SOAP ランタイム・クライアントでサポートされているプロジェクト・タイプは、
Web プロジェクトのみである点に注意してください。
クライアントを
Java、EJB、
または Application クライアント・プロジェクトに作成する場合、
使用するクライアントに
WebSphere
ランタイム環境を選択する必要があります。
- 「Web サービス選択」ページ: クライアントの生成に使用する WSDL、WSIL、または HTML ファイルに URI を入力する。
オプションで、このファイルから WSIL ファイルを生成することもできます。
- 「Web サービス・プロキシー」ページ: このパネルにプロキシーのオプションが表示されます。
ここにはプロキシーが生成されるフォルダーがリストされ、
オプションで、名前空間とパッケージ間にカスタム・マッピングを作成できます。
- 「Web サービスの名前空間からパッケージへのマッピング」ページ:
前のページで「名前空間からパッケージへのカスタム・マッピングを定義する」を選択した場合、
「追加」をクリックして、このパネルでカスタム・マッピングのペアを入力できます。
- 「Web サービス・クライアントのテスト」ページ: プロキシーのテストに使用するテスト機能と、
プロキシーに組み込むメソッドを選択する。
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 ブラウザーに起動されます。
このサンプル・アプリケーションを使用すると、メソッドを選択し、
そのメソッドに値を入力して「呼び出し」をクリックすることにより、Web サービスをテストできます。
メソッドの結果は、結果ペインに表示されます。
- 生成したプロキシーを Universal Test Client によってテストする方法を選択した場合、
次の URL を指定すると、プロキシーが Web ブラウザーで起動されます:
http://localhost:9080/UTC/preload?object= BeanPackage.BeanServiceProxy。
オブジェクト参照の下の「参照」ペインで、プロキシー・スタブを展開して、Web サービスのメソッドを表示します。
テストするメソッドをクリックし、パラメーター・ペインに値を入力して「呼び出し」をクリックします。
その情報の下に結果が生成されます。
- Web サービス・エクスプローラーの使用による Web サービスのテストを選択すると、エクスプローラーが開きます。
テストする操作を選択し、必要な情報を入力して「実行」をクリックします。
「状況」ペインに結果が表示されます。
Web プロジェクトの作成について詳しくは、Web アプリケーション開発の文書を参照してください。