JDK8到JDK17迁移优化指南

本文针对开发者从JDK 8和Java EE迁移至JDK 17和Jakarta EE环境，提供了一份详尽的优化指南。升级的关键在于理解Java EE到Jakarta EE的转变，特别是javax包名到jakarta包名的变更。文章推荐使用OpenLiberty作为轻量级的应用服务器，它完美支持JDK 17和Jakarta EE规范。同时，本文详细介绍了OpenLiberty的特性配置，指导开发者如何在server.xml中配置Jakarta WS和Jakarta JMS。针对消息中间件，重点讲解了ActiveMQ Artemis在Jakarta JMS环境下的依赖更新，包括如何替换旧的javax.jms依赖，并添加artemis-jakarta-client依赖，确保应用平滑过渡到新的Jakarta EE生态，充分利用现代化技术的优势。

本文旨在指导开发者将基于JDK 8和Java EE的应用迁移至JDK 17和Jakarta EE环境。重点探讨了javax到jakarta包名的变更影响，并推荐OpenLiberty作为轻量级、可组合的应用服务器替代方案，以支持Jakarta WS和Jakarta JMS规范。文章将详细介绍OpenLiberty的特性配置，并提供ActiveMQ Artemis在Jakarta JMS环境下的依赖更新指导，帮助读者实现平滑高效的现代化升级。

理解迁移挑战：从Java EE到Jakarta EE

随着Java生态系统的演进，从JDK 8升级到JDK 17（LTS版本）已成为许多企业应用现代化的重要步骤。此次升级不仅带来了性能提升和新语言特性，更重要的是，它伴随着Java EE向Jakarta EE的转型。这一转型最显著的变化是API包名的重构：所有javax.*包都被替换为jakarta.*。对于依赖JAX-WS（现在是Jakarta WS）和JMS（现在是Jakarta JMS）等核心Java EE规范的应用而言，这意味着代码层面的调整以及选择兼容的运行时环境。

传统的Java EE应用服务器如WildFly功能强大但资源占用较高，对于追求轻量化、快速启动和更细粒度控制的现代微服务或云原生应用而言，寻找一个更轻量级的替代方案变得尤为重要。

OpenLiberty：轻量级Jakarta EE服务器之选

在寻求WildFly的轻量级替代方案时，OpenLiberty是一个极具吸引力的选择。OpenLiberty是IBM开发的开源应用服务器，以其模块化、可组合性和快速启动而闻名。它完美支持JDK 17以及Jakarta EE 8和Jakarta EE 9（及更高版本），能够无缝处理jakarta包名规范。

OpenLiberty的优势：

• 轻量级与可组合性： OpenLiberty允许开发者根据实际需求选择和加载特定的Jakarta EE特性，避免了加载不必要的组件，从而显著减少内存占用和启动时间。
• JDK 17兼容： 完全支持Java 17，确保应用能够利用最新的JDK特性和性能优化。
• Jakarta EE支持： 兼容Jakarta EE 8和Jakarta EE 9，这意味着它能原生支持Jakarta WS和Jakarta JMS等规范。
• 开发友好： 提供了热部署、快速迭代等特性，极大提升开发效率。

配置Jakarta WS和Jakarta JMS

在OpenLiberty中，通过server.xml配置文件来声明和启用所需的Jakarta EE特性。对于需要支持Jakarta WS和Jakarta JMS的应用，您需要在featureManager块中添加相应的特性。

以下是一个server.xml的示例配置，展示了如何启用Jakarta EE 9.1的完整特性，或更细粒度地启用Jakarta WS和Jakarta JMS：

<server description="My Jakarta EE Application Server">
    <featureManager>
        <!-- 启用整个Jakarta EE 9.1平台，包含了所有子特性 -->
        <feature>jakartaee-9.1</feature>

        <!-- 或者，如果您只想启用特定的特性，可以这样配置： -->
        <!-- <feature>jaxws-2.3</feature>  for Jakarta WS (part of Jakarta EE 9) -->
        <!-- <feature>jms-3.0</feature>   for Jakarta JMS (part of Jakarta EE 9) -->
        <!-- 如果是Jakarta EE 8，则使用 jaxws-2.2 和 jms-2.0 -->
    </featureManager>

    <!-- 其他服务器配置，如HTTP端口、数据源等 -->
    <httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="9080" httpsPort="9443"/>

    <!-- JMS消息提供者配置示例 (ActiveMQ Artemis) -->
    <!-- 通常通过JMS资源适配器或直接的JMS连接工厂配置 -->
    <!-- 例如，如果使用JMS资源适配器，可能需要配置如下： -->
    <!-- <jmsConnectionFactory id="myJmsConnectionFactory" jndiName="jms/myCF">
        <properties.artemis brokerUrl="tcp://localhost:61616"/>
    </jmsConnectionFactory> -->
    <!-- 具体的JMS配置会根据您的ActiveMQ Artemis部署方式而有所不同 -->

