Formations — 1 037 leçons en français

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 :

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

Écrire le code et le faire exécuter →

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 »