附录 A. 参考资料
A.1. Maven 插件参数
以下是可用 MTA Maven 插件参数的详细描述。
参数 | 描述 |
---|---|
customLoggingPropertiesFile |
一个到包含 |
disableTattletale |
可禁用 Tattletale 报告的生成标志。如果同时将 |
enableCompatibleFilesReport | 启用生成可组合文件报告的标志。由于处理的所有文件都未发现问题,对于大型应用程序,此报告可能需要很长时间才能完成。 |
enableTattletale |
用于为每个应用程序生成 Tattletale 报告的标志。当 |
excludePackages | 要从评估中排除的软件包列表。例如,输入 "com.mycompany.commonutilities" 将排除所有软件包名称以"com.mycompany.commonutilities"开头的类。 |
excludeTags | 要排除的标签列表。指定后,不会处理具有这些标签的规则。 |
explodedApps | 指定提供的输入目录包含单个应用程序的源文件的标志。详情请参阅 输入文件机构表。 |
exportCSV |
标志,将报告数据导出到本地文件系统中的 CSV 文件。MTA 在由 |
includeTags | 要使用的标签列表。指定后,仅处理具有这些标签的规则。 |
inputDirectory |
指定包含要分析的应用程序的目录路径。此参数默认为 |
keepWorkDirs | 标记指示 MTA 不删除临时工作文件,如图形数据库和解压缩存档。这对于调试非常有用。 |
软件包 | MTA 要评估的软件包列表。此参数是必需的。如需更多信息,请参阅选择软件包。 |
offlineMode | 以离线模式运行的标记,禁用网络访问功能,如验证方案。用于提高性能。 |
outputDirectory |
指定输出 MTA 生成的报告信息的目录路径。此参数默认为 |
覆盖 |
用于强制删除 警告 请注意不要指定包含重要信息的报告输出目录! |
sourceTechnologies |
从迁移的一个或多个源技术、服务器、平台或框架的列表。这个参数与 |
sourceMode |
用于表示要评估的应用包含源文件而非编译的二进制文件的标志。默认为 |
targetTechnologies |
要迁移至的一个或多个目标技术、服务器、平台或框架的列表。这个参数与 |
userIgnorePath | 指定 MTA 以确定应忽略的文件的位置。 |
userRulesDirectory |
指定用于查找自定义 MTA 规则的位置。该值可以是包含规则集文件或单个规则集文件的目录。ruleset 文件必须使用 |
windupHome | 指向提取的 MTA CLI 的 root 可选参数。通过引用 CLI 的本地安装,Maven 插件可直接访问所有索引,从而提高了性能。 |
windupVersion | 指定要运行的 MTA 版本。默认情况下,这是 Maven 插件的构建版本。 |
A.1.1. 指定输入目录
包含要分析的一个或多个应用程序的文件或目录的路径。默认为 {project.basedir}/src/main/
。
使用
<inputDirectory>INPUT_ARCHIVE_OR_DIRECTORY</inputDirectory>
<inputDirectory>INPUT_ARCHIVE_OR_DIRECTORY</inputDirectory>
根据为 inputDirectory
参数提供的输入文件类型,它会根据提供的附加参数进行评估,如下所示。
- 目录
--explodedApp --sourceMode 没有参数 目录作为单个应用进行评估。
目录作为单个应用进行评估。
每个子目录都作为应用进行评估。
- File
--explodedApp --sourceMode 没有参数 参数将被忽略;该文件将评估为单个应用。
该文件作为压缩的项目进行评估。
该文件作为单个应用进行评估。
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. 设置 Source Technology
从迁移的一个或多个源技术、服务器、平台或框架的列表。这个参数与 targetTechnologies
参数结合使用有助于确定使用哪个规则集。
使用
<sourceTechnologies> <source>eap:6</source> </sourceTechnologies>
<sourceTechnologies>
<source>eap:6</source>
</sourceTechnologies>
现在,SourceTechnologies
参数提供版本支持,它遵循 Maven 版本范围语法。这指示 MTA 仅运行与指定版本匹配的规则集。例如,<source>eap:5</source>
。
A.1.4. 设置目标机构
要迁移至的一个或多个目标技术、服务器、平台或框架的列表。这个参数与 sourceTechnologies
参数结合使用有助于确定使用哪个规则集。这个参数是必需的
使用
<targetTechnologies> <target>eap:7</target> </targetTechnologies>
<targetTechnologies>
<target>eap:7</target>
</targetTechnologies>
targetTechnologies
参数现在提供版本支持,它遵循 Maven 版本范围语法。这指示 MTA 仅运行与指定版本匹配的规则集。例如,<target>eap:7</target>
。
迁移到 JBoss EAP 时,请务必在目标中指定版本,例如 eap:6
。仅指定 eap
将针对所有版本的 JBoss EAP 运行规则集,包括与您的迁移路径无关。
请参阅适用于您的源平台的 MTA 入门指南中的 支持的迁移路径。
A.1.5. 选择软件包
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
)提供软件包名称,但通常最好不要包含它们,因为它们不会影响迁移工作。