</server>

选择特性版本说明：

• jakartaee-9.1: 包含了所有Jakarta EE 9.1规范的实现，这是最全面的选择。
• jaxws-2.3: 对应Jakarta WS 3.0规范（Jakarta EE 9）。
• jms-3.0: 对应Jakarta JMS 3.0规范（Jakarta EE 9）。
• 如果您的应用是基于Jakarta EE 8，则应选择jaxws-2.2和jms-2.0特性。

ActiveMQ Artemis与Jakarta JMS依赖更新

在从JDK 8和javax.jms迁移到JDK 17和jakarta.jms时，ActiveMQ Artemis客户端库也需要相应更新。原先用于Java EE环境的artemis-jms-client或activemq-all依赖不再适用于Jakarta EE环境，因为它们仍然使用javax包。

对于Jakarta JMS，您需要使用ActiveMQ Artemis提供的支持jakarta命名空间的客户端库。通常，这意味着选择artemis-jakarta-client依赖。请务必根据您使用的ActiveMQ Artemis服务器版本和Jakarta EE版本，选择兼容的客户端库版本。

以下是Maven pom.xml中更新ActiveMQ Artemis客户端依赖的示例：

<dependencies>
    <!-- 移除旧的javax.jms依赖，例如： -->
    <!--
    <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>artemis-jms-client</artifactId>
        <version>2.4.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>activemq-all</artifactId>
        <version>5.15.2</version>
    </dependency>
    -->

    <!-- 添加支持Jakarta JMS的ActiveMQ Artemis客户端依赖 -->
    <!-- 请根据您使用的Artemis版本和Jakarta EE版本选择兼容的客户端版本 -->
    <!-- 例如，对于Artemis 2.20.0及以上版本，通常支持Jakarta EE 9/10 -->
    <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>artemis-jakarta-client</artifactId>
        <version>2.20.0</version> <!-- 请替换为您的Artemis版本，确保兼容Jakarta EE -->
    </dependency>

    <!-- 如果您的应用直接使用了Jakarta EE API，也需要添加相关API依赖 -->
    <dependency>
        <groupId>jakarta.platform</groupId>
        <artifactId>jakarta.jakartaee-api</artifactId>
        <version>9.1.0</version> <!-- 或更高版本，取决于您的Jakarta EE版本 -->
        <scope>provided</scope> <!-- 通常由应用服务器提供 -->
    </dependency>

    <!-- 其他项目依赖 -->
</dependencies>

注意事项：

1. 版本兼容性： 务必检查您所使用的ActiveMQ Artemis服务器版本、artemis-jakarta-client客户端库版本以及OpenLiberty所支持的Jakarta EE版本之间的兼容性。通常，较新版本的ActiveMQ Artemis客户端会提供对Jakarta JMS的良好支持。
2. 代码修改： 在Maven依赖更新后，您还需要修改应用代码中所有引用javax.jms和javax.jws等包的地方，将其替换为jakarta.jms和jakarta.jws。这通常可以通过IDE的全局查找替换功能辅助完成，但仍需人工检查以确保逻辑正确性。
3. JMS连接配置： 确保您的JMS连接工厂配置（无论是通过JNDI查找还是直接编程创建）适配了ActiveMQ Artemis和Jakarta JMS规范。

总结

将Java EE应用从JDK 8迁移到JDK 17和Jakarta EE是一个涉及多方面的升级过程。选择OpenLiberty作为轻量级应用服务器，可以有效降低运行成本并提高开发效率。通过正确配置OpenLiberty的Jakarta EE特性和更新ActiveMQ Artemis的Jakarta JMS客户端依赖，开发者可以顺利完成应用的现代化改造，使其能够充分利用JDK 17和Jakarta EE带来的优势。在整个迁移过程中，细致的版本兼容性检查和全面的测试是确保应用稳定运行的关键。

理论要掌握，实操不能落！以上关于《JDK8到JDK17迁移优化指南》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！