Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Eclipse プラグインガイド

第1章 はじめに

1.1. Eclipse プラグインガイド

本ガイドでは、エンジニア、エンジニア、およびその他の MTA(Migration Toolkit for Applications)の Eclipse プラグインを使用してアプリケーションの移行を支援します。

注記

本ガイドでは、Eclipse を使用して Eclipse または JBoss Developer Studio のインストールを参照します。

1.2. MTC(Migration Toolkit for Applications)

MTC(Migration Toolkit for Applications)

Migration Toolkit for Applications(MTA)は、拡張可能かつカスタマイズ可能なルールベースのツールで、Java アプリケーションの移行を単純化します。

MTA は、プロジェクトソースディレクトリーおよびアプリケーションアーカイブを含むアプリケーションアーティファクトを検査し、変更を必要とする領域を強調表示する HTML レポートを生成します。MTA を使用すると、以前のバージョンの Red Hat JBoss Enterprise Application Platform または Oracle® WebSphere® Application Server などの他のコンテナーから Java アプリケーションを移行できます。

Migration Toolkit for Applications で移行を簡素化するにはどうすればよいですか？

アプリケーション向けの MTC(Migration Toolkit for Applications)は一般的なリソースを見つけ、アプリケーションの移行時に技術と既知の問題のある場所を強調表示します。この目的は、アプリケーションが使用するテクノロジーの概要を提供し、組織がエンタープライズアプリケーションを Java EE および Red Hat JBoss Enterprise Application Platform に推定、文書化、移行するために使用できる詳細なレポートを提供することです。

詳細を確認する方法

MTC(Migration Toolkit for Applications)の機能、サポートされる設定、システム要件、および利用可能なツールの詳細は、『 スタートガイド』 を参照してください。

1.3. Eclipse プラグインについて

Migration Toolkit for Applications の Eclipse プラグインは、Eclipse および Red Hat JBoss Developer Studio に直接サポートを提供し、移行または最新化の作業を行います。MTA を使用してプロジェクトを分析し、ソースコード内の移行問題をマークし、問題を修正するためのガイダンスを提供し、可能な場合は自動コードの置き換えを提供します。

1.4. サポートされる構成

Eclipse プラグインは、開発環境に従ってテストされています。

  • Eclipse 4.7 (Oxygen)
  • Red Hat JBoss Developer Studio 11.3

第2章 Eclipse プラグインのインストール

サポートされる設定 を確認し、Eclipse プラグインと互換性のある開発環境を使用していることを確認します。

注記

macOS を実行している場合は、ユーザープロセスの最大数、少なくとも、をに maxproc、オープンファイルの最大数 2048を設定 maxfilesすることが推奨され 100000ます。

既存のインストールがない場合は、Eclipse または JBoss Developer Studio をダウンロードし、インストールします。

注記

本ガイドでは、Eclipse を使用して Eclipse または JBoss Developer Studio のインストールを参照します。

プラグインのインストール

  1. Eclipse を起動します。
  2. メニューバーから Help → Install New Software と選択します。

  3. MTA 更新サイトを追加します。

    1. Work with フィールドの横にある Add をクリックします。
    2. Name フィールドにを入力し MTAます。
    3. Location フィールドにを入力 し、OK http://download.jboss.org/jbosstools/photon/stable/updates/rhamt/ を押します。
    4. JBoss Tools - RHAMT のチェックボックスをすべて選択し、Next を押します。
  4. インストールの詳細を確認し、次へ を押します。
  5. ライセンス契約に同意し 、Finish を押してプラグインをインストールします。
  6. 変更を有効にするには、Eclipse を再起動します。

オフライン環境のプラグインのインストール

  1. Eclipse Plugin Repository をダウンロードします。
  2. Eclipse を起動します。
  3. メニューバーから Help → Install New Software と選択します。

  4. MTA 更新サイトを追加します。

    1. Work with フィールドの横にある Add をクリックします。
    2. Name フィールドにを入力し MTA - Offlineます。
    3. Location フィールドの横にある Archive をクリックします。
    4. 最初のステップでダウンロードしたファイルを選択し、OK をクリックします。
    5. JBoss Tools - RHAMT のチェックボックスをすべて選択し、Next を押します。
  5. インストールの詳細を確認し、次へ を押します。
  6. ライセンス契約に同意し 、Finish を押してプラグインをインストールします。
  7. 変更を有効にするには、Eclipse を再起動します。

第3章 MTA Eclipse ツールへのアクセス

プラグインがインストールされると、MTA Eclipse ツールが MTA パースペクティブで利用可能になります。MTA パースペクティブを開くには、Window → Perspective → Open Perspective → Other に移動します。MTA を選択 し、OK を押します。

プラグインコンポーネントを確認してから 、 移行の問題を特定して解決 し始めます。また、Eclipse で Help → Getting Started を選択して、プラグインの埋め込み ヘルプ を表示することもできます。

3.1. Eclipse プラグインコンポーネント

Eclipse プラグインを使用してプロジェクトを分析する場合、以下のコンポーネントは MTA パースペクティブで利用できます。

