Eclipse プラグインガイド

手順

1. Eclipse を起動します。
2. メニューバーから Help → Install New Software を選択します。
3. Work with フィールドの横にある Add をクリックします。
4. Name フィールドに MTA を入力します。
5. Location フィールドに https://marketplace.eclipse.org/content/migration-toolkit-applications-mta と入力し、OK をクリックします。

6. 使用する Java バージョンを選択します。

   • Java 11 を使用している場合は、JRE リストで JavaSE 11 を選択します。
   • Java 17 を使用している場合は、JRE の選択を変更しないでください。

7. すべての JBoss Tools - MTA チェックボックスを選択して、Next をクリックします。
8. インストールの詳細を確認し、Next をクリックします。
9. ライセンス契約の条件に同意し、Finish をクリックします。
10. Eclipse を再起動します。

手順

1. Eclipse を起動します。
2. メニューバーから Help → Install New Software を選択します。
3. Work with フィールドの横にある Add をクリックします。
4. Name フィールドに MTA を入力します。
5. Location フィールドに https://marketplace.eclipse.org/content/migration-toolkit-applications-mta と入力し、OK をクリックします。

6. 使用する Java バージョンを選択します。

   • Java 11 を使用している場合は、JRE リストで JavaSE 11 を選択します。
   • Java 17 を使用している場合は、JRE の選択を変更しないでください。

7. すべての JBoss Tools - MTA チェックボックスを選択して、Next をクリックします。
8. インストールの詳細を確認し、Next をクリックします。
9. ライセンス契約の条件に同意し、Finish をクリックします。
10. Eclipse を再起動します。

手順

1. Window → Perspective → Open Perspective → Other をクリックします。

2. MTA を選択し、OK をクリックします。

   以下のコンポーネントが表示されます。

   • Issue Explorer は、MTA プラグインで識別される移行の問題を表示します。

   • MTA Server は、プロジェクトを分析し、移行の問題にフラグを立て、レポートを生成する別個のプロセスです。

     Issue Explorer で MTA サーバーの開始、停止、およびステータス表示を行うことができます。

   • Issue Details には、ヒント、重大度、追加のリソースなど、選択した問題に関する詳細情報が表示されます。

   • MTA Report は MTA プラグインによって生成された HTML レポートです。レポートのランディングページから、アプリケーションの詳細、問題、依存関係などの詳細なレポートに移動できます。

     注記

     デフォルトでは、レポートは生成されません。実行設定で Generate Report オプションを選択する必要があります。

手順

1. Issue Explorer で MTA アイコン ( ) をクリックし、実行設定を作成します。

2. 入力 タブで、以下のフィールドを入力します。

   1. 移行パスを選択します。
   2. Projects フィールドの横にある Add をクリックし、1 つ以上のプロジェクトを選択します。

   3. Packages フィールドの横にある Add をクリックし、パッケージを 1 つまたは複数選択します。

      注記

      分析するパッケージを指定すると、ランタイム時間が短縮されます。パッケージを選択しないと、プロジェクト内のすべてのパッケージがスキャンされます。

3. Options タブで Generate Report を選択し、HTML レポートを生成することができます。レポートは Report タブに表示され、ファイルとして保存されます。

   その他のオプションが表示されます。詳細は、CLI ガイド の MTA コマンドライン引数 を参照してください。

4. Rules タブで、MTA プラグインにインポートまたは作成したカスタムルールセットを選択できます。
5. 実行 をクリックして分析を開始します。

手順

1. MTA パースペクティブで、Run ボタン ( ) をクリックし、実行設定を選択します。

   MTA プラグインはプロジェクトを分析します。Issue Explorer は、ルールセットで検出された移行の問題を表示します。

2. プロジェクトの分析が終了したら、Issue Explorer で MTA サーバーを停止して、メモリーを節約します。

手順

1. Window → Show View → Issue Explorer をクリックします。

2. オプション: Options メニュー をクリックし、Group By およびオプションを選択して問題をフィルタリングします。

   

   View larger image

   

3. 右クリックし、Issue Details を選択して問題に関する情報を表示します。これには、重大度や対処方法が含まれます。

   以下のアイコンは、問題の重大度および状態を示しています。

   Expand

   表3.1 問題アイコン

   アイコン	説明
   View larger image	移行を成功させるには、この問題を修正する必要があります。
   View larger image	移行については、この問題の修正は任意となります。
   View larger image	この問題は、移行時に対処する必要がある場合があります。
   View larger image	この問題は解決されています。
   View larger image	この問題は古くなっています。問題としてマークされたコードは、MTA が最後に問題として識別したときから変更されています。
   View larger image	この問題にはクイック修正を利用できます。正常に移行するには修正は必須となります。
   View larger image	この問題にはクイック修正を利用できます。移行については、修正は任意となります。
   View larger image	この問題にはクイック修正を利用できます。これは、移行中に問題が発生する可能性があります。

   Show more
4. 問題をダブルクリックして、エディターで関連するコードの行を開きます。

手順

1. Rulesets タブをクリックします。
2. System をデプロイメントして、システムのルールセットまたは Custom を表示してカスタムルールセットを表示します。
3. ルールセットをデプロイメントします。
4. ルールをダブルクリックして、ビューアーで開きます。
5. Source タブをクリックして、ルールの XML ソースを表示します。

手順

1. Rulesets タブをクリックします。
2. ルールセットの作成アイコン ( ) をクリックします。
3. ルールセットのプロジェクトおよびディレクトリーを選択します。

4. ファイル名を入力します。

   注記

   ファイルには拡張子 .windup.xml が必要です。

5. ruleset ID (my-ruleset-id など) を入力します。
6. オプション: Generate quickstart template を選択し、基本的なルールテンプレートをファイルに追加します。
7. Finish をクリックします。
8. エディターでルールセットファイルが開かれ、ルールを追加および編集できます。
9. Source タブをクリックして、ルールセットファイルの XML ソースを編集します。

手順

1. Rulesets タブをクリックします。
2. ルールセットのインポートアイコン ( ) をクリックします。

3. インポートする XML ルールファイルを参照して選択します。

   Rulesets タブで Custom を拡張すると、カスタムルールセットが表示されます。

手順

1. Rulesets タブをクリックします。
2. 矢印アイコン ( ) をクリックし、Submit Ruleset を選択します。

3. 以下のフィールドに入力します。

   • Summary: ルールの目的を説明します。これは送信時のタイトルになります。
   • Code Sample: ルールが実行するソースコードの例を入力します。
   • Description: ルールの簡単な説明を入力します。
4. Choose Files をクリックし、ルールセットファイルを選択します。
5. Submit をクリックします。