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 プロジェクトのフォルダーにインポートします。
- ボトムアップのサービスを作成する場合は、Java Bean を
src フォルダーに作成またはインポートします。
- トップダウンのサービスを作成する場合は、WSDL ファイルを見つけるか作成、または作成したプロジェクトにこれをインポートします。
このタスクについて
Web サービスを作成するには、サービスの Ant プロパティー・ファイルを変更します。Ant プロパティー・ファイルの名前は、作成する Web サービスのタイプによって異なります。
- ボトムアップのサービスを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_bujava.properties です。
- トップダウンのサービスを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_tdjava.properties です。
- クライアントを作成する場合の Ant プロパティー・ファイルの名前は、
was_jaxws_client.properties です。
手順
以下の 2 つのどちらかの方法で Ant タスクを実行します。- タスクを製品ワークスペースで実行する場合:
- インポートされた Web サービスの生成 XML ファイルを右クリックして、を選択します。
- ダイアログ・ボックスで「JRE」タブをクリックして、「ワークスペースと同じ
JRE で実行」を選択します。
- 「適用」をクリックして、「実行」をクリックします。
- タスクをコマンド行で実行する場合:
- タスクを実行する前に、ワークスペースを閉じます。
- 以下をコマンド行に入力します。
- Windows: wsant.bat workspace_path wsgen_path
- Linux: wsant.sh workspace_path wsgen_path
ここで、workspace_path はワークスペースへの完全修飾パス、wsgen_path は Web サービス生成ファイルがインポートされたロケーションへの完全修飾パスです。 例えば、コマンドは次
のようになります。 wsant.bat D:¥RationalAppDeveloper¥workspace1 D:¥RationalAppDeveloper¥workspace1¥TestProj¥wsgenTemplates¥was_jaxws_tdjava.xml
Web サービスが生成されると、コンソールまたはコマンド行に
ビルドの成功 メッセージが表示されます。
タスクの結果
Web サービスが生成されると、選択したオプションおよび生成された Web サービスのタイプに応じて、以下のファイルが作成されます。
- トップダウン: サービス・エンドポイント・インターフェース (SEI)。SEI は、Web サービス用 WSDL ファイルの注釈付き Java 表現です。このインターフェースは、JavaBeans エンドポイントの実装や動的プロキシー・クライアント・インスタンスの作成に使用します。SEI 内のデータ型参照
- ボトムアップ: 委譲クラス。これは、Java Bean、およびランタイムで Web サービスとして認識される JAX-WS 注釈 Bean から生成されるすべてのメソッドを含むラッパーです。Ant タスクを実行する前に @javax.jws.WebService 注釈付きの Bean が既に存在している場合、その Bean がそのまま使用され、新しい注釈が追加されないことに注意してください。
- 要求/応答/例外ラッパー・クラス
ヒント: wsant.bat ファイルは、製品の bin ディレクトリーにインストールされます。システムによっては、このディレクトリーが読み取り専用になっている場合があります。この場合、Ant タスクは出力を作成できず、Web サービスの作成は失敗します。以下の 2 とおりの訂正方法があります。
- bin フォルダーを指すように PATH を設定してから、書き込み許可を持っているディレクトリーに切り替え、そのディレクトリーからスクリプトを実行します。
- wsant.bat ファイルを書き込み可能なディレクトリーにコピーします。