JAX-RPC Web サービス用の WSDL ファイルからの EJB 実装テンプレートおよびバインディングの作成

JAX-RPC アプリケーション用 Web サービス記述言語 (WSDL) ファイルから Enterprise JavaBeans (EJB) 実装デプロイメント記述子のテンプレートおよびバインディングを作成できます。

始める前に

Java™ API for XML-based RPC (JAX-RPC) Web サービス用 WSDL ファイルから EJB 実装テンプレートおよびバインディングを作成するには、使用する 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 のようになります。

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

このタスクについて

このタスクは、エンタープライズ Bean から Web サービスを開発する場合に必要なステップの 1 つです。

実装テンプレートを生成するには、WSDL2Java コマンド の -role develop-server オプションを使用します。

EJB 実装の以下のコンポーネントに対するテンプレートが生成されます。
  • エンタープライズ Bean
  • EJB リモート・インターフェース
  • EJB ホーム
また、WSDL2Java コマンドはバインディングおよびデプロイメント記述子も生成します。

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

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

手順

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

タスクの結果

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

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

次のタスク

EJB 実装を完了します。EJB 実装を完了すると、 EJB およびサポートされているクラスを含む EJB Java アーカイブ (JAR) ファイル が WSDL ファイルから作成されます。

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



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