「Web サービス」ウィザードを使用すると、既存の WSDL 文書からスケルトン Bean が簡単に作成できます。
スケルトン Bean には、WSDL 文書で説明する操作に対応する一連のメソッドが含まれています。
Bean が作成されると、各メソッドには、Bean の編集をすることによって置き換えられる、単純な実装ができます。
前提条件:
- サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、
それをインストールして、そのインスタンスを構成し、Apache Tomcat サーバーおよび Web プロジェクトの作成の記述に従って、
それをターゲットとした Web プロジェクトを作成する必要があります。
- WebSphere® サーバーを使用している場合には、
WebSphere
サーバーおよび Web プロジェクトの作成の記述に従って、
適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。
WebSphere Application Server の開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。
このサーバーが立ち上がるまでに、ご使用のコンピューターの速度にもよりますが、数分かかることがあるからです。
サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して
(「ウィンドウ」 > 「ビューの表示」 > 「サーバー」)
右クリックし、「開始」をクリックする。
- Web プロジェクトの Web コンテンツ・フォルダーに WSDL ファイルを作成またはインポートする。
使用できる WSDL ファイルは、サービス・エレメントを含むもののみです。
Apache Axis 1.0 ランタイム環境を使用して WSDL ファイルから Web サービスを作成するには、以下の手順を実行します。
- J2EE パースペクティブに切り替える
(「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
- 「プロジェクト・エクスプローラー」ビューで、
ご使用の Web プロジェクトの Web コンテンツ・フォルダーに作成またはインポートした WSDL ファイルを選択する。
- 「ファイル」 > 「新規」 > 「その他」の順にクリックする。
各種の Web サービス・ウィザードを表示するために、「Web サービス」を選択する。
「Web サービス」ウィザードを選択する。「次へ」をクリックする。
- 「Web サービス」ページ: Web サービス・タイプとして「スケルトン Java Bean Web サービス」を選択する。
次の操作を実行するオプションもあります。
- Web プロジェクトで Web サービスを開始する。このオプションを選択しない場合は、
Web サービスを手動で開始する必要があります。
このオプションを選択しないと、このページの他のオプションは使用可能になりません。
- Web サービス・エクスプローラーを起動して、Web サービスを UDDI レジストリーに公開する。
- Web サービスに Java™ Bean クライアント・プロキシーを生成する。
生成される Java Bean クライアント・プロキシーは、
Web サービスへのリモート・プロシージャー・コール・インターフェースを提供します。
- Web サービスをテストする。 これにより、プロキシーの生成前に Web サービス・エクスプローラーで
Web サービスをテストできます。
- Web サービス・トラフィックを TCP/IP モニターを通して送信する。
これにより、 Web サービスによって生成される SOAP トラフィックを監視し、
このトラフィックが WS-I 準拠かどうかをテストできます。
このサポートは Tomcat v4.0 および v4.1 についてのみですから注意してください。
Tomcat v5.0 を使用していて Web サービス・トラフィックのモニターを望まれる場合は、
TCP/IP モニターの手動セットアップが必要になります。 その方法は ../../com.ibm.etools.wsi.test.tools.validate.doc/tasks/tmonitor.html の説明に従ってください。
- 「Web サービス選択」ページ: Java Bean
の生成に使用する WSDL、WSIL、または HTML ファイルに URI を入力する。
ウィザードの開始前に WSDL ファイルを選択していた場合、この情報は事前に入力されているはずです。
オプションで、このファイルから WSIL ファイルを生成することもできます。 URI の先頭にスペースがないか、あるいは NULL ポインター例外が生成されていないかどうかを確認してください。
- 「サービス・デプロイメント構成」ページ: サーバーとクライアントのデプロイメント設定を指定する。
- 「編集」をクリックし、Apache Axis 1.0 ランタイム環境を選択して、
Web サービスおよび Web サービス・クライアントを実行するためのサーバーを選択する。 IBM® SOAP ランタイム環境または
IBM WebSphere ランタイム環境を使用する場合は、
それぞれ該当するタスクを参照してください。
- Web サービスを作成する Web プロジェクトを選択する。 これらがまだ存在しない場合には、ウィザードで作成します。
- 作成された Web サービス・クライアントに必要なプロジェクトのタイプおよび名前を選択する。
既存のプロジェクトの名前を入力する場合、プロジェクト・タイプ・フィールドは、
その既存のプロジェクトのタイプ・フィールドと一致する必要があります。
まだ存在していないプロジェクトの名前を入力する場合は、
ウィザードでプロジェクトを作成できます。
Axis および SOAP ランタイム・クライアントでサポートされているプロジェクト・タイプは、
Web プロジェクトのみである点に注意してください。
クライアントを
Java、EJB、
または Application クライアント・プロジェクトに作成する場合、
使用するクライアントに
WebSphere
ランタイム環境を選択する必要があります。
- 「Web サービス・スケルトン
Java Bean 構成」ページ:
生成した Java
を保管するフォルダーを選択する。
パッケージから名前空間へのマッピングを確認または編集する場合は
、 「名前空間からパッケージへのカスタム・マッピングを定義する」チェック・ボックスを選択する。
「次へ」をクリックする。
- 「Web サービスの名前空間からパッケージへのマッピング」ページ:
前のパネルで「パッケージから名前空間へのカスタム・マッピングを定義する」を選択した場合、
「追加」をクリックして、このパネルにカスタム・マッピングのペアを入力できます。
「次へ」をクリックする。
- 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、
生成した Web サービスに対するテスト機能を選択する。
これにより、この Web サービスが Web サービス・エクスプローラーに開きます。
テストする操作を選択し、必要な情報を入力して「実行」をクリックする。
「状況」ペインに結果が表示されます。
「次へ」をクリックする。
- 「Web サービス・プロキシー」ページ: プロキシーの生成を選択した場合、
このページにプロキシーのオプションが表示されます。
ここにはプロキシーが生成されるフォルダーがリストされ、オプションで、
名前空間とパッケージ間にカスタム・マッピングを作成できます。
「次へ」をクリックする。
- 「Web サービス・クライアントのテスト」ページ: このページを使用して、次のオプションを選択する。
- テスト機能を選択する。
生成したプロキシーを Universal Test Client または Web サービス・エクスプローラーでテストするか、
またはサンプル Web サービス JSP を生成することができます。
- JSP を使用してプロキシーをテストする方法を選択した場合、
JSP を配置するフォルダーを選択し、JSP に組み込むメソッドを選択できます。
- 「サーバー上でテストを実行する」 を選択して、サーバーが自動的に開始されるようにする。
- 「Web サービスの公開」ページ: Web サービスを UDDI レジストリーに公開することを選択した場合は、
このページを使用して Web サービス・エクスプローラーを起動し、Web サービスの公開先の UDDI レジストリーを選択する。
「終了」をクリックする。
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 サービス・エクスプローラーが起動し、IBM UDDI テスト・レジストリーに
Web サービスを公開するために必要なページが表示されます。
「Web サービスの公開」 の指示に従って、このタスクを完了します。