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 を使用します。 一方 EJB2WebService13 コマンドを使用する場合は、J2EE 1.3 を使用します。 J2EE 1.3 を使用するための Web サービスを作成する場合は、下のコマンドの EJB2WebServiceEJB2WebService13 に置き換えて使用します。

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, 2004. All Rights Reserved. (C) Copyright IBM Japan 2005