Javaアプリケーションの近代化

開始前に

1. エンタープライズJava環境を設定してください。
2. 拡張 Visual Studio Code 機能をインストールする、プラグ Eclipse IDE インをインストールする、 または IntelliJ IDEA IDE プラグインをインストールする。

問題が発生した場合、 トラブルシューティングページを参照してください Application Modernization Accelerator Developer Tools。

コード解析に要する時間

申請書の分析にかかる時間はさまざまです。 以下の時間は典型的なものである。

マイグレーションプランを使用してアプリケーションを最新化する

以下の手順は、移行計画を生成 IBM Application Modernization Accelerator するためにを使用していることを前提としています。 移行計画には、対処すべき近代化問題のリストが含まれている。 また、 Liberty でアプリケーションが正しく機能するように、自動的に生成される設定情報も含まれています。

コードの変更を元に戻した場合、アプリケーションを再度モダナイズしたい場合は、 Returnをクリックしてアップロード/分析を行い、完全な分析を行う必要があります。

1. IDE で、モダナイズしたいアプリケーションのディレクトリ内の階層にある項目を右クリックして Modernize Java Applicationsをクリックし、「 Modernize to Liberty 」をクリックします。
2. Modernize <アプリケーション名> ページで、移行プランをアップロードします。

   IDEはプロジェクトフォルダを分析し、アプリケーションに関する情報を収集し、 Application Modernization Accelerator が生成した移行プランをアップロードします。

   1. 移行計画のアップロードをクリックします。
   2. リストからアーカイブファイルのアプリケーションプランを選択し、「 開く 」をクリックします。

      移行プランをアップロードするプロセスが完了すると、 Modernize <アプリケーション名> ページにプランに含まれる以下の構成ファイルが表示されます：

      • server.xml は Liberty の設定ファイルで、アプリケーションを起動するために必要です。
      • Containerfile が必要なのは、 Liberty アプリケーション用のコンテナ・イメージを構築するときだけである。

   3. プロジェクトに追加するファイルを選択し、 Proceedをクリックします。

      • (必須) server.xml ファイルを選択します。
      • (オプション） Liberty アプリケーション用のコンテナ・イメージを構築する場合のみ、 Containerfile ファイルを選択します。

   移行プランのアップロードが完了すると、修正またはレビューすべき課題が表示されます。

3. 解析の結果、アプリケーションで JAX-RPC サービスが検出された場合は、画面の指示に従って JAX-RPC サービスを JAX-WS サービスに移行してください。

4. アプリケーションの問題を修正する。

   修正すべき問題によって、修正能力は自動化されることもあれば、自己管理されることもある。 追加情報] タブのissueはコード変更の必要はありませんが、検証やテストが必要な場合はコード変更を行う必要があるかもしれません。

アプリケーションを分析してモダナイズする

以下のステップは、アプリケーションを近代化するために Application Modernization Accelerator 移行計画を使用するのではなく、アプリケーションを分析することを想定しています。 この分析では、対処すべき問題のリストと、 server.xml ファイル内の限定的なサーバー構成が提供されます。 server.xml ファイルには、アプリケーションが使用する機能のリストが含まれていますが、データベース接続やJMSコンフィギュレーションなど、その他のコンフィギュレーション情報は含まれていません。

コードの変更を元に戻した場合、アプリケーションを再度モダナイズしたい場合は、 Returnをクリックしてアップロード/分析を行い、完全な分析を行う必要があります。

1. IDEで、モダナイズしたいディレクトリを右クリックし、 Modernize Java Applications をクリックし、 Modernize to Liberty をクリックします。

2. Modernize <アプリケーション名> ページで、[ Analyze application] を展開し、[ Start analysis] をクリックします。

3. アプリケーション・サーバーを分析するルールを定義する分析パラメーターを選択します。

   1. アプリケーション・サーバー・ソースとアプリケーション・サーバー・ターゲットを選択します。

   2. オプションで、 Java SEソースを変更する。自動的に推奨値が表示される。

      推奨値は、 Application Modernization Accelerator Developer Tools がアプリケーション・サーバー・ソースに推奨する Java SE バージョンに基づいています。 アプリケーション・サーバーが、推奨されているものとは異なる Java SE バージョンを使用している可能性があります。 もしそうなら、 Java SEのソースを、アプリケーション・サーバーが使用するバージョンに変更してください。

      たとえば、アプリケーションサーバーが以前のバージョンの Java SEを使用している場合でも、 Application Modernization Accelerator Developer ToolsWebSphere Application Server V8.5.5 ではJava SE 8を推奨しています。

      重要： Java の最低サポートバージョンは Java 5 です。

   3. Java SEターゲットを選択する。

   4. アプリケーションを構築し、それを分析する。

      アプリケーション解析はアプリケーションバイナリに対して行われる。 分析開始前にアプリケーションを構築する必要がある。

      • Mavenビルドの場合、手動または自動でアプリケーションをビルドすることができる。

        手動でアプリケーションをビルドした後に Analyzeをクリックするか、 Build and analyzeのどちらかをクリックして、自動的にアプリケーションをビルドして分析します。

        アプリケーションがビルドされ、分析されると、修正またはレビューすべき問題が表示されます。

        ビルドして分析] をクリックすると、アプリケーションは現在の Java ソースバージョンでビルドされ、 Java アップグレードの問題を分析できます。 IDE が正常にアプリケーションをビルドできるように、 Java ソース・バージョンの Java 開発者キットで IDE を構成してください。

      • Mavenを使用しないビルドの場合は、手動でアプリケーションをビルドし、アプリケーション・バイナリを選択して、[ Analyze] をクリックします。

        アプリケーションがビルドされ、分析されると、修正またはレビューすべき問題が表示されます。

