JAX-RPC - JAX-RPC 変換ツールの有効な候補

JAX-RPC変換ツールの検証により、このスキャン内のJAX-RPCウェブサービスは、JAX-RPCからJAX-WSへのソース移行ヘルパーを使用したJAX-WSへのソース変換、またはJAX-RPC変換ツールを使用したJAX-WSへのバイナリ変換の良い候補であると判断されました。 または JAX-RPC Conversion Toolを使用したJAX-WSへのバイナリ変換に適していると判断されました。 この規則により、JAX-RPC 固有のパッケージおよび構成ファイルの使用にフラグを立てます。 また、この規則により、XML マッピング・ファイルでの jaxrpc-mapping-file タグの使用にフラグを立てます。 次の表に、この規則の影響を受ける Java パッケージ、構成ファイル、および XML マッピング・ファイルをリストします。

パッケージ	構成ファイル	XML マッピング・ファイル
javax.xml.rpc javax.xml.rpc.encoding javax.xml.rpc.handler javax.xml.rpc.handler.soap javax.xml.rpc.holders javax.xml.rpc.server javax.xml.rpc.soap	ibm-webservices-ext.xmi ibm-webservices-bnd.xmi ibm-webservicesclient-ext.xmi ibm-webservicesclient-bnd.xmi ws-security.xml	webservices.xml web.xml ejb-jar.xml ibm-webservicesclient-bnd.xmi application.xml

Java API for XML-based RPC (JAX-RPC) は、Liberty でも Liberty Core でもサポートされていません。 このテクノロジーは、WebSphere Application Server traditional V9.0 で非推奨となったため、今後のバージョンでは削除される可能性があります。 戦略的なマイグレーション・パスでは JAX-WS を使用します。 相対的な作業は、選択したマイグレーション・パスに応じて変わります。

• オプション1：JAX-RPCソース移行ヘルパーを使用して、JAX-RPC WebサービスをJAX-WS Webサービスに移行する。
• オプション2：JAX-RPC変換ツールを使用して、JAX-RPC WebサービスをJAX-WS Webサービスに移行する。
• オプション3：JAX-RPCウェブ・サービスをJAX-WSウェブ・サービスに手動で移行する。
• オプション 4： Apache の Axis 1 JAX-RPC エンジンを使用する。 Liberty
• オプション5：ネイティブJAX-RPCエンジンで WebSphere Application Server。

以下の表は、プロジェクトに影響を与える可能性のある要因に従って、5つのオプションを比較したものです。

プロジェクトの要素	オプション 1 JAX-RPC Source Migration Helperを使用したJAX-RPC WebサービスからJAX-WS Webサービスへの移行	オプション 2 JAX-RPC 変換ツールを使用して JAX-RPC Web サービスを JAX-WS Web サービスに移行する	オプション 3 手動で JAX-RPC web サービスを JAX-WS web サービスに移行する	オプション 4 Liberty で Apache Axis 1 JAX-RPC エンジンを使用する	オプション5 WebSphere Application Server traditional をそのネイティブ JAX-RPC エンジンと一緒に使用する
サポートされるソリューション	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションで構成可能なフィーチャーとしてサポートされます。	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションで構成可能なフィーチャーとしてサポートされます。 Maven および Gradle 用の WebSphere Liberty JAX-RPC 変換ツールをダウンロードしてください。	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションで構成可能なフィーチャーとしてサポートされます。	いいえ Axis 1 はサポートされていません。	はい JAX-RPC は、WebSphere Application Server traditional でサポートされています。
重要なソリューション	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションに戦略的です。	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションに戦略的です。	はい JAX-WS は、Liberty Core を除き、すべての Liberty エディションに戦略的です。	いいえ Axis 1 は、現在では開発されていません。	いいえ JAX-RPC は、WebSphere Application Server traditional で非推奨となったため、今後のバージョンでは削除される可能性があります。
実装の複雑さ	中 アプリケーションは、JAX-RPC Source Migration Helperの使用について検証された。 JAX-RPCサービスは、アプリケーションのソースコード上でこのツールによってJAX-WSウェブサービスに変換することができる。	低 アプリケーションは、JAX-RPC 変換ツールの使用について検証されました。 JAX-RPCサービスは、このツールでバイナリアーカイブ内のJAX-WSウェブサービスに変換することができます。	高 このオプションは、JAX-RPC クライアントと JAX-RPC Web サービスの数が多い場合は複雑になる可能性があります。 JAX-RPC 変換ツールを使用せずに、JAX-RPC サービス を JAX-WS に移植するには、コード・ベースが多くの変更が必要です。	低 アプリケーションで既に Axis 1 を使用している場合、このオプションは複雑ではありません。 使用していない場合、このオプションの複雑さは中程度です。	中 JAX-RPC Web サービスから別のエンジンにマイグレーションする際、ほとんどのコード・ベースは保持されます。
拡張機能	はい JAX-WS は、アノテーション、JAXB バインディング、SOAP 1.2 などの多数の拡張機能を提供します。	はい JAX-WS は、アノテーション、JAXB バインディング、SOAP 1.2 などの多数の拡張機能を提供します。	はい JAX-WS は、アノテーション、JAXB バインディング、SOAP 1.2 などの多数の拡張機能を提供します。	いいえ JAX-RPC には、JAX-WS にある多くの拡張機能がありません。	いいえ JAX-RPC には、JAX-WS にある多くの拡張機能がありません。
仕様の準拠	はい	はい	はい	はい JAX-RPC はまだ Java EE 仕様の一部ですが、Java EE 6 では非推奨です。	はい JAX-RPC はまだ Java EE 仕様の一部ですが、Java EE 6 では非推奨です。
推奨事項	IBM Application Modernization Accelerator Developer Tools の権利がある場合は、このオプションを使用する。 これは、アプリケーションのソースコードをJAX-WSに移行するための自動化された支援を提供する唯一のオプションです。	アプリケーションが JAX-RPC 変換ツールの要件を満たす場合に、このオプションを使用します。 このツールはバイナリ アーカイブのみを変換します。	JAX-RPC Web サービスがいくつかあり、アプリケーションが JAX-RPC 変換ツールの要件を満たしない場合に、このオプションを使用します。	JAX-RPC Web サービスが既に Axis 1 で実行されている場合は、このオプションを使用します。	JAX-RPC Web サービスが既に WebSphere Application Server traditional で実行されているか、まだ Axis 1 で実行されていない JAX-RPC Web サービスが多数ある場合は、このオプションを使用します。

