REST

Juste pour vous faire réviser un peu les autres cours que vous avez eus sur REST.

Code généré

Le code a généré 2 classes liées à REST, écrites selon la spécification JAX-RS de Jakarta EE :

• La classe de configuration JakartaRestConfiguration pour REST. Cette classe définit la racine des URLs pour lancer des requêtes vers les ressources REST (valeur "resources" de l'annotation @ApplicationPath). On pourrait y ajouter d'autres configurations pour REST.
• La classe de ressource JakartaEE10Resource qui définit une ressource REST.

Classe JakartaEE10Resource :

@Path("jakartaee10")
public class JakartaEE10Resource {
    
    @GET
    public Response ping(){
        return Response
                .ok("ping Jakarta EE")
                .build();
    }
}

L'annotation @Path("jakartaee10") indique que la classe traitera les requêtes vers les URL http://localhost:8080/<context path>/resources/jakartaee10 (<context-path> de l'application à remplacer par sa valeur).

L'annotation @GET indique que la méthode ping() sera exécutée pour traiter les requêtes HTTP GET. Le code de cette méthode retourne une réponse HTTP avec le contenu "ping Jakarta EE" et le statut "OK", de code 200, qui indique que la requête a été traitée et que tout s'est bien passé (voir javadoc de la classe Response).

Test du code

Pour voir REST en action, changez l'URL du navigateur en http://localhost:8080/<context path>/resources/jakartaee10 (<context-path> à remplacer par sa valeur). Une requête GET est envoyée au serveur. "ping Jakarta EE" devrait s'afficher en réponse.

Vous pouvez changer certaines des valeurs des 2 classes REST pour voir si vous avez compris.

S'il est installé sur votre ordinateur, vous pouvez aussi tester avec curl. Tapez la commande

ou bien, pour avoir plus d'information sur la requête et la réponse :

curl -v http://localhost:8080/<context path>/resources/jakartaee10