IBM WebSphere ランタイム環境を使用した Web サービスの作成

概説

WebSphere Application Server は、Java™ Web サービス標準を 使用します。これは、Java Community Process (JCP) に基づいて、Java 用に開発されました。この 標準とは、Java API for XML-based RPC (JAX-RPC または JSR 101 とも呼ばれます) と、Web Services for J2EE (JSR 109 および JSR 921) です。JAX-RPC は、Java で WSDL ベースの Web サービスを使用するためのプログラミング・モデルと バインディングをカバーします。Web Services for J2EE は、J2EE 環境における JAX-RPC の使用、および J2EE サーバーへの Web サービスの 実装とデプロイメントをカバーします。JAX-RPC と JSR-109 は、J2EE 1.3 リリースに適用でき、JAX-RPC と JSR-921 は、J2EE 1.4 に適用できます。

開発の成果物によって、エンタープライズ Bean または Java Bean モジュールを Web サービスにすることができます。エンタープライズ Bean または Java Bean モジュールから Web サービスを作成するには、開発時に、その JAR または WAR モジュールに次のファイルを 追加します。

Web サービス記述言語 (WSDL) XML

WSDL XML ファイルには、実装される Web サービスが記述されます。

サービス・エンドポイント・インターフェース (SEI)

SEI は、実装される Web サービス・ポート・タイプに 対応する Java インターフェースです。JAX-RPC が、WSDL 1.1 から Java への 言語マッピングを指定し、これを定義します。

webservices.xml

webservices.xml ファイルは、Web サービスの実装方法を指定する、J2EE (JSR 109) Web サービス・デプロイメント記述子です。これは、Web Services for J2EE 仕様のセクション 7.1 で定義されています。

JAX-RPC マッピング・ファイル

JAX-RPC マッピング・デプロイメント記述子は、Java 要素と WSDL 要素間で マップする方法を指定します。これは、Web Services for J2EE 仕様のセクション 7.3 で定義されています。

ibm-webservices-bnd.xmi および ibm-webservices-ext.xmi

これらのファイルには、主にセキュアな Web サービスのための、WebSphere 固有の デプロイメント情報が含まれています。

アセンブル時には、J2EE アプリケーション・クライアントが Web サービスに アクセスできるように、アプリケーション・クライアントまたは Web モジュールに 次のファイルが追加されます。

WSDL

WSDL ファイルは、Web サービスの実装者によって提供されます。

Web サービス用の Java インターフェース

Java インターフェースは、Java API for XML-based RPC (JAX-RPC) に指定されると、WSDL ファイルから生成されます。 これらのバインディングは、SEI (WSDL ポート・タイプに基づく)、またはサービス・インターフェース (WSDL サービスに基づく) です。

webservicesclient.xml

webservicesclient.xml ファイルは、J2EE 1.3 を使用して Web サービスが生成する、 クライアント・サイドのデプロイメント記述子です。ここには、アクセスされるサービスが 記述されます。これは、Web Services for J2EE 仕様のセクション 7.2 で定義されています。 J2EE 1.4 を使用して生成される Web サービスでは、webservicesclient.xml ファイルは 作成されず、代わりに、J2EE デプロイメント記述子 (web.xml ejb-jar.xml や application-client.xml など) にクライアントの記述子情報が格納されます。

ibm-webservicesclient-bnd.xmi および ibm-webservicesclient-ext.xmi

これらのファイルには、WebSphere 製品に固有のデプロイメント情報 (セキュリティー情報など) が 含まれています。WebSphere デプロイメント 記述子の詳細については、Web サービス・デプロイメント記述子の構成 (Configuring Web services deployment descriptors) を参照してください。

その他の JAX-RPC バインディング・ファイル

Simple Object Access Protocol (SOAP) と WSDL を Java に マップする際にクライアント・アプリケーションをサポートするその他の JAX-RPC バインディング・ファイルは、WSDL2Java ツールによって WSDL から 生成されます。

注: webservicesclient.xml、ibm-webservicesclient-bnd.xmi、 および ibm-webservicesclient-ext.xmi は、コンテナー管理環境で Web サービス・クライアントを実行する場合にのみ 使用され、非管理環境で Web サービス・クライアントを実行する場合には使用されません。 したがって、保護された Web サービスには、 コンテナー管理環境で稼働する Web サービス・クライアントからしかアクセスできません。 それ以外の場合は、クライアントが必要なセキュリティー情報を入手できないためです。

制限

以下のリストは、Web サービスで IBM WebSphere ランタイム環境を使用する場合の制限です。

