17370845950

本文旨在指导开发者将基于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：

    
        
        jakartaee-9.1

        
        
        
        
    

    
    

    
    
    
    
    

选择特性版本说明：

• 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客户端依赖的示例：

    
    

    
    
    
    
        org.apache.activemq
        artemis-jakarta-client
        2.20.0 
    

    
    
        jakarta.platform
        jakarta.jakartaee-api
        9.1.0 
        provided 
    

    

注意事项：

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带来的优势。在整个迁移过程中，细致的版本兼容性检查和全面的测试是确保应用稳定运行的关键。