WebSphere JAX-RPC ランタイム環境を 使用した WSDL 文書からの Java Bean スケルトンの作成

「Web サービス (Web Service)」ウィザードを使用すると、既存の WSDL 文書からスケルトン Bean が簡単に作成できます。 スケルトン Bean には、WSDL 文書で説明するオペレーションに対応する一連のメソッドが含まれています。 Bean が作成されると、各メソッドには、Bean の編集をすることによって置き換えられる、単純な実装ができます。
前提条件:
WebSphere JAX-RPC ランタイム環境を使用してスケルトン Java™ Bean を WSDL 文書から作成する方法:
  1. J2EE パースペクティブに切り替えます (「ウィンドウ」>「パースペクティブを開く」 > 「J2EE」)。
  2. 「プロジェクト・エクスプローラー」ビューで、スケルトン Bean Web サービスを 作成するための Web プロジェクトを選択し、作成またはインポートした WSDL ファイルを 選択します。
  3. 「ファイル」>「新規」>「その他」の順にクリックします。「Web サービス」を選択して、各種の Web サービス・ウィザードを表示します。 「Web サービス」ウィザードを選択します。「次へ」をクリックします。
  4. 「Web サービス」ページ: Web サービス・タイプとして「Top down 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. 「Web サービス・スケルトン Java Bean 構成」ページ:
    • Skeleton folder: 作成する Java Bean スケルトンのロケーションを入力します。
    • サービス・デプロイの有効範囲を設定します。これは、サーバーのインプリメンテーションをデプロイする方法を示しています。 アプリケーションは、すべての要求についてインプリメンテーション・クラスの 1 つのインスタンスを使用します。 要求により、それぞれの要求ごとにインプリメンテーション・クラスの新規インスタンスが作成されます。 セッションにより、それぞれのセッションごとにインプリメンテーション・クラスの新規インスタンスが作成されます。
    • オプションで、この Web サービスでセキュリティーを使用可能にするかどうかを 選択できます。セキュリティーは WS-I には 準拠していません。
    • 「Define custom mapping for namespace to package」: パッケージとネーム・ スペース間のマッピングを確認または編集する場合は、このチェック・ボックスを選択します。
  6. 「パッケージ・マッピングへの Web サービス名前空間 (Web Service Namespace to Package Mappings)」ページ: Web サービス・ウィザードは、 指定された WSDL から多数の Java ファイルを生成します。デフォルトでは、WSDL ファイルに指定された名前空間に基づいてパッケージ名を作成します。このデフォルトの動作を無効にするには、WSDL ファイル内のいくつか、またはすべての名前空間に独自のパッケージ名を指定してください。前ページで 「Define custom mapping for namespace to package」を選択した場合は、 このページで「追加」をクリックして、カスタム・マッピングのペアを 入力することができます。 あるいは、「インポート」をクリックして、.properties ファイルから カスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 namespace=package というフォーマットでなければなりません。
  7. 「Web Service Proxy」ページ: プロキシーの生成を選択すると、 このページにプロキシーのオプションが表示されます。ここにはプロキシーが生成されるフォルダーがリストされるので、オプションで、 プロキシーのセキュリティーを使用可能にしたり、ネーム・スペースとパッケージ間のカスタム・マッピングを 作成したりすることができます。
  8. 「Web Service client namespace to package mapping」ページ: 直前のページで 「Define custom mapping for namespace to package」を選択した場合は、 このページで「追加」をクリックして、カスタム・マッピングのペアを入力することができます。 あるいは、「インポート」をクリックして、.properties ファイルから カスタム・マッピングのペアをインポートすることもできます。プロパティー・ファイルの内容は、 namespace=package というフォーマットでなければなりません。
  9. 「Web サービスの公開 (Web Service Publication)」ページ: Web サービスを UDDI レジストリーに公開することを選択した場合は、このページを使用して Web サービス・エクスプローラーを起動し、Web サービスの公開先の UDDI レジストリーを選択します。 「終了」をクリックします。
Web サービスを作成すると、選択したオプションに応じて、次の状態になります。
関連概念
Web サービス開発
Web サービス・ランタイム環境
関連タスク
Web サービスの開発
Web サービス・エクスプローラーの使用
フィードバック