Intellij IDEA 插件指南

Migration Toolkit for Applications 5.3

使用 IntelliJ IDEA 的 Migration Toolkit for Applications 插件分析应用程序，并解决迁移问题。

摘要

本指南论述了如何为 IntelliJ IDEA 使用 Migration Toolkit for Applications 插件来简化 Java 应用程序的迁移。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情，请参阅我们的首席技术官 Chris Wright 提供的消息。

第 1 章简介
复制链接

1.1. 关于 IntelliJ IDEA 的 MTA 插件
复制链接

您可以使用 IntelliJ IDEA 的 Migration Toolkit for Applications (MTA) 插件来迁移和现代化应用程序。

MTA 插件利用自定义规则集来分析您的项目，标记源代码中的问题，提供指导来修复问题，并提供自动代码替换（如果可能）。

该插件支持社区版本和 IntelliJ IDEA 的 Ultimate 版本。

1.2. 关于 Migration Toolkit for Applications
复制链接

什么是 Migration Toolkit for Applications?

Migration Toolkit for Applications (MTA)是一个可扩展、可自定义的基于规则的工具，简化了 Java 应用程序的迁移和现代化。

MTA 检查应用程序工件，包括项目源目录和应用程序存档，然后生成 HTML 报告突出显示需要更改的区域。MTA 支持许多迁移路径，包括以下示例：

升级至 Red Hat JBoss Enterprise Application Platform 的最新版本
从 Oracle WebLogic 或 IBM WebSphere Application Server 迁移到 Red Hat JBoss Enterprise Application Platform
容器化应用程序并使之成为云就绪
从 Java Spring Boot 迁移到 Quarkus
从 Oracle JDK 更新至 OpenJDK

有关用例和迁移路径的更多信息，请参阅适用于开发人员网页的 MTA。

Migration Toolkit for Applications 如何简化迁移？

Migration Toolkit for Applications 会查找常见资源和在迁移应用程序时的已知问题。它为应用程序使用的技术提供了高级视图。

MTA 生成详细的报告，评估迁移或现代化路径。此报告可帮助您估算大型项目所需的工作量，并减少涉及的工作。

如何了解更多信息？

参阅 Migration Toolkit for Applications 简介，了解有关 Migration Toolkit for Applications 中的功能、支持的配置、系统要求以及可用工具的更多信息。

第 2 章为 IntelliJ IDEA 安装 MTA 插件
复制链接

您可以在 IntelliJ IDEA 的 Ultimate 和 Community Edition 版本中安装 MTA 插件。

先决条件

安装了 Java 开发套件 (JDK)。MTA 支持以下 JDK：
- OpenJDK 11
- Oracle JDK 11
8 GB RAM
macOS 安装： maxproc 的值必须是 2048 或更高版本。
来自 MTA 下载页面的最新版本的 mta-cli。

流程

在 IntelliJ IDEA 中，点欢迎屏幕上的 Plugins 选项卡。
在 Marketplace 选项卡上的 Search 字段中输入 Migration Toolkit for Applications。
选择 Red Hat 插件的 Migration Toolkit for Applications (MTA) 并点 Install。
该插件在 Installed 选项卡上列出。

第 3 章使用 MTA 插件分析项目
复制链接

您可以通过 MTA 插件创建运行配置并运行分析来分析您的项目。

3.1. 创建运行配置
复制链接

您可以创建多个运行配置，以针对导入到 IntelliJ IDEA 的每个项目运行。

流程

在 Projects 视图中，点您要分析的项目。
在屏幕的左侧，点 Migration Toolkit for Applications 选项卡。
如果这是您的第一个配置，则右侧会显示 run 配置面板。
如果这不是您的第一个配置，请在列表中右键单击配置并选择新建配置。
运行的配置面板显示在右侧。
完成以下配置字段：
- mta-cli: 点 Add, 选择文件路径，点 Save。
- Input: 点 Add 并输入输入文件或路径。
- 目标：选择一个或多个目标迁移路径。
  注意
  在 Output 中显示的位置由插件设置。
在配置列表中，右键单击新配置并选择 Run Analysis。
Console (MTA) 终端模拟器会打开，显示有关分析进度的信息。
分析完成后，您可以点击您运行的配置文件名称下面的报告或结果。
- 报告将打开 MTA 报告，该报告描述了迁移或现代化应用程序前需要解决的所有问题。有关更多信息，请参阅 CLI 指南中的 MTA 报告。
- 结果将打开每个应用程序显示提示（签发）的目录。

第 4 章检查并解决迁移问题
复制链接

您可以在左侧窗格中查看并解决由 MTA 插件识别的迁移问题。

4.1. 检查问题
复制链接

您可以使用 MTA 插件图标根据问题的严重性确定优先级。您可以看到哪些问题有 快速修复 自动代码替换，而这些代码没有。

分析结果以目录格式显示，显示所分析的每个应用的 hints 和 classifications。

hint 是包含单一问题的代码只读片段，在您可以进行现代化或迁移应用程序前必须解决。通常，建议您接受或忽略这个快速修复。

classification 是一个有问题但没有任何推荐的快速修复的文件。您可以编辑分类。

流程

在 Migration Toolkit for Applications 视图中，在左侧窗格中选择运行配置目录。
点 Results。
显示运行配置的模块和应用，其中包含每个应用程序下的提示和分类。
根据以下图标排序问题，这些图标会显示在每个提示旁边：
- ：您必须解决这个问题才能迁移或现代化应用程序。
- ：您可能需要解决这个问题以迁移或现代化应用程序
可选：要了解更多有关提示的信息，请右键单击它并选择显示更多信息。

4.2. 解决问题
复制链接

您可以通过执行以下操作之一解决问题：

使用快速修复来修复具有提示的代码片段
编辑分类中出现的文件代码

4.2.1. 使用快速修复
复制链接

您可以使用快速修复自动代码替换来节省时间并确保解决重复性问题的一致性。对于 Results 目录的 Hints 部分显示的许多问题，可以快速修复。

流程

在左侧窗格中，点带有错误指示符的提示。
任何快速修复都会以子文件夹的形式显示，并带有快速修复图标( )。
右键点击 Quick Fix 并选择 Preview Quick Fix。
当前的代码和推荐的更改在 Preview Quick Fix 窗口中显示。
要接受推荐的修复，请点 Apply Quick Fix。
可选：在问题右键并选择 Mark As Complete。
提示会显示绿色检查( )，替换错误指示器。

4.2.2. 编辑文件代码
复制链接

您可以直接编辑在 Results 目录的 Classifications 部分中显示的文件。这些文件没有任何快速修复。

流程

在左侧窗格中，点您要编辑的文件。
进行代码所需的任何更改，并保存文件。
可选：在问题右键并选择 Mark as Complete 或 Delete。
如果选择 Mark as Complete，提示会显示绿色检查( )，替换错误指示器。

Intellij IDEA 插件指南

使用 IntelliJ IDEA 的 Migration Toolkit for Applications 插件分析应用程序，并解决迁移问题。

使开源包含更多
复制链接