Accueil › Spring Boot › Une commande qui touche deux agrégats, et reste cohérente
Une commande qui touche deux agrégats, et reste cohérente
Exercice de la série « Un projet de bout en bout »avance
Où l'on en est. Le catalogue est complet, ses erreurs sont traduites en un seul endroit, ses écritures sont protégées. Dernier exercice, et premier vrai cas d'écriture métier : passer une commande. Jusqu'ici chaque requête touchait un agrégat — un produit. Celle-ci en touche deux à la fois : elle décrémente le stock de plusieurs produits, et crée une commande. Si une seule ligne du panier est refusée, rien ne doit avoir changé.
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 apparie le
chemin, transforme le corps en objet, appelle le contrôleur, et confie
les exceptions au gestionnaire d'erreurs. Il n'y a donc pas de
transaction : aucune base ne peut annuler vos écritures pour vous. 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 9 :
record Ligne(long produitId, int quantite) { }
record Panier(List<Ligne> lignes) { } // corps de requete : 1x2,2x3
final class DepotCommande {
long enregistrer(int nombreLignes, int totalCentimes) // rend l'identifiant attribue
List<String> resumes()
}
Plus deux exceptions métier de plus, et le GestionnaireErreurs qui les
traduit déjà :
class PanierVide extends RuntimeException // 400, message : panier vide
class StockInsuffisant extends RuntimeException // 409, message detaille
Le contrôleur est fourni : POST /commandes prend un Panier annoté
@RequestBody, appelle votre service, et rend 201 avec
l'identifiant de la commande et un en-tête Location. Le banc affiche la
réponse, puis l'état des trois produits et la liste des commandes —
c'est là que la cohérence se voit.
Le catalogue : 1 clavier (4500c, stock 12), 2 souris (1900c, stock
30), 3 écran (15900c, stock 4).
Ce qu'on vous demande. Écrivez ServiceCommande, qui reçoit
DepotProduit puis DepotCommande par constructeur — dans cet ordre —
et expose :
long passer(Panier panier)
Les règles, dans l'ordre où elles se vérifient :
- panier sans aucune ligne →
PanierVide(le gestionnaire en fait un400) ; - une ligne de quantité nulle ou négative →
DonneesInvalidesportant{quantite=doit etre strictement positif}(400) ; - un produit inexistant →
ProduitIntrouvablesur son identifiant (404) ; - un stock insuffisant pour la quantité demandée →
StockInsuffisant, construite avecnew StockInsuffisant(nom du produit, quantité demandée, stock disponible)(409) ; - sinon : chaque produit voit son stock diminué de la quantité
commandée, une commande est enregistrée avec le nombre de lignes et
le total en centimes — somme des
prixCentimes × quantite—, et son identifiant est rendu.
Et la règle qui fait tout l'exercice : tout ou rien. Si une ligne quelconque est refusée, aucun stock n'a bougé et aucune commande n'a été enregistrée. Le banc le vérifie en affichant les stocks après la requête : un panier dont la deuxième ligne est refusée doit laisser le premier produit intact.
Les cas limites, annoncés. Une quantité égale au stock disponible
passe (3x4 sur un stock de 4, qui tombe à zéro) ; une de plus est
refusée. Un corps vide donne un panier sans ligne. Enfin, le panier ne
contient jamais deux lignes pour le même produit : l'agrégation des
doublons n'est pas demandée ici — on y revient dans la solution.
Le piège. Le code de départ fait ce que l'on écrit naturellement : il
parcourt les lignes et, pour chacune, vérifie puis écrit tout de suite.
Sur un panier dont la seconde ligne est refusée, le stock du premier
produit a déjà été décrémenté, et il le reste : l'exception remonte,
le client reçoit son 409, et votre catalogue vient de perdre deux
claviers que personne n'a achetés. C'est l'incohérence silencieuse par
excellence — rien dans les journaux, et un écart d'inventaire découvert
trois semaines plus tard.
Cas de test
essai("1x2")essai("1x2,2x3")essai("1x2,2x999")essai("1x2,99x1")essai("")essai("1x0")
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
- Remplacer, modifier, supprimer — et rejouer deux fois
- 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