本文旨在指导开发者将基于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>
注意事项：
- 版本兼容性： 务必检查您所使用的ActiveMQ Artemis服务器版本、artemis-jakarta-client客户端库版本以及OpenLiberty所支持的Jakarta EE版本之间的兼容性。通常，较新版本的ActiveMQ Artemis客户端会提供对Jakarta JMS的良好支持。
- 代码修改： 在Maven依赖更新后，您还需要修改应用代码中所有引用javax.jms和javax.jws等包的地方，将其替换为jakarta.jms和jakarta.jws。这通常可以通过IDE的全局查找替换功能辅助完成，但仍需人工检查以确保逻辑正确性。
- 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带来的优势。在整个迁移过程中，细致的版本兼容性检查和全面的测试是确保应用稳定运行的关键。
