ISD ファイルは、Web サービス・デプロイメント記述子です。 デプロイされた ISD ファイルにより、
クライアント側で利用できるようにしなければならないサービスに関する情報 (URI、メソッド、クラス、
シリアライザー、デシリアライザーなど) が SOAP ランタイム環境に提供されます。
前提条件:
- サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、
それをインストールして、そのインスタンスを構成し、
WebSphere® サーバーおよび Web プロジェクトの作成の記述に従って、
それをターゲットとした Web プロジェクトを作成する必要があります。
- WebSphere サーバーを使用している場合には、
WebSphere サーバーおよび Web プロジェクトの作成の記述に従って、
適切なサーバーをターゲットとした動的 Web プロジェクトを作成する。
WebSphere Application Server が立ち上がるまでに、
ご使用のコンピューターの速度にもよりますが、数分かかることがありますので、
このサーバーの開始は、Web サービス・ウィザードを実行させる前に開始することを強くお勧めします。
サーバーを開始するには、「サーバー」ビューでこのサーバーを選択して
(「ウィンドウ」 > 「ビューの表示」 > 「サーバー」)
右クリックし、「開始」をクリックする。
「Web サービス」ウィザードに従うと、新規 Web サービスの作成、
そのサービスのデプロイメント用の構成、Web アプリケーションのデプロイ、新規 Web サービスのテスト、
サンプル・アプリケーションの作成、Web サービスの UDDI Business Registry への公開を簡単に行うことができます。
ISD Web サービスによって、Bean および EJB をすべての構成およびマッピング情報を再指定しなくても再デプロイすることができます。
ISD は、EJB JNDI、EJB ホーム名、URI、メソッド、クラス、スコープ、および型マッピングなどの情報を保管します。
Web サービスを ISD から作成するには、以下の手順を実行します。
- J2EE パースペクティブに切り替える (「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
- 「プロジェクト・エクスプローラー」ビューで、Web サービスを作成するための Web プロジェクトを選択する。
- 「ファイル」 > 「新規」 > 「その他」の順にクリックする。 各種の Web サービス・ウィザードを表示するために、「Web サービス」を選択する。
「Web サービス」ウィザードを選択する。「次へ」をクリックする。
- 「Web サービス」ページで、「Web サービス・タイプ」ドロップダウン・メニューから、
「ISD Web サービス」を選択する。次の操作を実行するオプションもあります。
- Web プロジェクトで Web サービスを開始する。
このオプションを選択しない場合は、Web サービスを手動で開始する必要があります。
このオプションを選択しないと、このページの他のオプションは使用可能になりません。
- Web サービス・エクスプローラーを起動して、Web サービスを UDDI レジストリーに公開する。
- Web サービスに Java™ Bean クライアント・プロキシーを生成する。生成される Java Bean
クライアント・プロキシーは、 Web サービスへのリモート・プロシージャー・コール・インターフェースを提供します。
- Web サービスをテストする。
これにより、プロキシーの生成前に Web サービス・エクスプローラーで Web サービスをテストできます。
- Web サービス・トラフィックを TCP/IP モニターを通して送信する。
これにより、Web サービスによって生成される SOAP トラフィックを監視し、
このトラフィックが WS-I 準拠かどうかをテストできます。
- Web サービスをテストする。
これにより、プロキシーの生成前に Web サービス・エクスプローラーで Web サービスをテストできます。
- Web サービス・エクスプローラーを起動して、Web サービスを公開する。
- Web サービスに
Java Bean
クライアント・プロキシーを生成する。
生成される Java Bean
クライアント・プロキシーは、Web サービスへのリモート・プロシージャー・コール・インターフェースを提供します。
- 生成したプロキシーを Web サービスのサンプル JSP、Web ツールのサンプル JSP、
または Universal Test Client によってテストする。
- 「サービス・デプロイメント構成」ページ: サーバーとクライアントのデプロイメント設定を指定する。
- 「編集」をクリックし、
IBM® SOAP ランタイム環境を選択して、
Web サービスおよび Web サービス・クライアントを実行するためのサーバーを選択する。
- 作成する Web サービスに含める Web プロジェクトおよび EAR を選択する。 これらがまだ存在しない場合には、ウィザードで作成します。
- 作成された Web サービス・クライアントに必要なプロジェクトのタイプおよび名前を選択する。
既存のプロジェクトの名前を入力する場合、
プロジェクト・タイプ・フィールドは、その既存のプロジェクトのタイプ・フィールドと一致する必要があります。
まだ存在していないプロジェクトの名前を入力する場合は、ウィザードでプロジェクトを作成できます。
Axis および SOAP ランタイム・クライアントでサポートされているプロジェクト・タイプは、
Web プロジェクトのみである点に注意してください。
クライアントを Java、EJB、
またはアプリケーション・クライアント・プロジェクトに作成する場合、
使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
- 既存の EAR を選択するか、
Web サービス・クライアントを Web サービス EAR 以外の別の EAR に関連付ける固有の名前を入力する。
注: Web サービスと Web サービス・クライアントについて異なる EAR を選択すると、実行時エラーの発生頻度は減りますが、
より多くのシステム・リソースを使用します。
- 「Web サービス ISD 選択」ページ: Web サービスの作成元の ISD ファイルの名前を入力する。
- 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、
生成した Web サービスに対するテスト機能を選択する。 これにより、この Web サービスが Web サービス・エクスプローラーに開きます。
テストする操作を選択し、必要な情報を入力して「実行」をクリックする。
「状況」ペインに結果が表示されます。
「次へ」をクリックする。
- 「Web サービス・バインディング・プロキシー生成」パネル: プロキシーの生成を選択した場合、
バインディングとプロキシーのオプションを選択する。
- 「Web サービス・クライアントのテスト」ページ: このページを使用して、次のオプションを選択する。
- テスト機能を選択する。
生成したプロキシーを 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 を指定すると、プロキシーが Web ブラウザーで起動されます:
http://localhost:9080/UTC/preload?object=proxy.soap.ProxyNameProxy。
オブジェクト参照の下の「参照」ペインで、このプロキシーを展開して Web サービスのメソッドを表示します。
テストするメソッドをクリックし、パラメーター・ペインに値を入力して「呼び出し」をクリックします。
その情報の下に結果が生成されます。
- Web サービス・エクスプローラーの使用による Web サービスのテストを選択すると、エクスプローラーが開きます。
テストする操作を選択し、必要な情報を入力して「実行」をクリックする。
「状況」ペインに結果が表示されます。
- Web サービスの公開を選択した場合、Web サービス・エクスプローラーが起動し、
IBM UDDI
テスト・レジストリーに Web サービスを公開するために必要なページが表示されます。
「Web サービスの公開」 の指示に従って、このタスクを完了します。
注: サポートされない型 (配列、インデックス・プロパティー、
コレクションなど) がメソッドに含まれている場合は、メソッドはサンプル・アプリケーションから省略され、
警告メッセージが出されます。
デプロイメント記述子から Web サービスを作成すると、
Web サービス・エクスプローラーまたは Universal Test Client を使用して Web サービスのメソッドのテストが可能になり、
Web サービスを UDDI Business Registry に公開することができます。