jakarta-namespace

Jakarta EE Namespace Migration Skill

Overview

Spring Boot 3.0 has upgraded from Java EE to Jakarta EE APIs for all dependencies. This is one of the most significant breaking changes and requires updating all javax.* package imports to jakarta.*.

Important: Packages such as javax.sql.* and javax.crypto.* will NOT change to jakarta.* as they are part of the Java 17+ JDK itself, not part of Java EE.

Required Package Mappings

Before (Java EE)	After (Jakarta EE)
javax.persistence.*	jakarta.persistence.*
javax.validation.*	jakarta.validation.*
javax.servlet.*	jakarta.servlet.*
javax.annotation.*	jakarta.annotation.*
javax.transaction.*	jakarta.transaction.*
javax.ws.rs.*	jakarta.ws.rs.*
javax.mail.*	jakarta.mail.*
javax.jms.*	jakarta.jms.*
javax.xml.bind.*	jakarta.xml.bind.*

Affected Annotations and Classes

Persistence (JPA)

• @Entity, @Table, @Column
• @Id, @GeneratedValue
• @ManyToOne, @OneToMany, @ManyToMany, @OneToOne
• @JoinColumn, @JoinTable
• @PrePersist, @PreUpdate, @PostLoad
• @Enumerated, @Temporal
• EntityManager, EntityManagerFactory
• EntityNotFoundException

Validation

• @Valid
• @NotNull, @NotBlank, @NotEmpty
• @Size, @Min, @Max
• @Email, @Pattern
• @Positive, @Negative
• @Past, @Future

Servlet

• HttpServletRequest, HttpServletResponse
• ServletException
• Filter, FilterChain
• HttpSession, Cookie

Migration Commands

Step 1: Find All javax Imports That Need Migration

# List all files with javax imports that need migration (excludes JDK packages)
grep -r "import javax\." --include="*.java" . | grep -v "javax.sql" | grep -v "javax.crypto" | grep -v "javax.net"

Step 2: Batch Replace All Namespaces

# Replace javax.persistence with jakarta.persistence
find . -name "*.java" -type f -exec sed -i 's/import javax\.persistence/import jakarta.persistence/g' {} +

# Replace javax.validation with jakarta.validation
find . -name "*.java" -type f -exec sed -i 's/import javax\.validation/import jakarta.validation/g' {} +

# Replace javax.servlet with jakarta.servlet
find . -name "*.java" -type f -exec sed -i 's/import javax\.servlet/import jakarta.servlet/g' {} +

# Replace javax.annotation (common ones used in Spring)
find . -name "*.java" -type f -exec sed -i 's/import javax\.annotation\.PostConstruct/import jakarta.annotation.PostConstruct/g' {} +
find . -name "*.java" -type f -exec sed -i 's/import javax\.annotation\.PreDestroy/import jakarta.annotation.PreDestroy/g' {} +
find . -name "*.java" -type f -exec sed -i 's/import javax\.annotation\.Resource/import jakarta.annotation.Resource/g' {} +

# Replace javax.transaction with jakarta.transaction
find . -name "*.java" -type f -exec sed -i 's/import javax\.transaction/import jakarta.transaction/g' {} +