「Web サービス (Web Service)」ウィザードを使用すると、新規 Web サービスの作成、
そのサービスのデプロイメント用の構成、および Web サービスのサーバーへのデプロイを、簡単に行うことができます。
Web サービスをデプロイした後では、このウィザードに従うと、
クライアント・プロキシーおよびサンプル・アプリケーションを生成して、Web サービスをテストすることができます。
テストが完了したら、「エクスポート」ウィザードを使用して、
Web サービスを UDDI Business Registry に発行することができます。
前提条件:
- サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、
それをインストールして、そのインスタンスを構成し、
WebSphere® サーバーおよび Web プロジェクトの作成の記述に従って、
それをターゲットとした Web プロジェクトを作成する必要があります。
- WebSphere サーバーを使用している場合には、
WebSphere サーバーおよび Web プロジェクトの作成の記述に従って、
適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。
WebSphere Application Server が立ち上がるまでに、
ご使用のコンピューターの速度にもよりますが、数分かかることがありますので、
このサーバーの開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。
サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して
(「ウィンドウ」 > 「ビューの表示」 > 「サーバー」)
右クリックし、「開始」をクリックする。
- Bean を作成するか、または Web プロジェクトのソース・フォルダーにインポートする。
Bean から Web サービスを作成するには、以下の手順を実行します。
- J2EE パースペクティブに切り替える (「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
- 「プロジェクト・エクスプローラー」ビューで、
ご使用の Web プロジェクトのソース・フォルダーに作成またはインポートした Bean を選択する。
- 「ファイル」 > 「新規」 > 「その他」の順にクリックする。
各種の 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 準拠かどうかをテストできます。
- 「オブジェクト選択」ページ: Web サービスの作成元とする
Java Bean を選択する。
- 「サービス・デプロイメント構成 (Service Deployment Configuration)」ページ: サーバーとクライアントのデプロイメント設定を指定する。
- 「編集」をクリックし、
IBM® SOAP ランタイム環境を選択して、
Web サービスおよび Web サービス・クライアントを実行するためのサーバーを選択する。 Apache Axis 1.0 ランタイム環境または
IBM
WebSphere
ランタイム環境を使用する場合は、該当するタスクを参照してください。
- 作成する Web サービスに含める Web プロジェクトおよび EAR を選択する。 これらがまだ存在しない場合には、ウィザードで作成します。
- Web サービス・クライアントを作成するプロジェクトの
タイプおよび名前を選択する。
既存のプロジェクトの名前を入力する場合、プロジェクト・タイプ・フィールドは、
その既存のプロジェクトのタイプ・フィールドと一致する必要があります。
まだ存在していないプロジェクトの名前を入力する場合は、
ウィザードでプロジェクトを作成できます。
Axis および SOAP ランタイム・クライアントでサポートされている
プロジェクト・タイプは、Web プロジェクトのみである点に注意してください。
クライアントを Java、EJB、
またはアプリケーション・クライアント・プロジェクトに作成する場合、
使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
- 既存の EAR を選択するか、Web サービス・クライアント
と、Web サービス EAR 以外の別の EAR とを関連付ける固有の名前を入力する。
まだ存在していない EAR の名前を入力した場合は、ウィザードにより自動的に EAR が作成されます。
注: Web サービスと Web サービス・クライアントについて異なる EAR を
選択すると、実行時エラーの発生頻度は減りますが、
より多くのシステム・リソースを使用します。
- 「Web サービス Java Bean ID」パネル: Web サービスの URI とスコープを指定する。
オプションで、静的メソッドとセキュア SOAP を使用することも選択できます。
このページにリストされた文書名とフォルダー名は変更できます。デフォルト名をそのまま使用してもかまいません。
- 「Web サービス Java Bean メソッド」パネル: 公開するメソッドを選択し、
入出力のエンコード・スタイルを選択する。Java から
XML へのマッピングを確認する場合は、
「サーバー (Java から XML) 型のマッピングの表示」を選択する。
- 「Web サービス Java から XML へのマッピング」ページ: マッピングの確認を選択した場合、
ここで表示できます。
または、「カスタマイズ済みマッピングを編集および使用」を選択して、マッピングをカスタマイズする。
- 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、
生成した Web サービスに対するテスト機能を選択し、「起動」をクリックする。これにより、Web サービス・エクスプローラーでその Web サービスが開きます。
テストするオペレーションを選択し、必要な情報を入力して「実行」をクリックします。「状況」ペインに結果が表示されます。
Web サービスのテストを完了したら、ブラウザー・ウィンドウをクローズして、「次へ」をクリックする。
- 「Web サービス・バインディング・プロキシー生成」パネル: プロキシーの生成を選択した場合、
バインディングとプロキシーのオプションを選択する。
- 「Web サービス・クライアントのテスト (Web Service Client Test)」ページ: このページを使用して、次のオプションを選択する。
- テスト機能を選択する。
生成したプロキシーを Universal Test Client または Web サービス・エクスプローラーでテストするか、
またはサンプル Web サービス JSP を生成することができます。
- JSP を使用してプロキシーをテストする方法を選択した場合、JSP を配置するフォルダーを選択し、JSP に組み込むメソッドを選択できます。
- 「サーバーでテストを実行」を選択して、サーバーが自動的に開始されるようにする。
- 「Web サービスの公開」ページ: この Web サービスを UDDI レジストリーに公開するかどうかを選択する。
「完了」をクリックします。
-
Web サービスを作成すると、選択したオプションに応じて、次の状態になります。
- 生成したプロキシーを Web サービス JSP を使用してテストすることを選択した場合、
プロキシーが http://localhost: port/WebProjectClient/sampleBeanName/WebService/TestClient.jsp
という URL を使用して Web ブラウザーに起動されます。このサンプル・アプリケーションを使用すると、メソッドを選択し、
そのメソッドに値を入力して「呼び出し」をクリックすることにより、Web サービスをテストできます。
メソッドの結果は、結果ペインに表示されます。
- 生成したプロキシーを Universal Test Client によってテストする方法を選択した場合、
次の URL を指定すると、プロキシーがブラウザー・ウィンドウで起動されます:
http://localhost:9080/UTC/preload?object=proxy.soap.ProxyNameProxy。
オブジェクト参照の下の「参照」ペインで、このプロキシーを展開して Web サービスのメソッドを表示します。
テストするメソッドをクリックし、パラメーター・ペインに値を入力して「呼び出し」をクリックします。下に結果が生成されます。
- Web サービス・エクスプローラーの使用による Web サービスのテストを選択すると、エクスプローラーが開きます。
テストするオペレーションを選択し、必要な情報を入力して「実行」をクリックします。
「状況」ペインに結果が表示されます。
- Web サービスの公開を選択した場合、Web サービス・エクスプローラーが起動し、
IBM UDDI
テスト・レジストリーに Web サービスを公開するために必要なページが表示されます。「Web サービスの発行 (Publishing the Web service)」の指示に従って、このタスクを完了します。
重要: サンプルでサポートされないタイプ (配列、インデックス・プロパティー、
コレクションなど) がメソッドに含まれている場合は、メソッドはサンプル・アプリケーションから省略され、
警告メッセージが出されます。