Compétence Migration javax → jakarta

Quand l'utiliser

• Mise à jour vers Tomcat 11 / Jakarta EE 10+
• Un examen de code détecte des imports javax.*
• Migration d'un projet existant vers l'espace de noms jakarta

Procédure

Étape 1 — Scanner l'utilisation de javax

Recherchez dans la codebase tous les imports javax.* nécessitant une migration :

javax.servlet.*      → jakarta.servlet.*
javax.persistence.*  → jakarta.persistence.*
javax.validation.*   → jakarta.validation.*
javax.annotation.*   → jakarta.annotation.*
javax.inject.*       → jakarta.inject.*
javax.enterprise.*   → jakarta.enterprise.*
javax.faces.*        → jakarta.faces.*
javax.ws.rs.*        → jakarta.ws.rs.*
javax.el.*           → jakarta.el.*
javax.json.*         → jakarta.json.*
javax.mail.*         → jakarta.mail.*
javax.websocket.*    → jakarta.websocket.*

Ne pas migrer les éléments suivants (ils restent en javax.*) :

• javax.sql.* — partie du JDK
• javax.naming.* — partie du JDK (JNDI)
• javax.crypto.* — partie du JDK
• javax.net.* — partie du JDK
• javax.security.auth.* — partie du JDK
• javax.swing.*, javax.xml.parsers.* — packages JDK

Étape 2 — Mettre à jour pom.xml

Remplacez les coordonnées des dépendances :

Étape 3 — Mettre à jour web.xml (si présent)

<!-- Ancien espace de noms -->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="4.0">

<!-- Nouvel espace de noms -->
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee" version="6.0">

Étape 4 — Mettre à jour les fichiers source Java

Remplacez tous les imports javax. par leurs équivalents jakarta. dans les fichiers .java.

Étape 5 — Vérifier

1. Exécutez mvn clean compile ou gradlew build — corrigez les erreurs de compilation
2. Exécutez mvn test ou gradlew test — assurez-vous que tous les tests passent
3. Recherchez les imports javax.* restants (en excluant les packages JDK)

Sortie

Fournissez un résumé de migration listant tous les fichiers modifiés, les imports remplacés et toutes les étapes manuelles requises.