4. 解析の結果、アプリケーションで JAX-RPC サービスが検出された場合は、画面の指示に従って JAX-RPC サービスを JAX-WS サービスに移行してください。

5. アプリケーションの問題を修正する。

   Mavenビルドの場合、修正すべき問題によって、修正能力は自動化されることもあれば、自己管理されることもある。

   IBM Application Modernization Accelerator Developer Tools 、Mavenを使用しないビルドの自動化を実行することはできないため、修正すべき問題は自己責任となる。

   追加情報] タブのissueはコード変更の必要はありませんが、検証やテストが必要な場合はコード変更を行う必要があるかもしれません。

JAX-RPC サービスから JAX-WS サービスへの移行

JAX-RPC サービスを手動で JAX-WS サービスに移行するか、[ 続行] をクリックします。 続行] をクリックすると、 JAX-RPC から JAX-WS へのソース移行ヘルパーが移行を支援します。

以下の手順は、[ 続行] をクリックしたと仮定しています。

1. .wsdl ファイルの修正をすべて完了する。

   JAX-RPC マイグレーションでは、リスト内の別の .wsdl ファイルを作業する前に、 .wsdl ファイルの修正をすべて完了する必要があります。

   JAX-RPC 移行のメインページには以下の情報が表示される。 これを使用して移行を完了する。

   再始動

   移行を再開したい場合は、 Restartをクリックします。

   重要:

   • Restartをクリックすると、マイグレーションを再開する場合は、自動修正と手動修正で行ったすべてのコード変更を元に戻す必要があるというメッセージが表示されます。 すべての変更を元に戻してマイグレーションを再開しないと、 .wsdl 、以前にオートメーションを実行したファイルが「 Unsupported (Manual migration required)」 セクションに表示されます。
   • コードの変更を元に戻さずに JAX-RPC マイグレーションを再起動した場合は、もう一度再起動をクリックします。 自動更新、手動更新、またはその両方によって、 JAX-RPC のフローを変更する前のバージョンのアプリケーションコードに戻る。

   保留中

   1つ以上の .wsdl ファイルがリストされている保留セクションがある場合は、セクションを選択します。

   .wsdl の各ファイルを選択し、それに関連する以下の作業を行う。

   1. オートメーションの実行
      オートメーションを実行すると、以下のアクションが実行される。

      • アプリケーションは、 JAX-RPC サービスを JAX-WS サービスに移行するために修正される。
      • 手動アップデートのセクションには、特定の Java ファイルを手動でアップデートするための指示とリンクがあります。
      • Review newly generated files セクションには、レシピが作成した新しい Java パーツが入力される。
   2. 指定された Java ファイルの手動更新を完了する。
   3. 新しく生成されたファイルを確認する。
   4. 手動でアプリケーションをコンパイルする。

   完了

   セクションを選択する。

   完成した .wsdl ファイルのリストが表示され、リストは自動的に更新される。

   未サポート（手動移行が必要）

   セクションを選択する。

   .wsdl ファイルに JAX-RPC ソース移行ヘルパーがサポートしていない機能がある場合、そのファイルは未サポートとしてマークされます。 また、 .wsdl ファイルに対してオートメーションを実行して失敗した場合、サポート対象外としてマークすることもできます。

   • ソース移行ヘルパーが .wsdl ファイルをサポート対象外に追加した場合は、 .wsdl ファイル内の JAX-RPC サービスを手動で移行します。

     ソース移行ヘルパーは、 .wsdl ファイルにサポートされていない機能が含まれている場合、 .wsdl ファイルをサポートされていないセクションに追加します

   • .wsdl ファイルをサポート外としてマークした場合は、 .wsdl ファイル内の JAX-RPC サービスを手動で移行できます。 代わりに、 JAX-RPC サービス移行を再起動して、 .wsdl ファイルの自動化を実行することもできます。

   未使用（削除しても問題ない）

   未使用の .wsdl ファイルを表示するセクションを選択します。

   アプリケーションでは使用しないので、ファイルを削除することができます。

   .wsdl ファイルの修正をすべて完了したら、つまり、 WSDL の合計を修正する必要があるインジケータは 0 で、 JAX-RPC ソース移行ヘルパーが支援できる部分については、 JAX-RPC 移行が完了します。

   注記： 表示される 「ビルドして分析する 」ボタンをクリックする前に、 JAX-WS サービスへの移行が完了するように、サポートされていないセクションの .wsdl ファイルを手動で移行してください。
2. ビルドして分析する 」をクリックする。

   JAX-WS サービスに移行したアプリケーションは、残っている近代化の問題がないか再スキャンされます。

3. アプリケーションの問題を修正する。

   Mavenビルドの場合、修正すべき問題によって、修正能力は自動化されることもあれば、自己管理されることもある。

   Mavenを使用しないビルドの場合、修正すべき問題は自己責任となる。

   追加情報] タブのissueはコード変更の必要はありませんが、検証やテストが必要な場合はコード変更を行う必要があるかもしれません。

アプリケーションの問題点の修正と追加情報の確認