付録A 参考資料
A.1. Maven プラグイン引数
以下は、利用可能な MTA Maven プラグイン引数の詳細な説明です。
表A.1 MTA Maven プラグイン引数
| 引数 | 説明 |
|---|---|
| customLoggingPropertiesFile |
|
| disableTattletale |
Tattletale レポートの生成を無効にするフラグ。 |
| 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 のバージョンを指定します。デフォルトでは、これは Maven プラグインのビルドバージョンです。 |
A.1.1. 入力ディレクトリーの指定
分析する 1 つ以上のアプリケーションを含むファイルまたはディレクトリーへのパス。デフォルトは {project.basedir}/src/main/ です。
使用方法
<inputDirectory>INPUT_ARCHIVE_OR_DIRECTORY</inputDirectory>
inputDirectory 引数に指定された入力ファイルタイプがファイルであるかディクショナリーであるかに応じて、指定された追加の引数に応じて次のように評価されます。
- ディレクトリー
--explodedApp --sourceMode 引数なし ディレクトリーは 1 つのアプリケーションとして評価されます。
ディレクトリーは 1 つのアプリケーションとして評価されます。
各サブディレクトリーはアプリケーションとして評価されます。
- ファイル
--explodedApp --sourceMode 引数なし 引数は無視されます。ファイルは 1 つのアプリケーションとして評価されます。
ファイルは圧縮プロジェクトとして評価されます。
ファイルは 1 つアプリケーションとして評価されます。
A.1.2. 出力ディレクトリーの指定
MTA が生成したレポート情報を出力するディレクトリーへのパスを指定します。
使用方法
<outputDirectory>OUTPUT_REPORT_DIRECTORY</outputDirectory>
-
省略すると、レポートは
{project.build.directory}/windup-reportディレクトリーに生成されます。 -
出力ディレクトリーが存在する場合は、
overwrite引数の値に基づいて上書きされます。この引数はデフォルトでtrueで、MTA はディレクトリーを削除し、再作成します。
A.1.3. ソーステクノロジーの設定
移行元となる 1 つ以上のソーステクノロジー、サーバー、プラットフォーム、またはフレームワークの一覧。この引数は、targetTechnologies 引数とともに、使用されるルールセットを判断するのに役立ちます。
使用方法
<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 引数は、Maven バージョン範囲の構文 に続くバージョンサポートを提供するようになりました。これにより、指定されたバージョンに一致するルールセットのみを実行するように MTA が指示されます。たとえば、<target>eap:7</target> です。
JBoss EAP に移行する場合は、必ずバージョンをターゲットに指定してください (例: eap:6)。eap のみを指定すると、移行パスに関連しないものを含め、すべてのバージョンの JBoss EAP にルールセットが実行されます。
ソースプラットフォームに適した JBoss EAP バージョンについては、MTA スタートガイド の サポート対象の移行パス を参照してください。
A.1.5. パッケージの選択
MTA が評価するパッケージの一覧。この引数を使用することは強く推奨されます。
使用方法
<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>
-
org.apacheなどの標準の Java EE サードパーティーソフトウェアにパッケージ名を指定することはできますが、通常は移行作業に影響しないため、追加しないことが推奨されます。