JAX-RPC Source Migration Helperを使用したJAX-RPC WebサービスからJAX-WS Webサービスへの移行

JAX-RPC Source Migration Helper は IBM Application Modernization Accelerator Developer Tools で利用可能です。 このツールは、アプリケーションのソースコードにおいて、レガシーJAX-RPCサービスからJAX-WSへの変換を支援する。 詳細は Application Modernization Accelerator Developer Tools 概要をご覧ください。

JAX-RPC 変換ツールを使用して JAX-RPC Web サービスを JAX-WS Web サービスに移行する

からJAX-RPC変換ツールをダウンロードします。 WebSphere Liberty JAX-RPC Conversion Tool for Mavenおよび Gradle、バイナリアーカイブを移行します。

JAX-RPC 変換ツールを使用した JAX-RPC から JAX-WS へのアプリケーションのマイグレーションについては、オンライン資料の Maven を使用した JAX-RPC アプリケーションの Liberty へのマイグレーションまたは Gradle を使用した JAX-RPC アプリケーションの Liberty へのマイグレーションを参照してください。

手動で JAX-RPC web サービスを JAX-WS web サービスに移行する

JAX-RPC から JAX-WS へのアプリケーションのマイグレーションについては、オンライン資料の Web サービスのマイグレーション・シナリオ: JAX-RPC から JAX-WS および JAXB へを参照してください。

JAX-RPC と JAX-WS の違いについて詳しくは、 JAX-WS アプリケーション・デプロイメント・モデルを参照してください。

Liberty で Apache Axis 1 JAX-RPC エンジンを使用する

Axis 1 を既に使用している場合、それを Liberty で使用するには、Axis 1 ライブラリーを Liberty クラスパスに含める必要があります。

埋め込みの JAX-RPC を使用する場合、Axis 1 を使用するように web サービスを変換できます。 以下のプロシージャーでは、web サービスを Red Hat JBossからAxis 1に移行する方法について説明します。

1. Axis 1.0 ライブラリーを Apache Web サイトからダウンロードします。
   注: Axis 2.0 は、JAX-WS を使用し、JAX-RPC Web サービスをサポートしません。
2. Axis ライブラリーをクラスパスに含めます。 ライブラリーは、サーバーのクラスパスまたはアプリケーションの WEB-INF/lib ディレクトリーのいずれかに含めることができます。
3. Web サービスへの参照を web.xml ファイルから削除します。
4. Axis 管理サーブレットを web.xml ファイルに追加します。 web.xml ファイルの例については、 拡張インストール: 独自の Webapp への Axis の追加 (Apache Web サイト) を参照してください。
5. 以下のコマンドを使用して、WSDL ファイルから Web サービスを再生成します。

      java -cp <AXIS LIBRARIES> org.apache.axis.wsdl.WSDL2Java -t    java -cp <AXIS LIBRARIES> org.apache.axis.wsdl.WSDL2Java -t -s -o <Output directory> <WSDL file>

   このコマンドについて詳しくは、 WSDL2Java 資料 (Apache Web サイト) を参照してください。

6. WEB-INF ディレクトリー内に server-config.wsdd という XML ファイルを作成することで、Axis デプロイメント記述子を作成します。

   WSDD 構成エレメントについて詳しくは、 デプロイメント (WSDD) 参照 (Apache Web サイト) を参照してください。

7. 新しい環境に合うようクライアント・コードを変更します。 サーバーはコンテナーとして使用されないため、JNDI 参照を使用することはできません。 JNDI 参照は削除して、URL への直接参照に置き換える必要があります。

   例えば、以下のメソッドには JNDI 検索があります。

   
   public DemoType getService() throws Exception {
   
   javax.naming.InitialContext ctx = new javax.naming.InitialContext();
   
   DemoService service = (DemoService)ctx.lookup("java:comp/env/service/Demo");
   
   return service.getDemoService();
   }

   ルックアップは以下のように置き換える必要があります。

   private com.ibm.demo.webservices.server.DemoType getService() throws Exception {
   
   com.ibm.demo.webservices.server.DemoService_ServiceLocator service = new com.ibm.demo.webservices.server.DemoService_ServiceLocator();
   
   com.ibm.demo.webservices.server.DemoType demoType = service.getDemoService();
   
   return demoType;
   
   }

WebSphere Application Server traditional をそのネイティブ JAX-RPC エンジンと一緒に使用する

WebSphere Application Server JAX-RPC エンジンを使用する場合は、WebSphere Application Server traditional を使用する必要があります。 JAX-RPC は、Liberty ではサポートされていません。 Liberty を使用するには、他のオプションのいずれかを選択する必要があります。

設定のみ

JAX-RPC 構成ファイルが検出されても、このアプリケーション内で JAX-RPC Java API が使用されていた形跡がない場合、その構成ファイルは以前使用していて現在は不要になった JAX-RPC テクノロジーの残骸である可能性があります。 使用されていない構成は削除できます。