Ant タスクを使用した IBM WebSphere JAX-WS ランタイム環境の Java Web サービスの作成

Web サービス・ウィザードの代わりに Ant タスクを使用して、IBM® WebSphere® JAX-WS ランタイム環境の Java™ Web サービスを生成することができます。Ant タスクでは、ボトムアップとトップダウンの両方の Web サービス開発がサポートされます。

始める前に

Web サービスを作成する前に、以下の前提条件の手順を完了する必要があります。

このタスクについて

Web サービスを作成するには、サービスの Ant プロパティー・ファイルを変更します。Ant プロパティー・ファイルの名前は、作成する Web サービスのタイプによって異なります。
  • ボトムアップのサービスを作成する場合の Ant プロパティー・ファイルの名前は、 was_jaxws_bujava.properties です。
  • トップダウンのサービスを作成する場合の Ant プロパティー・ファイルの名前は、 was_jaxws_tdjava.properties です。
  • クライアントを作成する場合の Ant プロパティー・ファイルの名前は、 was_jaxws_client.properties です。

手順

Ant タスクを実行します。
  • タスクを製品ワークスペースで実行する場合:
    1. インポートされた Web サービスの生成 XML ファイルを右クリックして、「実行」 > 「Ant ビルド」を選択します。
    2. ダイアログ・ボックスで「JRE」タブをクリックして、「ワークスペースと同じ JRE で実行」を選択します。
    3. 「適用」をクリックして、「実行」をクリックします。
Web サービスが生成されると、コンソールまたはコマンド行に ビルドの成功 メッセージが表示されます。

タスクの結果

Web サービスが生成されると、選択したオプションおよび生成された Web サービスのタイプに応じて、以下のファイルが作成されます。
  • トップダウン: サービス・エンドポイント・インターフェース (SEI)。SEI は、Web サービス用 WSDL ファイルの注釈付き Java 表現です。このインターフェースは、JavaBeans エンドポイントの実装や動的プロキシー・クライアント・インスタンスの作成に使用します。SEI 内のデータ型参照
  • ボトムアップ: 委譲クラス。このクラスは、 Bean から、およびランタイム環境が Web サービスとして認識する JAX-WS 注釈からの すべてのメソッドを含むラッパーです。Ant タスクを実行する前 に @javax.jws.WebService 注釈付きの Bean が既にある場合、 この Bean がそのまま使用され、新しい注釈は追加されません。
  • 要求/応答/例外ラッパー・クラス
ヒント: wsant.bat ファイルは、製品の bin ディレクトリーにインストールされます。 システムによっては、このディレクトリーが読み取り専用になっている場合があります。そのような場合、 Ant タスクは出力を作成できず、Web サービス作成は失敗します。この問題を修正するには、以下の 2 とおりの方法があります。
  • bin フォルダーを指すように PATH を設定し、 書き込み許可を持っているディレクトリーに切り替え、そのディレクトリーからスクリプトを実行します。
  • wsant.bat ファイルを書き込み可能なディレクトリーにコピーします。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tantjavajaxws.html