Issue Explorer

このビューでは、解析されているプロジェクトの MTA の問題を確認することができます。

このビューが MTA パースペクティブに表示されない場合は、Window → Show View → Issue Explorer を選択して開きます。

MTA Server

MTA サーバーは、MTA 分析を実行し、移行の問題にフラグを付け、レポートを生成する別のプロセスです。

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

Issue Details

このビューには、ヒント、重大度、その他のリソースなど、選択した MTA の問題の詳細情報が表示されます。

このビューが MTA パースペクティブに表示されない場合は、Window → Show View → Issue Details を選択して開きます。

MTA Report

このビューには、MTA の実行時に生成される HTML レポートが表示されます。レポートのランディングページから、アプリケーションの詳細、問題、依存関係などの詳細レポートに移動できます。

MTA レポートを生成するには、使用する MTA 実行設定の Generate Report オプションが選択されている必要があります。

このビューが MTA パースペクティブに表示されない場合は、Window → Show View → MTA Report を選択して開きます。

第4章 移行問題の特定および解決

以下の手順に従って、Eclipse プラグインを使用して移行の問題を特定し、解決します。

  1. プロジェクトをインポートして Eclipse に分析します。

  2. 実行設定を作成し ます。Issue Explorer で MTA ボタンを押します（ MTA ボタン ) をクリックします。

    MTA ボタンの選択

    少なくとも、分析するプロジェクトを選択します。必要に応じて、追加のオプションを設定します。

  3. 実行をクリック し て MTA を実行 します。
  4. Issue Explorer に一覧表示されているMTA の問題を確認 します。
  5. コードを手動で更新するか、利用可能な場合はクイック修正を使用して、MTA の問題を解決 します。
  6. 必要に応じて MTA を再度実行します。Run ボタン ( Run ボタン ) の横にあるドロップダウンを使用して、既存の設定を実行します。

4.1. MTA の実行設定の作成

MTA ボタン ( MTA ボタン ) を使用して MTA の実行設定を作成できます。実行設定では、分析するプロジェクト、移行パス、および実行の追加オプションを指定します。複数の実行設定を作成することができます。また、それぞれに一意の名前を付けることができます。

入力
移行パス
使用する MTA ルールセットを決定する移行パスを選択します。移行パスのデフォルトは Anything to EAP 7 に設定されますが、サポートされる移行パスに変更できます。
プロジェクト
分析するプロジェクトを 1 つ以上選択します。Ctrl キーを押すると、リストの複数のプロジェクトを選択します。
パッケージ
スキャンするパッケージを 1 つ以上選択します。MTA 実行時間を短縮するために分析が必要なパッケージのみを選択することが推奨されます。パッケージを選択しないと、プロジェクトのすべてのパッケージがスキャンされます。Ctrl キーを押して、リストの複数のパッケージを選択します。
オプション
レポート
MTA HTML レポートを生成する場合は、Generate Report チェックボックスを選択します。レポートは MTA Report タブに表示され、ファイル を基にグループ化すると Issue Explorer に表示されます。
オプション
追加の MTA オプションを設定します。などのブール値フラグであるオプションは、を値 true として使用する enableTattletale必要があります。各 MTA 引数の説明は、『CLI ガイド』の「MTA コマンドライン引数」を参照してください。
ルール
カスタムルールのリポジトリー
Eclipse プラグインにカスタム MTA ルールをインポートまたは作成した場合には、分析中に組み込むカスタムルールセットを選択します。詳細は、「 カスタムルールの追加」を 参照してください。

4.2. MTA の実行

実行設定を作成したら、その設定を使用して MTA を以下の方法のいずれかで実行できます。

  • Run Configurations ダイアログから実行設定を選択し、Run をクリックします。
  • Run ボタン ( Run ボタン ) を使用して MTA の実行設定を作成できます。

MTA サーバーが現在実行していない場合は、実行設定が実行されると起動します。

注記

まもなく MTA を実行する予定がない場合は、MTA サーバーを停止してマシンのメモリーを保存することが推奨されます。

実行が完了すると、Issue Explorer に MTA の問題が表示されます。

4.3. MTA の問題の確認

Issue Explorer を使用して、MTA が特定する移行の問題を確認します。アイコン ごとに、問題の重大度と状態が示されます。

Group By の選択 (重要度、移行ルール、およびファイル) 調整して、問題のグループ化の方法を変更します。

issue Explorer グループ (オプション別)

Issue Explorer の MTA の問題をダブルクリックして、エディターでコードの関連する行を開きます。右クリックし、Issue Details を選択して MTA の問題についての情報を表示します。これには、重大度や対処方法が含まれます。

4.4. MTA 問題の解決

MTA の問題を解決するには、コードを手動で更新するか、利用可能な場合はクイック修正を適用します。

4.4.1. 問題の手動による解決

MTA の問題の詳細とその他のリソースを確認し、必要に応じてソースコードを更新します。MTA の問題としてマークされたコードの行を更新すると、MTA が次回プロジェクトで実行されるまで、MCTA の問題には古いアイコン ( 古い問題アイコン ) のマークが付けられます。