• IBM WebSphere Web サービス・ランタイム環境は、デフォルトの Java パッケージを 使用する Java Bean を処理することができません。 その結果、サーバー始動時に例外状態となり、実行時に Web サービスが作動しなくなります。
• WebSphere ランタイム環境を使用して、Java Bean または EJB から Web サービスを作成するときには、Java プリミティブ型 (int、float、double など) で始まる パッケージ名を持つ複合型 Bean を使用しないでください。そうしないと、生成された WSDL ファイルのスキーマが複合型を Java プリミティブ型として正しく扱えない場合があります。
• WebSphere ランタイム環境は、命名法に従って 名付けられていない ID を持つ Java クラスを処理する能力に 制限があります。元の Bean から WSDL が生成されると、WSDL のオペレーション名は正しいものになります。 ただし、WebSphere が WSDL ファイルから Bean を生成した後では、Java の規則をサポートするように、 メソッド名が小文字に変更されます。 Web サービス・ウィザードは生成されたスケルトンを廃棄して、元の Bean を使用します。 これにより、Bean 名と WSDL ファイルの間で不一致が起こります。

  例えば、Bean のメソッド名が BodyMassIndex である場合には、 デプロイメント記述子のオペレーション名は bodyMassIndex となり (「b」は小文字)、 標準の Java 命名規則に従うようになります。

  以下の 2 つの解決策が考えられます。
  • 元の Bean のメソッド名を変更する。
  • デプロイメント記述子を変更して、サービスを再デプロイする。WebSphere の デプロイメント・ツールに精通されていない場合は、この解決方法はお勧めできません。
• RPC スタイルのメッセージに対しては、SOAP エンコード方式とリテラル・エンコード方式を併用することはできません。 しかし、これは、DADX が生成する一種の WSDL 文書です。 したがって、RPC を使用する DADX Web サービス用に生成された WSDL ファイルから、WebSphere クライアントを正しく作成することはできません。 この問題発生を防ぐには、DOC スタイルを使用して DADX Web サービスを作成します。WebSphere ランタイム環境は、 この WSDL からクライアントを問題なく作成できます。 DOC スタイルの DADX Web サービスを使用するには、DADX グループに対する group.properties ファイルの useDocumentStyle パラメーターを、 true に設定します。この設定は、DADX グループの構成ウィザードを使用して行うこともできます。
• Web サービスが WebSphere ランタイム環境にデプロイされた後で、Web サービスによって使用されるクラスの 1 つを変更すると、 変更が反映されず、サーバー・コンソールに ClassCastException が表示されることがあります。 この場合は「サーバー」ビューでサーバーを右クリックして、 「プロジェクトの再開」を選択してから、 クラスが変更されたプロジェクトを含む EAR を選択してください。
• WebSphere ランタイム環境を使用して Web サービス・クライアントを作成する場合、 クライアント・プロキシーの JNDI ルックアップは Universal Test Client で使用できません。 したがって、クライアントのデプロイメント記述で定義された クライアント構成 (webservicesclient.xml、ibm-webservicesclient-ext.xmi、 ibm-webservicesclient-bnd.xmi など) は選出されません。 このようなクライアント構成の例にセキュリティーがあります。 Universal Test Client の代わりに、サンプルの JSP を使用してプロキシーをテストしてください。
• RPC/リテラルで配列がサポートされない: RPC/リテラル・サービスを作成する場合、メソッド・シグニチャーはそのサービスに配列を含めることはできません。 含まれている場合は、生成したクライアント・コードでこのサービスを起動できません。 この問題に対する予備手段は現在ありません。可能であれば、文書/リテラル使用してください。注: これが 影響するのは WebSphere Application Server v5.x をターゲットとした Web サービスのみ です。WebSphere Application Server v6.x を 使用する Web サービスには影響しません。
• WSDL インポート: WSDL インポート・ステートメントは、同一ディレクトリーでは絶対 URL または相対 URL しか持つことができません。 例えば、次の形式の相対インポートはサポートされません: <import namespace="http://someNamespace/" location="../someFile.wsdl"/>
• デフォルトの JAX-RPC マッピングが 存在しない型を使用する WSDL ファイルから EJB スケルトンを生成するときに、 ユーザーが Web サービスを起動しようとすると、ランタイム例外が戻されます。 この問題は、ランタイムでの javax.xml.soap.SOAPElement のデシリアライズに障害がある点です。java.xml.soap.SOAPElement は、型に関連するマッピングがない状態で使用されるため、 文書のフラグメントとしてマップされます。注: これが 影響するのは WebSphere Application Server v5.x をターゲットとした Web サービスのみ です。WebSphere Application Server v6.x を 使用する Web サービスには影響しません。
• 入出力パラメーターが指定された操作を使用して WSDL ファイルから EJB スケルトンを生成する場合は、EJB のデプロイメント・コードの生成時にエラーが表面化します。 この問題は、入出力パラメーターが javax.xml.rpc.holders.Holder クラスにマップされる点にあります。 java.xml.rpc.holders.Holder は java.io.Serializable を実装しないため、EJB デプロイメント・エラーが起こります。注: これが 影響するのは WebSphere Application Server v5.x をターゲットとした Web サービスのみ です。WebSphere Application Server v6.x を 使用する Web サービスには影響しません。