IBM SOAP ランタイム環境を使用した Enterprise Bean (EJB) からの Web サービスの作成

前提条件:

「Web サービス」ウィザードを使用すると、新規 Web サービスの作成、 そのサービスのデプロイメント用の構成、および Web サービスのサーバーへのデプロイを、簡単に行うことができます。 Web サービスをデプロイした後では、このウィザードに従うと、 クライアント・プロキシーおよびサンプル・アプリケーションを生成して、Web サービスをテストすることができます。 テストが完了したら、「エクスポート」ウィザードを使用して、 Web サービスを UDDI Business Registry に公開することができます。

EJB アプリケーション開発について詳しくは、「EJB ツール」を参照してください。

注: Rational Developer 製品は、ステートレス・セッション Enterprise Bean から Enterprise Bean Web サービスの作成をサポートしています。

ユーザーが作成する Web サービスは、Enterprise Bean に対するクライアントの働きをします。  Enterprise Bean は、「Web サービス」ウィザードを起動する前にデプロイする必要があります。

Enterprise Bean から Web サービスを作成するには、以下の手順を実行します。

  1. J2EE パースペクティブに切り替える (「ウィンドウ」 > 「パースペクティブを開く」 > 「J2EE」)。
  2. 「プロジェクト・エクスプローラー」ビューで、Web サービスを作成するための Web プロジェクトを選択する。

    あるいは、J2EE パースペクティブから「Web サービス」ウィザードを起動することもできます。  そのためには、Web サービスを作成する Enterprise Bean を選択して、以下のステップに従います。

  3. 「ファイル」 > 「新規」 > 「その他」の順にクリックする。 各種の Web サービス・ウィザードを表示するために、「Web サービス」を選択する。 「Web サービス」ウィザードを選択する。「次へ」をクリックする。
  4. 「Web サービス」ページ: 「Web サービス・タイプ」ドロップダウン・リストから「EJB Web サービス」を選択する。  以下のオプションを選択することができます。
    • Web プロジェクトで Web サービスを開始する。 このオプションを選択しない場合は、Web サービスを手動で開始する必要があります。 このオプションを選択しないと、このページの他のオプションは使用可能になりません。
    • Web サービス・エクスプローラーを起動して、Web サービスを UDDI レジストリーに公開する。
    • Web サービスに Java™ Bean クライアント・プロキシーを生成する。 生成される Java Bean クライアント・プロキシーは、 Web サービスへのリモート・プロシージャー・コール・インターフェースを提供します。
    • Web サービスをテストする。 これにより、プロキシーの生成前に Web サービス・エクスプローラーで Web サービスをテストできます。
    • Web サービス・トラフィックを TCP/IP モニターを通して送信する。 これにより、Web サービスによって生成される SOAP トラフィックを監視し、 このトラフィックが WS-I 準拠かどうかをテストできます。
  5. 「サービス・デプロイメント構成」ページ: サーバーとクライアントのデプロイメント設定を指定する。
    1. 編集」をクリックし、 IBM® SOAP ランタイム環境を選択して、Web サービスおよび Web サービス・クライアントを実行するためのサーバーを選択する。 IBM WebSphere ランタイム環境または Apache Axis 1.0 ランタイム環境を使用する場合は、該当するタスクを参照してください。
    2. Web サービスの EJB プロジェクト、ルーター・プロジェクト、 および EAR を選択する。 これらがまだ存在しない場合には、ウィザードで作成します。
    3. 作成された Web サービス・クライアントに必要なプロジェクトのタイプおよび名前を選択する。 既存のプロジェクトの名前を入力する場合、プロジェクト・タイプ・フィールドは、 その既存のプロジェクトのタイプ・フィールドと一致する必要があります。 まだ存在していないプロジェクトの名前を入力する場合は、 ウィザードでプロジェクトを作成できます。 Axis および SOAP ランタイム・クライアントでサポートされているプロジェクト・タイプは、 Web プロジェクトのみである点に注意してください。 クライアントを Java、EJB、 または Application クライアント・プロジェクトに作成する場合、 使用するクライアントに WebSphere ランタイム環境を選択する必要があります。
    4. 既存の EAR を選択するか、 Web サービス・クライアントを Web サービス EAR 以外の別の EAR に関連付ける固有の名前を入力する。 注: Web サービスと Web サービス・クライアントについて異なる EAR を選択すると、実行時エラーの発生頻度は減りますが、 より多くのシステム・リソースを使用します。
  6. 「Web サービス EJB 構成」パネル: 「EJB Bean のブラウズ」をクリックする。  これにより Enterprise Bean 用の J2EE パースペクティブを参照できるようになります。
  7. 「Enterprise Bean のブラウズ」ダイアログ・ボックスで、対象の Enterprise Bean と EJB プロジェクトが含まれるエンタープライズ・アプリケーション・プロジェクトを選択する。  次に Enterprise Bean と EJB プロジェクトを選択し、「OK」をクリックする。  JNDI プロバイダー URL、JNDI 初期コンテキスト・ファクトリー、EJB JNDI 名、 EJB ホーム・インターフェース・クラス名、EJB リモート・インターフェース・パス名などの EJB 構成は自動的に入力されます。  「次へ」をクリックする。 

    注: 「Enterprise Bean のブラウズ」ダイアログ・ボックスには、 選択された Web プロジェクトを含むエンタープライズ・アプリケーション・プロジェクトのみが表示されます。 このダイアログ・ボックスは、Web プロジェクトと同じエンタープライズ・アプリケーション・プロジェクトに含まれる Enterprise Bean と EJB プロジェクトの選択にのみ使用できます。

  8. 「Web サービス Java Bean ID」パネル: Web サービスの URI とスコープを指定する。 オプションで、静的メソッドとセキュア SOAP を使用することも選択できます。 このページにリストされた文書名とフォルダー名は変更できます。デフォルト名をそのまま使用してもかまいません。
  9. 「Web サービス Java Bean メソッド」パネル: 公開するメソッドを選択し、 入出力のエンコード・スタイルを選択する。 Java から XML へのマッピングを確認する場合は、 「サーバー・タイプ・マッピングの表示」を選択する。
  10. 「Web サービス Java から XML へのマッピング」ページ: マッピングの確認を選択した場合、ここで表示できます。 または、「カスタマイズしたマッピングの編集と使用」を選択して、マッピングをカスタマイズする。
  11. 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、 生成した Web サービスに対するテスト機能を選択し、「起動」をクリックする。 これにより、この Web サービスが Web サービス・エクスプローラーに開きます。 テストする操作を選択し、必要な情報を入力して「実行」をクリックする。 「状況」ペインに結果が表示されます。 Web サービスのテストを完了したら、ブラウザー・ウィンドウをクローズして、「次へ」をクリックする。
  12. 「Web サービス・バインディング・プロキシー生成」パネル: プロキシーの生成を選択した場合、 バインディングとプロキシーのオプションを選択する。
  13. 「Web サービス・クライアントのテスト」ページ: このページを使用して、次のオプションを選択する。
    • テスト機能を選択する。 生成したプロキシーを Universal Test Client または Web サービス・エクスプローラーでテストするか、 またはサンプル Web サービス JSP を生成することができます。
    • JSP を使用してプロキシーをテストする方法を選択した場合、JSP を配置するフォルダーを選択し、 JSP に組み込むメソッドを選択できます。
    • サーバー上でテストを実行する」を選択して、サーバーが自動的に開始されるようにする。
  14. 「Web サービスの公開」ページ: この Web サービスを UDDI レジストリーに公開するかどうかを選択する。 「終了」をクリックする。 
Web サービスを作成すると、選択したオプションに応じて、次の状態になります。

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

Enterprise Bean から Web サービスを生成すると、Universal Test Client を使用して Web サービスのメソッドのテストが可能になり、Web サービスを UDDI Business Registry に公開することができます。 アプリケーションのテストおよび公開について詳しくは、サーバー・ツールの文書を参照してください。

EJB について詳しくは、EJB アプリケーション開発の文書を参照してください。

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