常见需要替换升级模块

1. Servlet API (javax.servlet → jakarta.servlet)

背景：Servlet API 是Java Web应用的核心，用于处理HTTP请求和响应。随着Java EE向Jakarta EE的迁移，javax.servlet 包名被替换为 jakarta.servlet。
操作建议：
如果你的应用使用Spring Boot，并且依赖于Tomcat、Jetty或Undertow作为Servlet容器，需要将依赖从javax.servlet-api迁移到jakarta.servlet-api。
确保使用jakarta.servlet-api版本5.0或更高版本。

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>5.0.0</version>
    <scope>provided</scope>
</dependency>

2. JPA / Hibernate (javax.persistence → jakarta.persistence)

背景：JPA（Java Persistence API）是Java EE中用于对象关系映射的标准API，而Hibernate是其最流行的实现之一。随着迁移，javax.persistence 包名被替换为 jakarta.persistence。
操作建议：
如果你的应用使用JPA（Hibernate），需要升级到Hibernate 6+，因为这是第一个支持jakarta.persistence的版本。
替换代码中所有javax.persistence.注解为jakarta.persistence.。

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.0.0</version>
</dependency>

3. JAX-RS / REST (javax.ws.rs → jakarta.ws.rs)

背景：JAX-RS（Java API for RESTful Web Services）是Java EE中用于构建RESTful Web服务的标准API。随着迁移，javax.ws.rs 包名被替换为 jakarta.ws.rs。
操作建议：
如果你的应用使用RESTEasy、Jersey或其他JAX-RS实现，需要切换到jakarta.ws.rs-api依赖。

<dependency>
    <groupId>jakarta.ws.rs</groupId>
    <artifactId>jakarta.ws.rs-api</artifactId>
    <version>3.0.0</version>
</dependency>

4. JSP / JSF (javax.faces, javax.servlet.jsp → jakarta.faces, jakarta.servlet.jsp)

背景：JSP（JavaServer Pages）和JSF（JavaServer Faces）是Java EE中用于构建Web界面的技术。随着迁移，相关包名也发生了变化。
操作建议：
如果你的应用使用JSP或JSF，需要升级相关依赖。

<dependency>
    <groupId>jakarta.faces</groupId>
    <artifactId>jakarta.faces-api</artifactId>
    <version>3.0.0</version>
</dependency>

5. Bean Validation (javax.validation → jakarta.validation)

背景：Bean Validation是Java EE中用于验证JavaBean的标准API。随着迁移，javax.validation 包名被替换为 jakarta.validation。
操作建议：
如果你的应用使用Hibernate Validator，需要切换到支持jakarta.validation的版本。

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>8.0.0</version>
</dependency>

6. JMS (javax.jms → jakarta.jms)

背景：JMS（Java Message Service）是Java EE中用于消息传递的标准API。随着迁移，javax.jms 包名被替换为 jakarta.jms。
操作建议：
如果你的应用使用ActiveMQ或其他消息提供者，需要确保它们支持jakarta.jms。

<dependency>
    <groupId>jakarta.jms</groupId>
    <artifactId>jakarta.jms-api</artifactId>
    <version>3.0.0</version>
</dependency>

7. Mail (javax.mail → jakarta.mail)

背景：JavaMail是Java EE中用于发送和接收电子邮件的API。随着迁移，javax.mail 包名被替换为 jakarta.mail。
操作建议：
如果你的应用使用JavaMail，需要切换到jakarta.mail。

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>jakarta.mail</artifactId>
    <version>2.0.0</version>
</dependency>

其他部分

XML JAXB

XML JAXB（Java Architecture for XML Binding）是 Java 平台中的一个框架，用于将 Java 对象与 XML 数据之间进行转换。它是 Java 的标准 API

旧版本

JAXBContext context = JAXBContext.newInstance(objectType);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
marshaller.setProperty(Marshaller.JAXB_ENCODING, charset);
ByteArrayOutputStream bos = new ByteArrayOutputStream();
XMLSerializer serial = new XMLSerializer();
serial.setOutputByteStream(bos);
marshaller.marshal(xmlObject, serial.asContentHandler());
return bos.toString();

新版本

pom.xml 依赖

<!-- JAXB API -->
        <dependency>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
        </dependency>
        <!-- JAXB 实现 -->
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
        </dependency>

转换对象


public class MarshallerUtil {

    public static <T> String toXmlString(T object) throws Exception {
        // Create a JAXB context for the root class
        JAXBContext context = JAXBContext.newInstance(ContentRoot.class);

        // Create a marshaller
        Marshaller marshaller = context.createMarshaller();
        marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);

        // Serialize Java object to XML
        StringWriter writer = new StringWriter();
        marshaller.marshal(object, writer);
        return writer.toString();
    }

    public static <T> T toJAXB(Class<T> clazz, String xml) throws Exception {
        // Create a JAXB context for the root class
        JAXBContext context = JAXBContext.newInstance(clazz);

        // Create an unmarshaller
        Unmarshaller unmarshaller = context.createUnmarshaller();

        // Deserialize XML to Java object
        return (T) unmarshaller.unmarshal(new StringReader(xml));
    }
}

工具

Apache Tomcat Jakarta EE迁移工具

Apache Tomcat Jakarta EE迁移工具是一个强大的开源工具，专门用于将基于Java EE 8的应用程序迁移到Jakarta EE 9。它能够自动将javax.*命名空间中的包和类迁移到jakarta.*命名空间

GitCode - tomcat-jakartaee-migration

java -jar jakartaee-migration-*.jar <source> <destination>

jdk21 升级 - javax -> jakarta