IBM WebSphere JAX-RPC ランタイム環境を 使用した Java Bean からの Web サービスの作成

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

IBM® WebSphere JAX-RPC ランタイム環境を使用して Bean から Web サービスを作成する手順は、次のとおりです。

  1. J2EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」>「J2EE」)。
  2. 「プロジェクト・エクスプローラー」ビューで、 ご使用の Web プロジェクトのソース・フォルダーに作成またはインポートした Bean を選択します。
  3. 「ファイル」>「新規」>「その他」の順にクリックします。「Web サービス」を選択して、各種の Web サービス・ウィザードを表示します。 「Web サービス」ウィザードを選択します。「次へ」をクリックします。
  4. 「Web サービス」ページ: Web サービス・タイプとして「Bottom up Java bean Web service」を 選択します。 次の操作を実行するオプションもあります。
    1. スライダーを使用して完了させたい Web サービス開発のステージを選択します。
      • 開発: Web サービスの WSDL 定義および実装を開発します。 これには、生成されたコード、WSDL ファイル、デプロイメント記述子、および Java ファイル (該当する場合) が入るモジュールの作成などのタスクが含まれます。
      • アセンブル: これにより、Web サービスまたはクライアントをホストするプロジェクトが、ターゲット・アプリケーション・サーバーによって要求されたときに EAR に関連付けられるようになります。
      • デプロイ: これにより、サービスのデプロイメント・コードが作成されるようになります。
      • インストール: これにより、Web モジュールと EAR がターゲット・サーバーにインストールされ、構成されます。 WSDL ファイルのエンドポイントに対する変更が必要な場合、このステージで変更が行われます。
      • 始動: これにより、サービスがサーバーにインストールされると、サーバーが始動するようになります。
      • テスト: これにより、Web Service Explorer またはサンプル JSP の使用などの、サービスをテストするためのさまざまなオプションが提供されます。
    2. サーバーの選択: デフォルト・サーバーが表示されます。 サービスを別のサーバーにデプロイしたい場合には、リンクをクリックして別のサーバーを指定してください。
    3. ランタイムの選択: デフォルトのランタイムが表示されます。 サービスを別のランタイムにデプロイしたい場合には、リンクをクリックして別のランタイムを指定してください。
    4. サービス・プロジェクトの選択: ワークスペースで選択されたプロジェクトが表示されます。 別のプロジェクトと EAR を選択するためには、プロジェクト・リンクをクリックしてください。 クライアント Web プロジェクトとして選択したプロジェクトが、サービス Web プロジェクトとは異なること、またはクライアントが生成した成果物によってサービスが上書きされるようになっていることを確認します。
    5. クライアントを作成したい場合には、生成したいプロキシーのタイプを選択し、クライアントについて上記のステップを繰り返します。
    6. Web サービスの公開: Web サービス・エクスプローラーを起動して、Web サービスを UDDI レジストリーに公開します。
    7. Web サービスのモニター: Web サービス・トラフィックを TCP/IP モニターを介して送信します。これにより、Web サービスによって生成される SOAP トラフィックを監視し、このトラフィックが WS-I に準拠しているかどうかをテストできます。 あるいは、『TCP/IP モニターを使用した Web サービスのテスト (Using the TCP/IP Monitor to test Web services)』で説明されているように、TCP/IP モニターを手動でセットアップすることができます。
  5. 「Service Endpoint Interface Selection」ページ:
    • サービス・エンドポイント・インターフェース (SEI) をウィザードに生成させるのではなく、既存の SEI を使用することができます。
    • サービス・デプロイの有効範囲を設定します。これは、サーバーのインプリメンテーションをデプロイする方法を示しています。 アプリケーションは、すべての要求についてインプリメンテーション・クラスの 1 つのインスタンスを使用します。 要求により、それぞれの要求ごとにインプリメンテーション・クラスの新規インスタンスが作成されます。 セッションにより、それぞれのセッションごとにインプリメンテーション・クラスの新規インスタンスが作成されます。
    • SOAP アクションを設定します。このオプションは、生成された WSDL の「soapAction」フィールドの設定に使用されます。デフォルトでは、「soapAction」フィールドはデプロイメント情報に基づいて設定されます。 「なし」を指定すると、「soapAction」フィールドは二重引用符 ("") に設定されます。「Operation」を指定すると、「soapAction」フィールドにはオペレーション名が設定されます。
    • WSDL 1.1 標準を使用して MIME 型を排他的にマップすることも選択できます。 MIME 型が WSDL 1.1 標準に合わせてマップできない場合は (例えば、添付ファイルが 配列または Java Bean プロパティーである場合)、このコマンドは失敗します。
  6. Web サービス Java Bean の識別ページ:
    • WSDL ポート名または WSDL ファイル名を変更します。
    • 公開するメソッドを選択します。
    • Set the void return - このフィールドは、Web サービスからの応答が予想されるかどうかを記述する void の戻り型がある Web サービス・メソッドで使用されます。 Oneway: この引数は、JMS トランスポートの場合のデフォルトです。 Twoway: この引数は HTTP トランスポートの場合のデフォルトです。
    • エンコード・スタイルを選択します。これにより、WSDL ファイルに生成されるスタイルおよび使用の組み合わせが指定されます。 この組み合わせは、エンコードされた RPC、RPC リテラル、または文書リテラルです。 文書/リテラルのみが WS-I に準拠しています。
    • セキュリティー・オプションを選択します。セキュリティーは WS-I に準拠していません。
    • パッケージからネーム・スペースへのマッピングをカスタマイズするかどうかを選択します。
    • エクストラ・クラスと停止クラスを指定します。エクストラでは、WSDL ファイルに示されているその他のクラスを指定します。 -stopClasses 引数を使用して、 検索を停止させるその他のクラスを定義することができます。
  7. 「名前空間マッピングへの Web サービス・パッケージ (Web Service Package to Namespace Mappings)」ページ: Web サービス・ウィザードは、指定された Java Bean から WSDL ファイルを生成します。デフォルトでは、Java Bean のパッケージ名に基づいて名前空間を作成します。このデフォルトの動作を無効にするには、WSDL ファイルに生成される独自の名前空間を指定してください。直前のページで 「Define custom mapping for package to namespace」を選択した場合は、 このページで「追加」をクリックして、カスタム・マッピングのペアを入力することができます。 あるいは、「インポート」をクリックして、.properties ファイルから カスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 package=namespace というフォーマットでなければなりません。
  8. 「Extra and Stop Classes Configuration」ページ:「Specify extra and stop classes」を 選択すると、このページにエクストラ・クラスと停止クラスをインポートできます。 エクストラでは、WSDL ファイルに示されているその他のクラスを指定します。 -stopClasses 引数を使用して、 検索を停止させるその他のクラスを定義することができます。
  9. 「Web サービスのテスト」ページ: Web サービスのテストを選択した場合、 生成した Web サービスに対するテスト機能を選択します。これにより、Web サービス・エクスプローラーでその Web サービスが開きます。 テストするオペレーションを選択し、必要な情報を入力して「Go」をクリックします。「状況」ペインに結果が表示されます。 「次へ」をクリックします。
  10. 「Web Service Proxy」ページ: プロキシーの生成を選択した場合は、 プロキシー・セキュリティー・オプションを選択し、パッケージからネーム・スペースへのマッピングを カスタマイズするかどうかを選択します。
  11. 「Web Service client package to namespace mapping」ページ: 直前のページで 「Define custom mapping for package to namespace」を選択した場合は、 このページで「追加」をクリックして、カスタム・マッピングのペアを入力することができます。 あるいは、「インポート」をクリックして、.properties ファイルから カスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 package=namespace というフォーマットでなければなりません。 データ・バインディングを 使用不可に設定して、WSDL から Java を 生成するときに SOAP 要素を使用することもできます。
  12. Web サービス・クライアント・テスト・ページ:
    • テスト機能を選択します。 生成したプロキシーを Universal Test Client または Web サービス・エクスプローラーでテストするか、 またはサンプル Web サービス JSP を生成することができます。
    • JSP を使用してプロキシーをテストする方法を選択した場合、JSP を配置するフォルダーを選択し、JSP に組み込むメソッドを選択できます。
    • 「サーバーでテストを実行」を選択して、サーバーが自動的に開始されるようにします。
  13. 「Web サービスの公開」ページ: この Web サービスを UDDI レジストリーに公開するかどうかを選択します。 「終了」をクリックします。
Web サービスを作成すると、選択したオプションに応じて、次の状態になります。
関連概念
Web サービス開発
Web サービス・ランタイム環境
関連タスク
Web サービスの開発
Web サービス・エクスプローラーの使用
関連参照
WSDL 文書
フィードバック