WSDL ファイルからの JAX-RPC アプリケーション用の Java 成果物の作成

WSDL2Java コマンド行ツールを使用して Java™ 実装テンプレートおよびバインディングを作成することにより、JAX-RPC アプリケーション用 Web サービス記述言語 (WSDL) ファイルから Java 成果物を作成できます。

始める前に

WSDL ファイルから JavaBeans 実装テンプレートおよびバインディングを作成するには、 WSDL ファイルの Uniform Resource Locator (URL) を取得する必要があります。

[Windows][z/OS]WSDL ファイルがローカル・ファイルである場合、URL は file:drive:¥path¥file_name.wsdl のようになります。

[Linux][AIX][HP-UX][Solaris][IBM i]WSDL ファイルがローカル・ファイルである場合、URL は file:/path/file_name.wsdl のようになります。

また、絶対または相対ファイル・システム・パスを使用してローカル・ファイルを指定することもできます。

実装テンプレートを生成するには、WSDL2Java コマンド の -role develop-server オプションを使用します。 また、WSDL2Java コマンドはバインディングおよびデプロイメント記述子も生成します。

[z/OS]WSDL2Java コマンド行ツールは、 z/OS® プラットフォームではサポートされません。この機能は、製品の z/OS バージョンで提供されるアセンブリー・ツールによって提供されます。このツールについて詳しくは、Java API for XML-based Remote Procedure Call (JAX-RPC) アプリケーションの WSDL2Java コマンド行ツールに関する資料を参照してください。

このタスクについて

適切なコマンドを実行し、WSDL ファイルから JavaBeans 実装テンプレートとバインディングを作成します。

ベスト・プラクティス ベスト・プラクティス: WSDL またはスキーマ内で絶対名前空間を使用するのがベスト・プラクティスです。デフォルトでは、WSDL2Java ツールは相対名前空間の使用を許可しません。相対名前空間は、XML Plenary Interest Group では推奨されていません。また、相対名前空間を使用すると、Canonical XML バージョン 1.0 仕様により、XML デジタル署名が失敗します。相対名前空間は、絶対名前空間に変換できます。WSDL2Java ツールでの名前空間の使用について詳しくは、JAX-RPC アプリケーションの WSDL2Java コマンドの資料を参照してください。bprac

手順

WSDL2Java -verbose -role develop-server -container web wsdlURL コマンドを実行します。 -verbose オプションが指定されているため、生成された すべてのファイルのリストが、コマンドを実行したときに表示されます。

タスクの結果

バインディング・ファイルのみでなく、Web サービスの実装で必要となる実装およびデプロイメント記述子用のテンプレートが作成されます。これらのテンプレートには、WSDL ファイルからの情報が部分的に埋めこまれています。

以下の例では、AddressBook JavaBeans 実装および AddressBook.wsdl WSDL ファイルを使用しています。WSDL2Java -verbose -role develop-server -container web AddressBook.wsdl コマンドからテンプレート・ファイルを生成 すると、以下のファイルが生成されます。
Parsing XML file:  file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Parsing XML file:  AddressBook.wsdl
WSWS3282I: Info: Generating addr¥Address.java.
WSWS3282I: Info: Generating addr¥Phone.java.
WSWS3282I: Info: Generating addr¥StateType.java.
WSWS3282I: Info: Generating addr¥AddressBook.java.
WSWS3282I: Info: Generating addr¥AddressBookSoapBindingImpl.java..
WSWS3282I: Info: Generating WEB-INF¥webservices.xml.
WSWS3282I: Info: Generating WEB-INF¥ibm-webservices-bnd.xmi.
WSWS3282I: Info: Generating WEB-INF¥AddressBook_mapping.xml.
WSWS3282I: Info: Generating WEB-INF¥ibm-webservices-ext.xmi.

AddressBookSOAPBindingImpl.java ファイルは、実装 Bean 用 のテンプレートです。このファイルは、WSDL ファイルのポートの後に指定されます。 通常、このクラスは、より分かりやすい名前にリネームされます。

次のタスク

JAX-RPC アプリケーションの JavaBeans 実装を完了します。

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devbeanbindings
ファイル名:twbs_devbeanbindings.html