Web サービス・ウィザードの代わりに Ant タスクを使用して、IBM® WebSphere® JAX-WS ランタイム環境の Java™ Web サービスを生成することができます。Ant タスクでは、ボトムアップとトップダウンの両方の
Web サービス開発がサポートされます。
始める前に
Web サービスを作成する前に、以下の前提条件の手順を完了する必要があります。
- Web サービス用に、サーバーおよび Web プロジェクトを作成します (JAX-WS 対応 WebSphere サーバーの作成を参照)。
- Ant タスクおよびプロパティー・ファイルをワークスペースにインポートします (JAX-WS Web サービス用の Ant ファイルのインポートを参照)。
- Web サービス用の Ant プロパティー・ファイルをカスタマイズします (以下を参照)。
- 作成する Web サービスのタイプに応じて、作成した Web プロジェクトのフォルダーにファイルを作成またはインポートします。
- ボトムアップのサービスを作成する場合は、Bean を
src フォルダーに作成またはインポートします。
- トップダウンのサービスを作成する場合は、WSDL ファイルを見つけるか作成、または作成したプロジェクトにこれをインポートします。
このタスクについて
Web サービスを作成するには、サービスの Ant プロパティー・ファイルを変更します。Ant プロパティー・ファイルの名前は、作成する Web サービスのタイプによって異なります。
- ボトムアップのサービスを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_bujava.properties です。
- トップダウンのサービスを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_tdjava.properties です。
- クライアントを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_client.properties です。
手順
Ant タスクを実行します。 - タスクを製品ワークスペースで実行する場合:
- インポートされた Web サービスの生成 XML ファイルを右クリックして、を選択します。
- ダイアログ・ボックスで「JRE」タブをクリックして、「ワークスペースと同じ
JRE で実行」を選択します。
- 「適用」をクリックして、「実行」をクリックします。
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 ファイルを書き込み可能なディレクトリーにコピーします。