JAX-RPC Web サービス・クライアント用 WSDL ファイルからのクライアント・バインディングの作成

JAX-RPC Web サービス・クライアント用 Web サービス記述言語 (WSDL) ファイルからクライアント・バインディングを作成できます。

始める前に

JAX-RPC Web サービス・アプリケーション用 WSDL ファイルからクライアント・バインディングを作成するには、使用する WSDL ファイルの Uniform Resource Locator (URL) を取得する必要があります。クライアントで Web サービスを使用するには、バインディングおよびデプロイメント記述子が必要です。

[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 コマンドの -container オプションと -role develop-client オプションを組み合わせて使用します。-container オプションは、以下のパラメーターを取ります。
  • -container client

    アプリケーション・クライアント・コンテナーにあるクライアント用のバインディングおよび デプロイメント記述子を生成します。

  • -container ejb

    Enterprise JavaBeans (EJB) モジュール内の エンタープライズ Bean であるクライアント用の、バインディング およびデプロイメント記述子を生成します。

  • -container web

    Web コンテナー内にあるクライアント用のバインディングおよびデプロイメント記述子を生成します。

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

このタスクについて

適切なコマンドを実行して、WSDL ファイルからクライアント・バインディングを作成します。

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

手順

WSDL2Java -verbose -role develop-client -container type wsdlURL コマンドを実行します。

type は、エンタープライズ EJB クライアントの場合には ejb、 JavaBeans クライアントの場合には web、 アプリケーション・クライアントの場合には client になります。

コマンド行では、以下の組み合わせを使用できます。
  • -container web
  • -container ejb
  • -container client
verbose オプションが指定されているため、生成された すべてのファイルのリストが、コマンドを実行したときに表示されます。

タスクの結果

Web サービスを使用する場合にクライアントで必要となるバインディングおよびデプロイメント記述子が生成されます。

以下の例では、AddressBook エンタープライズ Bean および AddressBook.wsdl WSDL ファイルを使用しています。 WSDL2Java -verbose -role develop-client -container client 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¥AddressBookService.java.
WSWS3282I: Info: Generating META-INF¥ibm-webservicesclient-bnd.xmi.
WSWS3282I: Info: Generating META-INF¥AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF¥ibm-webservicesclient-ext.xmi.

次のタスク

クライアント・アプリケーションを作成し、クライアント成果物をアセンブルして、 クライアント実装を完了します。

.

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



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