一个简化 Java 应用升级的开源项目：EMT4J

来源：InfoQ，作者 | Johan Janssen、译者 | 张卫滨、策划 | 丁晓昀

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 文件所定义的说明添加自定义规则。