このトピックでは、JAX-RPC アプリケーション用の Web サービス記述言語 (WSDL) ファイルの開発方法について説明します。
このタスクについて
Web サービスを使用するには、WSDL ファイルが必要です。独自の WSDL
ファイルを開発することも、E メール、ダウンロード、
または Uniform Resource Locator (URL) を通じて Web サービス・プロバイダーから WSDL ファイルを取得することもできます。この文書では、独自の WSDL
ファイルを開発することを前提とします。
WSDL ファイルを開発するには、
以下のアクションに従ってください。
プロシージャー
Start Qshell (STRQSH) コマンドを実行して、Qshell を開始します。
CLASSPATH
環境変数を、サービス・エンドポイント・インターフェース・クラスおよびその他の参照クラスのロケーション
をインクルードするように更新します。
以下に例を示します。 export -s CLASSPATH=/myapp/myclass.class:/myapp/myjar.jar
サービス・エンドポイント・インターフェース・クラスおよび参照されたクラスを、
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 を作成します。