endptEnabler コマンドを使用した Web サービスに対する EAR ファイルの使用可能化

endptEnabler コマンド行ツールを使用して、Web サービス を含む Enterprise JavaBeans (EJB) モジュールでエンタープライズ・アーカイブ (EAR) ファイルを使用可能にし、さらに SOAP over Java™ Message Service (JMS) または SOAP over HTTP を使用して Web サービスを公開するかどうかを指定します。

このタスクについて

endptEnabler コマンド行ツールは、EAR ファイル内の Java API for XML Web Services (JAX-WS) または Java API for XML-based RPC (JAX-RPC) ベースの Web サービス対応 エンタープライズ Bean Java アーカイブ (JAR) モジュールごとに、1 つまたは複数のルーター・モジュールをその EAR ファイルに追加します。ルーター・モジュールは、特定の エンタープライズ Bean JAR モジュールの Web サービスのエンドポイントを提供します。

各ルーター・モジュールは、特定のトランスポート、例えば HTTP や JMS に対応しています。 HTTP ルーター・モジュールは、特定の エンタープライズ Bean JAR モジュール 内に含まれている各 Web サービスに HTTP エンドポイントを提供する、Web アプリケーション・アーカイブ (WAR) モジュールです。同様に、JMS ルーター・モジュールは、Web サービス・エンドポイントを対象にする要求のメッセージ・リスナーとして機能する Message Driven Bean (MDB) を含む、エンタープライズ Bean JAR モジュールです。

EAR ファイルに エンタープライズ Bean JAR モジュールがない場合は、 このツールを使用する必要はありません。

手順

  1. [IBM i]app_server_root/bin ディレクトリーから Qshell コマンド行で endptEnabler スクリプトを起動します。[AIX Solaris HP-UX Linux Windows][z/OS]install_root/bin ディレクトリーから endptEnabler コマンドを呼び出します。
  2. プロンプトが表示されたら、EAR ファイル名を入力します。
  3. endptEnabler コマンドで要求されたら、各種入力値を入力します。 EAR ファイル内の Web サービス対応の各 エンタープライズ Bean JAR モジュールに対して、さまざまな入力値を求めるプロンプトが表示されます。通常、各プロンプトでデフォルトの値を使用してください。このコマンドのプロパティーに関しては、endptEnabler コマンドの資料を参照してください。
    1. EJB ベースの Web サービスをトランスポートする HTTP ルーター・モジュールを指定します。 -transport http オプションを使用して、Web サービスが HTTP を使用して使用可能なことを示します。JAX-WS Web サービスまたは JAX-RPC Web サービスのいずれかを含む エンタープライズ Bean JAR ファイルごとに、ルーター・モジュールが 1 つ作成されます。
    2. EJB ベースの Web サービスをトランスポートする JMS ルーター・モジュールを指定します。 -transport jms オプションを使用して、Web サービスが JMS を使用して使用可能なことを示します。JAX-WS Web サービスまたは JAX-RPC Web サービスのいずれかを含む エンタープライズ Bean JAR ファイルごとに、ルーター・モジュールが 1 つ作成されます。

タスクの結果

HTTP または JMS のルーター・モジュールが、Web サービス・エンドポイントを含む EAR ファイル内の エンタープライズ Bean JAR モジュールごとに EAR ファイルに追加されます。HTTP の場合、Web アドレスを使用して Web サービスを呼び出すことができるように、コンテキスト・ルートがアプリケーション用に構成されます。Web サービスを呼び出す場合に使用する Web アドレスは、以下のとおりです。
http://host[:port]/<context-root>/services/<port-component-name>

Web サービス・エンタープライズ Bean JAR ファイルと同じターゲットに、endptEnabler コマンドを使用して生成した HTTP ルーター・モジュールまたは Java Message Service (JMS) ルーター・モジュールをインストールしてください。この HTTP ルーター・モジュールまたは JMS ルーター・モジュールは Web サービス・アプリケーションに組み込まれます。これらのモジュールでは、アプリケーション・サーバーのランタイム・ライブラリーを使用する必要があります。

次のタスク

EAR ファイルをアプリケーション・サーバーにデプロイします。デプロイメントでは、Web サービスに対応するアセンブルされた EAR ファイルが必要となります。

Web サービス要求のトランスポートに JMS を使用している場合は、アプリケーションをインストールする前に、キュー、トピック、接続ファクトリーなどの、そのアプリケーションで使用する各種 JMS オブジェクトを定義します。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_endptenablerendpt
ファイル名:twbs_endptenablerendpt.html