EJB2WebService ツールを使用した Web サービスの作成

コマンド行から EJB2WebService ツールを使用することで、IBM® WebSphere® ランタイム環境を使用してステートレス・セッション EJB Bean から Web サービスを生成できます。注: EJB2WebService13 コマンドは EJB v2.0 と J2EE 1.3 をサポートし、EJB2WebService コマンドは EJB 2.1 と J2EE 1.4 をサポートします。

コマンド行のセットアップ

EJB2WebService ツールを使用する前に、次の方法で Web サービスのコマンド行をセットアップする必要があります。

  1. コマンド・プロンプトから、Rational® Developer 製品の bin ディレクトリーに移動する。
  2. 次のバッチ・スクリプトを実行する。
    • Windows®:

      setupenv.bat

    • Linux:

      . setupenv.sh  

  3. Web サービスを作成するディレクトリーに移動する。このディレクトリーをコマンド行テスト・ディレクトリーと呼びます。  Linux: このディレクトリーに対する書き込みアクセスが必要です。

これで、EJB2WebService ツールを使用して、エクスポートした EAR ファイルを含む Web サービスを作成できます。

Web サービスの作成

注: EJB2WebService ツールには、2 つのバージョンがあります。EJB2WebService コマンドを使用すると、このコマンドは J2EE 1.4 を使用します。このほかに、J2EE 1.3 を使用する EJB2WebService13 コマンドを使用することができます。以下のコマンドでは、J2EE 1.3 を使用する Web サービスを作成したい場合に、EJB2WebService の代わりに EJB2WebService13 を使用することができます。

EJB2WebService ツールを使用して Web サービスを作成するには、コマンド・プロンプトに次のように入力します。

注: <EJB.ear> は必ず最後の引数として指定してください。 オプショナル引数および必須引数のリストについては、『EJB2WebService ツール』を参照してください。

ヒント:
  • オプションの引数 -host <hostname:port> を指定することをお勧めします。このコマンドのデフォルト・ポートは 6080 ですが、デフォルトの WebSphere Application Server ポートは 9080 です。
  • -project に指定したコマンド行テスト・ディレクトリーのパスおよびその名前をメモしておいてください。この情報は、Web サービスをデプロイおよびテストするときに必要です。

これは、EJB2WebService ツールの使用方法を示す例です。

EJB2WebService -host localhost:9080 -ri MyEJB.remoteInterface -project MyEJBProject MyEJB.ear

EJB2WebService ツールの主な出力は、生成したディレクトリー構造のルートにある <ProjectName>EAR.ear という元の EAR ファイルの変更後のバージョンです。META-INF ディレクトリーも <ProjectName> の下に生成されます。このディレクトリーには、生成した WSDL ファイルや Java™ クラスなどが保持されます。-server-side-only 引数を指定しない場合、追加の Java ファイル (複合タイプのシリアライザーおよびデシリアライザー・クラスなど) を含むクライアント・サイド・ディレクトリーも作成されます。

EAR ファイルの生成後、ほかのユーザーが使用できるようにこのファイルをサーバーにデプロイできます。

重要: -splitWsdl 引数を使用するように選択すると、EAR ファイルが生成されますが、これがワークスペースにインポートされて、単体テスト環境またはリモート・サーバーにデプロイされると、サーバー開始中に例外が発生します。この例外は、ルーターの Web プロジェクトでの WSDL の欠落が原因です。このエラーを避けるには、以下のいずれかを行ってください。
  • 管理者コンソールを使用してスタンドアロンの WebSphere Application Server にデプロイする。
  • モノリシック WSDL を使用する。つまり、-splitWsdl 引数を使用しない。
  • EJB プロジェクトの META-INF/wsdl ディレクトリーの下にあるすべての WSDL ファイルを手動でルーター Web プロジェクトの WEB-INF/wsdl にコピーする。
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.