Paramètres et annotations JAX-RS

Java

Lecture

I211

RESTful

Web Services

Gestion des paramètres dans les services REST Jakarta. - Paramètres de chemin (@PathParam) - Paramètres de requête (@QueryParam) - Paramètres de formulaire (@FormParam) - En-têtes HTTP (@HeaderParam) - Corps de requête (@Consumes) - Validation des paramètres

Auteur

Affiliations

Emmanuel BRUNO

Université de Toulon

LIS UMR CNRS 7020

Date de publication

2026-10-03

Les paramètres complexes dans les corps de requêtes

Jakarta REST facilite la manipulation des données complexes en automatisant la conversion entre les formats d’échange (JSON, XML) et les objets Java. Cette conversion bidirectionnelle s’applique particulièrement aux corps des requêtes HTTP (PUT, POST), où les données reçues sont automatiquement transformées en paramètres Java utilisables dans vos méthodes.

L’annotation @Consumes joue un rôle central dans ce processus en spécifiant les types MIME acceptés par votre endpoint. Par exemple, dans la méthode addAuthor(), elle indique les formats acceptables pour la création d’un auteur. Le client précise le format effectivement utilisé via l’en-tête HTTP Content-Type, et le serveur retourne l’entité complète, y compris les champs générés comme l’ID.

Error: failed to read file /home/jovyan/work/materials/github/ebpro/notebook-java-rest-sample-jakartarestfull/src/main/java/fr/univtln/bruno/samples/jaxrs/resources/AuthorResource.java: /home/jovyan/work/materials/github/ebpro/notebook-java-rest-sample-jakartarestfull/src/main/java/fr/univtln/bruno/samples/jaxrs/resources/AuthorResource.java

Adds an author :

La méthode updateAuteur est appelée par un PUT mais avec une resource précise (indiquée dans l’URL) à mettre à jour.

Fully update an author

La suppression

La suppression des ressources se fait avec les approches précédentes.

Removes one author :

Removes all authors

Réutilisation

CC BY-NC 4.0