Configurez un projet Maven / Gradle avec des dépendances JAX-RS comme Jersey; 2. Créez une ressource REST en utilisant des annotations telles que @Path et @get; 3. Configurez l'application via une sous-classe d'application ou web.xml; 4. Ajouter Jackson pour la liaison de JSON en incluant Jersey-Media-Json-Jackson; 5. Déployer sur un serveur Jakarta EE ou un conteneur servlet et tester avec des outils comme Curl; Jakarta EE fournit une plate-forme standardisée de qualité d'entreprise pour créer des API reposantes fiables et portables en utilisant les spécifications officielles de Java, ce qui le rend idéal pour les environnements hiérarchisés par la stabilité et le support à long terme.

La construction d'API RESTful en Java avec Jakarta EE est un choix solide pour les applications de qualité d'entreprise qui apprécient la stabilité, la conformité des normes et l'intégration avec l'écosystème Java plus large. Jakarta EE (anciennement Java EE) fournit une plate-forme robuste et axée sur les spécifications pour développer des services de repos évolutifs et maintenables à l'aide de Jax-RS (Jakarta Restful Web Services).

Voici comment construire une API RESTful en Java en utilisant Jakarta EE:

1. Configurez votre projet Jakarta EE

Commencez par configurer un projet Maven ou Gradle avec les dépendances nécessaires. Si vous utilisez Maven , incluez l'API JAX-RS et un runtime compatible comme Eclipse Jersey (implémentation de référence) ou Apache CXF , ou déploie sur un serveur Jakarta EE complet comme Payara , Wildfly ou Open Liberty .

Exemple d'extrait pom.xml à l'aide de Jersey:

 <dépendances>
    <dépendance>
        <GroupId> org.glassfish.jersey.core </romproudID>
        <ArtefactId> Jersey-Server </Retifactid>
        <version> 3.1.3 </ version>
    </Dependance>
    <dépendance>
        <GroupId> org.glassfish.jersey.Containers </rombandid>
        <ArtefactId> Jersey-Container-Service </ ArfactId>
        <version> 3.1.3 </ version>
    </Dependance>
    <dépendance>
        <GroupId> org.glassfish.jersey.inject </rom grouped>
        <ArtefactId> Jersey-Hk2 </letefactive>
        <version> 3.1.3 </ version>
    </Dependance>
</DENDENDENCES>

Ou, si vous utilisez un serveur d'applications Jakarta EE complet (comme Payara), la plupart des API sont déjà incluses.

2. Créez une classe de ressources de repos

Utilisez des annotations JAX-RS pour définir les points d'extrémité. Le @Path , @GET , @Produces , etc., facilite la cartographie des méthodes HTTP sur les méthodes Java.

 import jakarta.ws.rs. *;
import jakarta.ws.rs.core.mediaType;
import jakarta.ws.rs.core.Response;

@Path ("/ utilisateurs")
@Produces (mediatype.application_json)
classe publique userresource {

    @OBTENIR
    Réponse publique getAlLUSERS () {
        // en pratique, récupérer à partir d'un service ou d'une base de données
        var utilisateurs = java.util.list.of (
            nouvel utilisateur (1L, "Alice"),
            nouvel utilisateur (2L, "Bob")
        ));
        return réponse.ok (utilisateurs) .build ();
    }

    @OBTENIR
    @Path ("/ {id}")
    Réponse publique GetUserById (@PathParam ("id") Long ID) {
        if (id == 1) {
            return réponse.ok (nouvel utilisateur (1L, "Alice")). build ();
        } autre {
            return réponse.status (réponse.status.not_found) .build ();
        }
    }

    @POSTE
    @Consumes (mediatype.application_json)
    Réponse publique CreateUser (utilisateur utilisateur) {
        // Simuler la création
        user.setid (3l); // Attribuez l'ID
        return réponse.status (réponse.status.Created) .entity (utilisateur) .build ();
    }
}

