Accueil › Spring Boot › Remplacer, modifier, supprimer — et rejouer deux fois
Remplacer, modifier, supprimer — et rejouer deux fois
Exercice de la série « Un projet de bout en bout »intermediaire
Où l'on en est. Le catalogue se lit, se crée, et refuse les entrées
fautives en nommant le champ — c'est votre contrôleur des exercices 2 à 4,
et il est le code de départ de celui-ci, routes PUT, PATCH et
DELETE comprises mais mal écrites. Reste le travail quotidien d'un
catalogue : corriger un prix, ajuster un stock, retirer une référence.
Ni Spring, ni serveur, ni base de données ne tournent ici : votre code
est compilé par javac seul, et c'est un routeur miniature fourni —
visible sous « Code fourni, déjà en place » — qui relit par réflexion les
annotations que vous avez posées, apparie le chemin, extrait la variable,
transforme le corps en objet, et appelle votre méthode. Les cinq verbes
lui sont connus, et les annotations correspondantes — @PutMapping,
@PatchMapping, @DeleteMapping — sont déclarées dans le code fourni,
aux noms exacts de Spring. Monter le projet, le pom.xml, le
application.yml et le démarrage ne s'apprennent pas ici : ils restent
dans les leçons, et c'est leur place.
Ce que le code fourni vous donne, en plus du prélude de l'exercice 4 :
le service, qui sait maintenant écrire et retirer :
void enregistrer(Produit produit) // remplace a l'identifiant porte boolean supprimer(long id) // false si rien a supprimerle corps d'une modification partielle, sous forme d'objet :
record Modification(Map<String, String> valeurs) { int entier(String cle) // -1 si la cle est absente ou la valeur illisible }Le texte de la requête est fait de couples séparés par des points-virgules :
prixCentimes=1500;stock=3. Un corps vide donne une map vide.le banc envoie chaque requête deux fois, affiche les deux réponses, puis l'état final du catalogue. C'est ainsi que l'idempotence se voit : pas dans un texte, dans deux lignes identiques.
Le catalogue de départ contient 1 clavier, 2 souris, 3 écran.
Ce qu'on vous demande. Trois routes, qui rendent toutes un
ReponseHttp.
@PutMapping("/produits/{id}"), corps : un NouveauProduit annoté
@RequestBody — un remplacement total :
- entrée invalide →
400et le corps par champ de l'exercice 4. La validation passe avant la recherche : un corps fautif sur un identifiant inexistant donne400, pas404; - produit absent →
404et le corpsproduit introuvable. On ne crée pas parPUTici ; - sinon →
200, et le corps est le résumé du produit remplacé, qui garde l'identifiant de l'URL.
@PatchMapping("/produits/{id}"), corps : une Modification annotée
@RequestBody — une modification partielle. Deux champs seulement
sont modifiables, prixCentimes et stock ; nom et categorie ne le
sont pas par cette route :
- produit absent →
404etproduit introuvable; - clé inconnue dans le corps →
400, et le corps associe cette clé au messagechamp inconnu; - valeur refusée (prix non strictement positif, stock négatif, valeur
illisible donc ramenée à
-1) →400et les mêmes messages par champ qu'à l'exercice 4 ; - corps vide →
200et le produit inchangé : une modification qui ne demande rien ne change rien, et ce n'est pas une erreur ; - sinon →
200, et le corps est le résumé du produit modifié ; les champs absents du corps gardent leur valeur.
@DeleteMapping("/produits/{id}"), sans corps de requête :
- produit supprimé →
204, et le corps estnull— aucun contenu ; - rien à supprimer →
404etproduit introuvable.
L'idempotence, et ce que le banc en montre. Une opération est idempotente quand la rejouer ne change rien de plus. Regardez les deux envois de chaque cas :
PUT: deux fois le même200, et un état final identique. C'est pour cela qu'un client peut relancer unPUTsans danger après un timeout — contrairement àPOST, qui créerait un second produit ;PATCH: ici idempotent, parce que nos deux champs sont des affectations. Il ne l'est pas en général — unPATCHqui dirait « ajoute 3 au stock » ne l'est pas du tout ;DELETE:204puis404. L'effet est idempotent — après l'un comme après l'autre, le produit n'est plus là —, le statut ne l'est pas. C'est la réponse à la question d'entretien, et elle est exactement là, dans ces deux lignes.
Le piège. Le code de départ se trompe sur les trois routes, et chaque
fois de la façon la plus courante. Le PUT ne valide rien et crée le
produit quand l'identifiant est libre : un client qui se trompe d'URL
peuple votre catalogue de références fantômes. Le PATCH applique ce
qu'il reconnaît et ignore en silence le reste : couleur=bleu répond
200 sans rien faire, et le client croit avoir modifié quelque chose. Le
DELETE répond 204 quoi qu'il arrive, y compris sur une référence qui
n'a jamais existé.
Cas de test
essai("PUT", "/produits/1", "clavier pro;bureau;8900;6")essai("PUT", "/produits/99", "clavier pro;bureau;8900;6")essai("PUT", "/produits/1", ";bureau;0;4")essai("PUT", "/produits/99", ";bureau;0;4")essai("PATCH", "/produits/2", "stock=0")essai("PATCH", "/produits/2", "prixCentimes=1500;stock=3")
Votre code est réellement compilé par javac et exécuté sur une JVM — aucun JDK à installer —, et la correction compare son résultat à celui d'une solution de référence.
La leçon qui prépare cet exercice
Les autres exercices de « Un projet de bout en bout »
- Le modèle et le dépôt, premières fondations
- Lister, consulter, et le 404 qui n'est pas celui du routeur
- Créer une ressource, et dire où elle est
- Refuser une entrée, et nommer le champ fautif
- Filtrer et trier, sans casser l'URL de la liste
- Une page de catalogue, et ses bornes
- Les erreurs, traitées en un seul endroit
- Protéger les écritures, devant le contrôleur
- Une commande qui touche deux agrégats, et reste cohérente