このトピックでは、JAX-RPC アプリケーション用の Web サービス記述言語 (WSDL) ファイルの開発方法について説明します。
このタスクについて
Web サービスを使用するには、WSDL ファイルが必要です。独自の WSDL
ファイルを開発することも、E メール、ダウンロード、
または Uniform Resource Locator (URL) を通じて Web サービス・プロバイダーから WSDL ファイルを取得することもできます。この文書では、独自の WSDL
ファイルを開発することを前提とします。
WSDL ファイルを開発するには、
以下のアクションに従ってください。
プロシージャー
- サービス・エンドポイント・インターフェース・クラスおよび参照されたクラスを、
CLASSPATH 変数に構成します。
- Windows システムでは、
CLASSPATH="%CLASSPATH%;<list your application Java archive (JAR) files and classes>" を設定します。
- UNIX および Linux システムでは、
CLASSPATH="$CLASSPATH:<list your application JAR files and classes>" をエクスポートします。
- Java2WSDL seiInterface コマンドを実行します。 seiInterface.wsdl という名前の WSDL ファイルが作成されます。
- Enterprise JavaBeans (EJB) を使用する場合は、
WSDL ファイルを META-INF/wsdl サブディレクトリーに移動します。
- JavaBeans を使用する場合は、WSDL ファイルを WEB-INF/wsdl サブディレクトリーに移動します。
- 生成された WSDL ファイルを編集し、パート名を検査します。
WSDL パートには arg_0_0 などの名前があります。Java パラメーターの実際の名前を使用するように
WSDL ファイルを変更します。
- (オプション) Java2WSDL コマンド・ツールを使用して WSDL ファイルの正しいパート名を生成します。
Java2WSDL コマンド・ツールを使用して正しいパート名を自動的に生成し、
設定することができます。パート名の生成と設定は、サービス・エンドポイント・インターフェースと同じメソッドをインプリメントし、
デバッグ情報を有効にしてコンパイルされている Java インプリメンテーション・クラスの形式で、
Java2WSDL コマンド・ツールに追加情報を指定して実行します。
パラメーター名はデバッグ情報とともに .class ファイルに格納されます。
インプリメンテーション・クラスがデバッグを有効にしてコンパイルされている場合、
Java2WSDL -implClass seiImpl seiInterface コマンドを使用して、
正しいパート名を持つ WSDL ファイルを生成することができます。
結果
サービス・エンドポイント・インターフェースによって記述される Web サービスを定義する
WSDL ファイルが作成されました。
例
この例では、JAR ファイル名 AddressBook.jar が使用され、
そこに、AddressBook.class クラス・ファイルというクラスが含まれています。
WSDL ファイルを作成するには、AddressBook.jar ファイルを CLASSPATH
に追加する必要があります。JAR ファイルには、
デバッグ情報を有効にしてコンパイルされた EJB インプリメンテーション・クラスが含まれます。
Java2WSDL -implClass addr.AddressBookBean addr.AddressBook コマンドを実行して、
ファイル AddressBook.wsdl を作成します。