IBM SOAP ランタイム環境を使用した Web サービス・デプロイメント記述子 (ISD) からの Web サービスの作成

ISD ファイルは、Web サービス・デプロイメント記述子です。 デプロイされた ISD ファイルにより、 クライアント側で利用できるようにしなければならないサービスに関する情報 (URI、メソッド、クラス、 シリアライザー、デシリアライザーなど) が SOAP ランタイム環境に提供されます。

前提条件:
  1. サーバーとして Apache Jakarta Tomcat サーブレット・コンテナーを使用している場合には、 それをインストールして、そのインスタンスを構成し、 WebSphere® サーバーおよび Web プロジェクトの作成の記述に従って、 それをターゲットとした Web プロジェクトを作成する必要があります。
  2. 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 から作成するには、以下の手順を実行します。

  1. J2EE パースペクティブに切り替える (「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
  2. 「プロジェクト・エクスプローラー」ビューで、Web サービスを作成するための Web プロジェクトを選択する。
  3. 「ファイル」>「新規」>「その他」の順にクリックする。 「Web サービス」を選択して、各種の Web サービス・ウィザードを表示する。 「Web サービス」ウィザードを選択する。「次へ」をクリックします。
  4. 「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 によってテストする。
  5. 「サービス・デプロイメント構成 (Service Deployment Configuration)」ページ: サーバーとクライアントのデプロイメント設定を指定する。
    1. 編集」をクリックし、 IBM® SOAP ランタイム環境を選択して、 Web サービスおよび Web サービス・クライアントを実行するためのサーバーを選択する。
    2. 作成する Web サービスに含める Web プロジェクトおよび EAR を選択する。 これらがまだ存在しない場合には、ウィザードで作成します。
    3. Web サービス・クライアントを作成するプロジェクトの タイプおよび名前を選択する。 既存のプロジェクトの名前を入力する場合、プロジェクト・タイプ・フィールドは、 その既存のプロジェクトのタイプ・フィールドと一致する必要があります。 まだ存在していないプロジェクトの名前を入力する場合は、 ウィザードでプロジェクトを作成できます。 Axis および SOAP ランタイム・クライアントでサポートされている プロジェクト・タイプは、Web プロジェクトのみである点に注意してください。 クライアントを Java、EJB、 またはアプリケーション・クライアント・プロジェクトに作成する場合、 使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
    4. 既存の EAR を選択するか、Web サービス・クライアント と、Web サービス EAR 以外の別の EAR とを関連付ける固有の名前を入力する。 注: Web サービスと Web サービス・クライアントについて異なる EAR を 選択すると、実行時エラーの発生頻度は減りますが、 より多くのシステム・リソースを使用します。
  6. 「Web サービス ISD 選択」ページ: Web サービスの作成元の ISD ファイルの名前を入力する。
  7. 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、 生成した Web サービスに対するテスト機能を選択する。 これにより、Web サービス・エクスプローラーでその Web サービスが開きます。 テストするオペレーションを選択し、必要な情報を入力して「実行 (Go)」をクリックする。「状況」ペインに結果が表示されます。 「次へ」をクリックします。
  8. 「Web サービス・バインディング・プロキシー生成」パネル: プロキシーの生成を選択した場合、 バインディングとプロキシーのオプションを選択する。
  9. 「Web サービス・クライアントのテスト (Web Service Client Test)」ページ: このページを使用して、次のオプションを選択する。
    • テスト機能を選択する。 生成したプロキシーを Universal Test Client または Web サービス・エクスプローラーでテストするか、 またはサンプル Web サービス JSP を生成することができます。
    • JSP を使用してプロキシーをテストする方法を選択した場合、JSP を配置するフォルダーを選択し、JSP に組み込むメソッドを選択できます。
    • 「サーバーでテストを実行 (Run test on server)」 を選択して、サーバーが自動的に開始されるようにする。
  10. 「Web サービスの公開」ページ: この Web サービスを UDDI レジストリーに公開するかどうかを選択する。 「完了」をクリックします。 
Web サービスを作成すると、選択したオプションに応じて、次の状態になります。

注: サポートされない型 (配列、インデックス・プロパティー、 コレクションなど) がメソッドに含まれている場合は、メソッドはサンプル・アプリケーションから省略され、 警告メッセージが出されます。

デプロイメント記述子から Web サービスを作成すると、 Web サービス・エクスプローラーまたは Universal Test Client を使用して Web サービスのメソッドのテストが可能になり、 Web サービスを UDDI Business Registry に公開することができます。

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.