JAX-RPC ベースの Web サービスに対応する Enterprise JavaBeans (EJB) 実装用の
デプロイメント記述子テンプレートを作成できます。
始める前に
重要: WebSphere Application Server Version
6.1 Feature Pack for Web Services は、本製品の機能を拡張して、Java API for XML-Based Web Services (JAX-WS) 2.0 の
プログラミング・モデルを導入できるようにします。
JAX-WS は、次世代の Web サービス・プログラミング・モデルであり、
Java API for XML-based RPC (JAX-RPC) プログラミング・モデルが提供する
基盤を提供します。戦略的 JAX-WS プログラミング・モデルを使用すると、
標準ベースの注釈モデルのサポートによって、Web サービスおよび Web クライアントの開発が
容易になります。
JAX-RPC プログラミング・モデルとアプリケーションは
引き続きサポートされますが、Web サービス・アプリケーションおよびクライアントを
新規に開発する場合は、
実装が容易な JAX-WS プログラミング・モデルをご利用ください。
サポートされる構成: Feature Pack for Web Services が
サポートするのは、JAX-WS の Web サービス・アプリケーションの Web コンテナー
内での、JavaBeans エンドポイントのホスティングのみです。
Web サービスとしてホストされるエンタープライズ Bean を開発するには、
JAX-RPC プログラミング・モデルを使用する必要があります。sptcfg
サービス・エンドポイント・インターフェースおよび Web サービス記述言語 (WSDL) ファイルは、テンプレートを作成する
ために必要となる成果物であるため、デプロイメント記述子テンプレートを開発する
場合は、その前に
サービス・エンドポイント・インターフェースを
作成し、
WSDL ファイルを作成する必要
があります。
このタスクについて
このタスクを完了すると、サービス・インプリメンテーションを Enterprise JavaBeans (EJB) に
マップする方法について記述されているデプロイメント記述子テンプレートが作成されます。
このタスクは、Enterprise Bean から Web サービスを開発する場合に必要となるステップです。
WSDL ファイルからデプロイメント記述子テンプレートを作成するには、使用する WSDL ファイルの Uniform Resource Locator (URL) を取得する必要があります。
WSDL ファイルがローカル・ファイルである場合、URL は file:drive:¥path¥file_name.wsdl のようになります。
WSDL ファイルがローカル・ファイルである場合、URL は file:/path/file_name.wsdl のようになります。
また、絶対または相対ファイル・システム・パスを使用してローカル・ファイルを指定することもできます。
Web サービス・インプリメンテーションが EJB モジュール内に Enterprise Bean を含む場合は、webservices.xml、ibm-webservices-bnd.xmi、および ibm-webservices-ext.xmi のデプロイメント記述子、および Java API for XML-based remote procedure call (JAX-RPC) のマッピング・ファイルが META-INF サブディレクトリーに生成されます。
このタスクのセクションで提供されている以下のステップに従って、デプロイメント記述子テンプレートを作成します。
プロシージャー
WSDL2Java -verbose -role develop-server -container ejb
-genJava no wsdlURL コマンドを実行して、サーバー・デプロイメント記述子テンプレートおよびマッピング・ファイルを META-INF サブディレクトリーに生成します。
-verbose オプションを指定すると、生成されたすべての
ファイルのリストがコマンドを実行したときに表示されます。
結果
Web サービスをインプリメントする場合に必要となるデプロイメント記述子テンプレートが作成されます。
例
以下の例では、
AddressBookJ2WE.wsdl WSDL ファイルが使用されています。
- 以下のコマンド構文を使用して、テンプレート・ファイルを生成します。
WSDL2Java -verbose -role develop-server -container ejb -genJava no AddressBookJ2WE.wsdl
以下のように、デプロイメント記述子テンプレートが META-INF サブディレクトリーに生成されます。Parsing XML file: AddressBookJ2WE.wsdl
Generating: META-INF¥webservices.xml
Generating: META-INF¥ibm-webservices-bnd.xmi
Generating: META-INF¥ibm-webservices-ext.xmi
Generating: META-INF¥AddressBookJ2WE_mapping.xml
次の作業
Enterprise Bean から Web サービスを開発する場合に必要となるステップを継続します。
次のステップは、
EJB インプリメンテーションの完了です。
EJB インプリメンテーションを完了する場合は、Enterprise Bean、および
WSDL ファイルから作成されるサポートされているクラスを含む Enterprise Bean Java アーカイブ (JAR) ファイルをアセンブルします。