Et un enregistrement ou une classe User simple:

 Utilisateur d'enregistrement public (ID long, nom de cha?ne) {
    public void setid (long id) {
        // nécessaire pour certains mappeurs JSON si vous utilisez un comportement mutable
    }
}

3. Configurer l'application

Vous pouvez laisser JAX-RS Discover les ressources ou créer une sous-classe Application pour les enregistrer explicitement.

 import jakarta.ws.rs.core.application;
import java.util.set;

La classe publique RestApplication étend l'application {
    @Outrepasser
    Set public <class <? >> getClasses () {
        Set <class <? >> Classes = new Java.util.hashSet <> ();
        classes.add (userresource.class);
        Retour des classes;
    }
}

Ensuite, inscrivez-vous dans web.xml (si l'utilisation):

 <web-app>
    <Serplet>
        <Servlet-name> javax.ws.rs.core.application </vrlet-name>
        <servlet-Class> org.glassfish.jersey.servlet.servletContainer </ servlet-Class>
        <IniT-PARAM>
            <Am param-name> jakarta.ws.rs.application </onsam-name>
            <param-valeur> com.example.restapplication </ param-Value>
        </itnit-Param>
        <Charot-on-startup> 1 </ Load-on-Startup>
    </vrlet>
    <mappage servlet>
        <Servlet-name> javax.ws.rs.core.application </vrlet-name>
        <url-sattern> / api / * </ url-sattern>
    </ serflet-mapping>
</ web-app>

Alternativement, les applications modernes Jakarta EE peuvent omettre web.xml et s'appuyer sur des annotations.

4. Ajouter le support JSON (Moxy ou Jackson)

Par défaut, Jersey utilise Moxy pour la liaison JSON. Vous pouvez passer à Jackson pour plus de flexibilité:

Ajouter à pom.xml :

 <dépendance>
    <GroupId> org.glassfish.jersey.media </rom grouped>
    <ArtefactId> Jersey-Media-Json-Jackson </Retifactid>
    <version> 3.1.3 </ version>
</Dependance>

Enregistrez ensuite le JacksonFeature dans votre classe Application ou via les paramètres d'initiation Web.xml.

5. Déployer et tester

Déployez votre fichier de guerre dans un conteneur Jakarta EE ou Servlet:

• HAUTONNEMENT : Utilisez la jetée intégrée ou le tomcat avec le maillot.
• Plateforme complète : Déployez sur Payara Micro , Wildfly ou Open Liberty pour les fonctionnalités complètes de Jakarta EE.

Tester avec curl :

 Curl http: // localhost: 8080 / yourApp / API / utilisateurs
# Renvoie: [{"id": 1, "name": "Alice"}, {"id": 2, "name": "bob"}]

Avantages clés de Jakarta EE pour les API de repos

• Standardisé : JAX-RS est une spécification - portable entre les implémentations.
• Injection de dépendance : utilisez @Inject avec CDI pour une intégration de couche de service propre.
• Sécurité : intégrer à Jakarta Security ( @RolesAllowed , etc.).
• Validation : utilisez la validation du bean ( @NotNull , @Size ) sur les corps de demande.
• Traitement asynchrone : Prise en charge de AsyncResponse pour les taches de longue date.

Exemple avec CDI:

 @Path ("/ utilisateurs")
@RequestScoped
classe publique userresource {

    @Injecter
    UserService UserService;

    @OBTENIR
    Réponse publique getall () {
        return réponse.ok (userservice.getall ()). build ();
    }
}

La construction d'API RESTful avec Jakarta EE vous donne une base mature et prête à l'entreprise. Alors que les nouveaux frameworks comme Spring Boot sont plus populaires pour les microservices, Jakarta EE reste une alternative solide et basée sur des normes - en particulier dans les environnements où la portabilité et le support à long terme sont importants.

Fondamentalement, si vous souhaitez construire des API fiables et maintenables en utilisant des normes Java officielles, Jakarta EE avec Jax-RS est un chemin éprouvé. Choisissez simplement votre runtime, définissez vos ressources et allez.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!