付録A リファレンス資料
A.1. Maven プラグイン引数
以下は、利用可能な MTA Maven プラグイン引数の詳細な説明です。
引数 | 説明 |
---|---|
enableCompatibleFilesReport | Compatible Files レポートの生成を有効にするフラグ。問題が検出されない状態ですべてのファイルを処理するため、このレポートには大規模なアプリケーションの処理に時間がかかる場合があります。 |
enableTattletale | 各アプリケーションの Tattletale レポートを生成するためのフラグ。 |
excludePackages | 評価から除外するパッケージの一覧たとえば、「com.mycompany.commonutilities」と入力すると、パッケージ名が「com.mycompany.commonutilities」で始まるクラスをすべて除外します。 |
excludeTags | 除外するタグの一覧。指定されている場合は、これらのタグを持つルールは処理されません。 |
explodedApps | 指定された入力ディクショナリーに 1 つののアプリケーションのソースファイルが含まれていることを示すフラグ。詳細は、「 入力ファイルの引数テーブル 」を参照してください。 |
exportCSV |
レポートデータをローカルファイルシステムの CSV ファイルにエクスポートするフラグ。MTA は、 |
includeTags | 使用するタグの一覧。指定されると、これらのタグを持つルールのみが処理されます。 |
inputDirectory |
分析するアプリケーションが含まれるディレクトリーへのパスを指定します。この引数のデフォルトはです |
keepWorkDirs | グラフデータベースや展開されたアーカイブなどの一時作業ファイルを削除しないように MTA に指示するフラグ。これはデバッグに役立ちます。 |
packages | MTA が評価するパッケージの一覧。この引数は必須です。詳細は「 パッケージの選択」を 参照してください。 |
offlineMode | フラグはオフラインモードで動作し、スキームの検証などのネットワークアクセス機能を無効にします。パフォーマンスの向上に使用します。 |
outputDirectory |
MTA が生成したレポート情報を出力するディレクトリーへのパスを指定します。この引数のデフォルトはです |
overwrite |
フラグ: で指定されている既存の出力ディレクトリーを強制的に削除し 警告 重要な情報が含まれるレポート出力ディレクトリーを指定しないでください。 |
sourceTechnologies |
移行元となる 1 つ以上のソーステクノロジー、サーバー、プラットフォーム、またはフレームワークの一覧。この引数は、引数とともに使用されるルールセットを判断するのに |
sourceMode |
評価するアプリケーションに、コンパイルされたバイナリーではなくソースファイルが含まれていることを示すフラグ。デフォルトは |
targetTechnologies |
移行先の 1 つ以上のターゲットテクノロジー、サーバー、プラットフォーム、またはフレームワークの一覧。この引数は、引数とともに使用されるルールセットを判断するのに |
userIgnorePath | MTA が無視されるファイルを識別する場所を指定します。 |
userRulesDirectory |
カスタム MTA ルールを検索する場所を指定します。値は、単数または複数のルールセットファイルを含むディレクトリーです。ルールセットファイルは、 |
windupHome | 抽出した MTA CLI のルートを参照する任意の引数。CLI のローカルインストールを参照すると、Maven プラグインはすべてのインデックスに直接アクセスできるため、パフォーマンスが向上します。 |
windupVersion | MTA のバージョンを指定します。 |
A.1.1. 入力ディレクトリーの指定
分析する 1 つ以上のアプリケーションを含むファイルまたはディレクトリーへのパス。デフォルトはです {project.basedir}/src/main/
。
Usage
<inputDirectory>INPUT_ARCHIVE_OR_DIRECTORY</inputDirectory>
<inputDirectory>INPUT_ARCHIVE_OR_DIRECTORY</inputDirectory>
inputDirectory
引数に提供される入力ファイルタイプがファイルまたはディレクトリーであるかどうかに応じて、提供される追加の引数に応じて、以下のように評価されます。
- ディレクトリー
--explodedApp --sourceMode 引数なし ディレクトリーは 1 つのアプリケーションとして評価されます。
ディレクトリーは 1 つのアプリケーションとして評価されます。
各サブディレクトリーはアプリケーションとして評価されます。
- ファイル
--explodedApp --sourceMode 引数なし 引数は無視されます。ファイルは 1 つのアプリケーションとして評価されます。
ファイルは圧縮プロジェクトとして評価されます。
ファイルは 1 つアプリケーションとして評価されます。
A.1.2. 出力ディレクトリーの指定
MTA が生成したレポート情報を出力するディレクトリーへのパスを指定します。
使用方法
<outputDirectory>OUTPUT_REPORT_DIRECTORY</outputDirectory>
<outputDirectory>OUTPUT_REPORT_DIRECTORY</outputDirectory>
-
省略すると、レポートが
{project.build.directory}/windup-report
ディレクトリーに生成されます。 -
出力ディレクトリーが存在する場合は、
overwrite
引数の値に基づいて上書きされます。この引数はデフォルトでに設定されtrue
、MTA はディレクトリーを削除し、再作成します。
A.1.3. ソーステクノロジーの設定
移行元となる 1 つ以上のソーステクノロジー、サーバー、プラットフォーム、またはフレームワークの一覧。この引数は、引数とともに使用されるルールセットを判断するのに targetTechnologies
役立ちます。
Usage
<sourceTechnologies> <source>eap:6</source> </sourceTechnologies>
<sourceTechnologies>
<source>eap:6</source>
</sourceTechnologies>
sourceTechnologies
引数は、Maven のバージョン範囲の構文 に続くバージョンサポートを提供するようになりました。これにより、指定されたバージョンに一致するルールセットのみを実行するように MTA が指示されます。例: <source>eap:5</source>
A.1.4. ターゲット引数の設定
移行先の 1 つ以上のターゲットテクノロジー、サーバー、プラットフォーム、またはフレームワークの一覧。この引数は、引数とともに使用されるルールセットを判断するのに sourceTechnologies
役立ちます。この引数は必須です。
使用方法
<targetTechnologies> <target>eap:7</target> </targetTechnologies>
<targetTechnologies>
<target>eap:7</target>
</targetTechnologies>
targetTechnologies
引数は、Maven のバージョン範囲の構文 に続くバージョンサポートを提供するようになりました。これにより、指定されたバージョンに一致するルールセットのみを実行するように MTA が指示されます。例: <target>eap:7</target>
JBoss EAP に移行する場合は、必ずターゲットでバージョンを指定してください(例:) eap:6
。指定すると、移行パスに関連しないものも含め、すべてのバージョンの JBoss EAP の ruleset のみが実行 eap
されます。
ソースプラットフォームに適した JBoss EAP バージョンについては、『 MTA Getting Started Guide』 の「 Supported Migration Paths 」を参照してください。
A.1.5. Packages の選択
MTA が評価するパッケージの一覧。この引数を使用することは強く推奨されます。
使用方法
<packages> <package>PACKAGE_1</package> <package>PACKAGE_2</package> </packages>
<packages>
<package>PACKAGE_1</package>
<package>PACKAGE_2</package>
</packages>
ほとんどの場合、カスタムアプリケーションクラスパッケージの評価にのみ関心があり、標準のJava EE パッケージやサードパーティのパッケージには関心がありません。
PACKAGE_N
引数はパッケージ接頭辞で、すべてのサブパッケージがスキャンされます。たとえば、パッケージcom.mycustomapp
およびをスキャンするにはcom.myotherapp
、で以下のスニペットを使用しpom.xml
ます。<packages> <package>com.mycustomapp</package> <package>com.myotherapp</package> </packages>
<packages> <package>com.mycustomapp</package> <package>com.myotherapp</package> </packages>
Copy to Clipboard Copied! -
などの標準の Java EE サードパーティーソフトウェアのパッケージ名を提供することはできますが
org.apache
、通常は移行に影響を及ぼさないので、パッケージ名を含めないことが推奨されます。