简化Java应用的升级：Eclipse Migration Toolkit for Java（EMT4J）

Adoptium发布了Eclipse Migration Toolkit for Java（EMT4J），这是一个开源的Eclipse项目，能够分析和升级应用的 Java 版，以便于从 Java 8 升级至 Java 11，从 Java 11 升级至 Java 17。EMT4J 将支持升级到未来的 LTS 版本。

很多组织都建议使用最新的 Java 运行时，以获取安全性和功能方面的改进。同时，长期支持（Long Term Support）的 Java 版本每两年发布一次，Spring Framework 6等项目已经至少需要 Java 17。令人遗憾的是，新 Java 版本的采用是相对缓慢的。例如，在 2022 年，也就是 Java 11 发布四年之后，只有不到 49%的 Java 应用在使用该版本。

将应用升级至较新的 Java 版本意味着开发人员需要解决 Java 内部变更和功能移除所带来的所有问题。这涉及的功能包括 Nashorn、J2EE 和 Java 等包的移除、API 的变更以及对 Java 内部访问更严格的限制。

EMT4J 提供了一个支持 Maven 插件（目前在 Maven 中央仓库尚不可用）、Java 代理以及命令行的解决方案，以便于分析项目与新版本 Java 的不兼容性，结果会以**TXT、JSON或HTML**格式输出。

为了演示 EMT4J，考虑如下的样例应用，它调用了 Java 11 中已经删除的**Thread.stop()**方法：

Thread thread = new Thread();
thread.stop();

在克隆 Git仓库并将 Maven 工具链配置为 JDK 8 和 JDK 11 之后，可以采用如下命令构建项目：

mvn clean package -Prelease

这将会在_emt4j-assembly/target_目录生成一个**.zip**文件，该文件可以进行解压。在解压后的目录中，就可以进行分析了。例如，在命令行中运行如下的命令：

java -cp "lib/analysis/*" org.eclipse.emt4j.analysis.AnalysisMain -f 8 -t 17 
    -o java8to17.html /home/user/application/classes

这将会分析指定目录下的类文件并在_java8to17.html_文件中显示从 Java 8 升级到 Java 17 时的潜在问题。另外，也可以使用归档文件解压后在_bin_目录下的**.bat或.sh脚本来启动命令行分析。README文件描述了分析类和JAR**文件的所有可用选项。

由此生成的 HTML 文件将会展示描述、解决方案和问题的位置：

1.1 Removed API Back to Content
1.1.1 Description
Many of these APIs were deprecated in previous releases and 
    have been replaced by newer APIs.
1.1.2 How to fix
See corresponding JavaDoc.
1.1.3 Issues Context
Location: file:/home/user/application/classes/App.class, 
    Target: java.lang.Thread.stop()V

除此之外，在 Java 应用启动的时候，可以使用EMT4J代理，或者在构建应用的时候使用Maven插件。

该项目包含了从Java 8升级至11和从Java 11升级至17的规则集。例如，用于校验应用是否使用 JDK 内部 API 的JDK内部API规则：

<rule desc="JDK internal API" type="reference-class"   
    match-type="by-package" class-package-file="jdk_internals.cfg"
    result-code="JDK_INTERNAL" must-contain-in-bytecode="true"
    sub-result-code="@{subResultCode}" priority="p4">
    <support-modes>
        <mode>agent</mode>
        <mode>class</mode>
    </support-modes>
</rule>

support-modes表明该规则是否可以用于 agent模式和/或静态分析，其中静态分析也就是class模式，能够用于命令行和 Maven 插件中。关于翻译资源的打包是通过result-code属性实现的，在本例中，也就是_JDK_INTERNAL_，它会映射为_emt4j-common/src/main/resources/default/i18n_目录中的JDK_INTERNAL.properties和JDK_INTERNAL_zh.properties翻译文件。

EMT4J 会扫描应用的中的包和类，比如_emt4j-common/src/main/resources/default/rule/8to11/data/目录中_class-package-file jdk_internals.cfg文件所定义的sun.nio和sun.reflect。

实际的规则类型_reference-class_位于_emt4j-common/src/main/java/org/eclipse/emt4j/common/rule/impl_目录中，因为 JDK 内部规则中，support-modes的值为agent和class。

@RuleImpl(type = "reference-class")
public class ReferenceClassRule extends ExecutableRule {

现有的规则可以提供灵感，以便于按照README文件所定义的说明添加自定义规则。

原文链接：

Eclipse Migration Toolkit for Java (EMT4J) Simplifies Upgrading Java Applications