MTA の問題を修正済みとしてマークすることもできます。これにより、MTA が次回プロジェクトで実行されるまで、その問題には解決済みアイコン ( 解決済み問題のアイコン ) でマークが付けられます。問題が修正されたことを示すには、Issue Explorer の MTA の問題を右クリックして、Mark as Fixed を選択します。

4.4.2. クイックスタートを使用した問題の解決

一部の MTA の問題により、問題に対処するために必要な編集に役立つ修正が提供されます。MTA の問題が素早く修正されたことを示すアイコンを表示 する には、アイコンのレラッシュを参照してください。

クイックスタートのプレビュー
問題を右クリックし、Preview Quick Fix を選択します。これにより、変更をプレビューできるウィンドウが表示されます。ここから、修正を適用したり、ウィンドウを閉じることができます。
クイックスタートの適用
問題を右クリックし、Apply Quick Fix を選択します。これにより、ソースコードが必要に応じて更新され、MTA の問題は解決済みとしてマークされます。

第5章 カスタムルールの追加

デフォルトでは、Eclipse プラグインには、移行および最新化の問題を特定するためのシステムルールのコアセットが含まれています。Eclipse プラグインから 既存のルールを参照 できます。

また、アプリケーション固有の問題を特定するために独自のルールを作成することもできます。既存のカスタムルールセットをインポートするか、 または Eclipse プラグインに 直接カスタムルールセットを作成 できます。

5.1. 参照ルール

Eclipse プラグインからシステムおよびカスタムルールの両方を表示できます。

  1. MTA パースペクティブから、Rulesets タブを開きます。

  2. System 項目を展開してコアシステムルールを表示するか、Custom 項目を展開してカスタムルールを表示します。

    注記

    システムルールを表示するには、MTA サーバーを起動する必要があります。

  3. 確認するルールが含まれる ruleset を展開します。
  4. ルールをダブルクリックして、ビューアーでルールを開きます。Source タブを選択すると、ルールの XML ソースを表示できます。

5.2. カスタムルールセットのインポート

プロジェクトの分析中に使用する Eclipse プラグインに既存のカスタムルールセットをインポートできます。

  1. MTA パースペクティブから、Rulesets タブを開きます。
  2. ルールセットのインポートアイコン ( ルールセットのインポートアイコン ) を使用して MTA の実行設定を作成できます。

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

    注記

    MTA ルールとして認識するには、XML ルールファイルで .windup.xml または .rhamt.xml 拡張子を使用する必要があります。

  4. カスタムルールセットは、Rulesets タブの Custom アイテムの下に表示されます。

プロジェクトを分析する際に、このカスタムルールセットが実行設定で選択できるようになりました。

カスタム XML ルールの作成に関する詳細は、『ルール開発ガイド』を参照してください。

5.3. カスタムルールセットの作成

プロジェクトの分析中に使用する Eclipse プラグインで新しいカスタムルールセットを作成できます。

  1. MTA パースペクティブから、Rulesets タブを開きます。
  2. Create ruleset アイコン ( Create ruleset icon ) を使用して MTA の実行設定を作成できます。
  3. プロジェクトおよびディレクトリーを選択して、新しいルールセットを保存します。

  4. ルールセットファイルのファイル名を入力します。

    注記

    MTA ルールとして認識するには、XML ルールファイルで .windup.xml または .rhamt.xml 拡張子を使用する必要があります。

  5. ルールセット ID を入力します（例：） my-ruleset-id。
  6. 必要に応じて、Generate quickstart template チェックボックスをチェックして、ルールセットファイルに基本的なルールテンプレートを追加します。
  7. Finish を選択します。
  8. エディターで新しいルールセットファイルが開かれ、ルールを追加および編集できます。Source タブを選択して、ruleset ファイルの XML ソースを編集することもできます。

プロジェクトを分析する際に、この新しいルールセットが実行設定で選択できるようになりました。

カスタム XML ルールの作成に関する詳細は、『ルール開発ガイド』を参照してください。

付録A リファレンス資料

A.1. MTA の問題アイコン

Issue Explorer およびファイルエディターでは、MTA の問題はアイコンを使用して重大度およびステータスを示します。以下の表は、さまざまなアイコンの意味を示しています。

表A.1 MTA の問題アイコン
アイコン説明
必須

移行を成功させるには、この問題を修正する必要があります。

任意

移行については、この問題の修正は任意です。

警告

この問題は、移行時に問題が発生する可能性があります。

解決済

この問題は解決されています。

古い

この問題は、MTA がプロジェクトで最後に実行した後に問題としてマークされたコードが変更しているため、古い問題となります。

必須 (クイック修正あり) ()

この問題には、クイック修正を利用できます。これは、移行を成功させるために修正する必要があります。

任意 (クイック修正あり)

この問題にはクイック修正を利用できます。移行の修正は任意です。

警告 (クイック修正あり)

この問題にはクイック修正を利用できます。これは移行中に問題が発生する可能性があります。





改訂日時： 2020-10-18 19:15:36 AEST

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat, Inc.