Table des matières du cours
Leçon 05 — Tout ou rien
Par Dorian Chávez · cofondateur et Chief Executive Officer de Hábil ·
Ce que vous allez obtenir : que, lorsqu'une ligne de la commande est fausse, l'ERP ne garde pas une commande à moitié faite : soit tout est enregistré, soit rien ne l'est. Vous y arrivez en ajoutant une seule étape à la route de la 04.
Avant de commencer, il vous faut : la leçon 04 terminée et l'environnement de la 00 allumé :
docker compose -f infra/compose.yaml up -d --wait # desde la carpeta raíz de la práctica
La nouveauté du jour, en une phrase
Dans la 04, votre route écrit dans l'ERP en plusieurs étapes : l'en-tête, puis chaque ligne et, à la fin, la procédure. Si une étape du milieu échoue, les précédentes sont déjà écrites. Aujourd'hui, vous enveloppez toutes ces étapes dans une transaction : un paquet que l'ERP valide en entier ou annule en entier.
L'image : un virement bancaire. On retire d'un compte et on ajoute à l'autre. Si la banque faisait le retrait et que l'ajout échouait ensuite, l'argent disparaîtrait. C'est pour cela que les deux opérations vont ensemble : soit les deux passent, soit aucune ne passe.
| Mot | Ce qu'il signifie |
|---|---|
| Transaction | Un groupe d'écritures que la base traite comme une seule |
| Valider (commit) | Quand tout se termine bien, la base enregistre tout le groupe d'un coup |
| Annuler (rollback) | Si quelque chose échoue, la base efface tout ce que le groupe avait écrit, comme si rien ne s'était passé |
1. Préparez votre dossier
cd lecciones/05-todo-o-nada
cp -R inicio mio
inicio/ est la route de la 04 déjà terminée, split et CALL compris, plus trois pièces nouvelles fournies toutes faites.
2. Faites connaissance avec la commande qui va échouer
Ouvrez datos/ordenes/orden-1004-renglon-invalido.json, dans le dossier racine du cours. Elle a deux lignes :
| Ligne de commande | Produit | Quantité | Prix |
|---|---|---|---|
| 1 | Tasse blanche | 1 | 89.50 |
| 2 | Nappe bleue | 0 | 249.00 |
L'ERP n'accepte pas une quantité de 0 : la table pedido_detalle a une règle (CHECK (cantidad > 0)) qui rejette cette
ligne. C'est comme un système réel, qui ne laisse pas enregistrer « zéro nappe ».
3. Prédisez
Votre route écrit d'abord l'en-tête, puis la ligne 1, puis la ligne 2. Répondez sur papier :
- Quand la commande 1004 arrive, à quelle étape la route échoue-t-elle ?
- À la fin, que reste-t-il dans
pedido_cabeceraet que reste-t-il danspedido_detallepour la commande 1004 ? - Avec quel statut l'en-tête reste-t-il ?
4. Vérifiez-le
Lancez verifica avec la route telle qu'elle est fournie, sans rien changer :
./verifica
Vous allez voir deux marques rouges :
❌ Quedó la cabecera de la 1004 sin su detalle completo: falta la transacción
❌ Quedaron renglones sueltos de la 1004
Demandez à l'ERP ce qu'il a gardé :
docker compose -f ../../infra/compose.yaml exec erp \
mariadb -uintegracion -ppractica erp -e "SELECT * FROM pedido_cabecera; SELECT * FROM pedido_detalle WHERE pedido='1004';"
L'en-tête de la 1004 est là, en RECIBIDO, avec un total de 89.50, et il a une ligne : la tasse. La nappe
n'est jamais entrée et la procédure n'a jamais tourné. C'est une commande dont l'ERP croit qu'elle existe, que personne ne préparera et que
quelqu'un devra retrouver et effacer à la main.
Aviez-vous vu juste ? Remarquez que la boutique, elle, a bien été informée de l'erreur (la route lui a répondu un 500), mais cela ne nettoie pas ce qui avait déjà été écrit.
5. Lisez les pièces nouvelles
Ouvrez mio/orden-al-erp.camel.yaml. En haut, à côté de la connexion erp que vous connaissez déjà, il y a deux nouveaux beans :
| Bean | Ce qu'il fait | Dans l'image de la banque |
|---|---|---|
transacciones (un DataSourceTransactionManager) |
Ouvre, valide ou annule la transaction sur la connexion erp |
Le guichetier qui mène l'opération |
todoONada (une SpringTransactionPolicy) |
La règle que vous allez utiliser dans la route : « s'il y a déjà une transaction ouverte, rejoins-la ; sinon, ouvres-en une » (PROPAGATION_REQUIRED) |
La politique de la banque : les deux opérations vont ensemble |
Et dans mio/dependencias.txt, il y a deux pièces de plus que Camel télécharge au démarrage : camel-spring et spring-jdbc. Ce sont
elles qui savent gérer les transactions. Vous n'écrivez pas de Java : tout se déclare dans le YAML.
6. Ajoutez l'étape
Cherchez dans la route le commentaire qui dit TE TOCA (« à vous »). Une seule étape y prend place :
- transacted:
ref: todoONada
transacted veut dire : d'ici jusqu'à la fin de la route, tout se passe dans une transaction, avec la
règle todoONada. Si n'importe quelle étape en dessous échoue, tout ce qui a été écrit depuis ce point est annulé.
Regardez où elle se place : avant l'écriture de l'en-tête. Que se passerait-il si vous la mettiez après l'INSERT de
l'en-tête ?
Ce patron a un nom dans les EIP : Transactional Client. La route ne se contente pas d'envoyer des messages : elle demande à la destination de traiter plusieurs écritures comme une seule.
7. Vérifiez
./verifica
⚠️ Comme dans la 04, verifica vide les tables de l'ERP avant de tester.
Elle est terminée quand vous voyez les six coches vertes :
✅ El mapeo al ERP pasa sus casos dorados
✅ La ruta arrancó
✅ La orden 1004 (con un renglón de cantidad 0) fue rechazada (500)
✅ No quedó la cabecera de la 1004: se deshizo
✅ No quedó ningún renglón de la 1004
✅ La orden buena 1001 sí quedó completa y REGISTRADO
La dernière compte autant que les autres : la transaction ne doit pas gêner les bonnes commandes.
Interrogez de nouveau l'ERP comme à l'étape 4. De la 1004, il ne reste maintenant rien : ni en-tête, ni tasse.
Ça ne tourne pas ? ./verifica solucion teste la nôtre, et
diff mio/orden-al-erp.camel.yaml solucion/orden-al-erp.camel.yaml vous dit en quoi elles diffèrent.
| Ce que vous voyez | Ce que vous faites |
|---|---|
| Les deux mêmes marques rouges qu'à l'étape 4 | L'étape transacted est absente, ou placée après l'en-tête |
La ruta no arrancó |
Vérifiez l'indentation de l'étape : transacted se place au même niveau que les autres étapes |
El puerto 8080 está ocupado |
Une route tourne encore : arrêtez-la avec Ctrl+C |
Pourquoi on a fait ainsi
Ce que nous avons décidé dans cette leçon, avec ce que nous avons écarté et ce qui nous ferait changer d'avis :
- Dans l'ERP, tout ou rien
Révision
- Qu'est-ce qu'une transaction, et que signifient valider et annuler ?
- Sans transaction, qu'est-il resté dans l'ERP avec la commande 1004, et pourquoi est-ce un problème ?
- Pourquoi l'étape
transactedse place-t-elle avant l'INSERTde l'en-tête ? - À quoi sert chacun des deux nouveaux beans ?
- La boutique a reçu un 500. Que devrait-elle faire de cette commande ? (Pas encore de réponse : dans la troisième partie du cours, « Que rien n'échoue », vous déciderez ce qui se retente et ce qui s'écarte.)
Suite : dans la leçon 06, la commande part vers le partenaire commercial, qui ne reçoit ni JSON ni tables : il reçoit un fichier EDI, un format texte que les entreprises utilisent depuis des décennies pour se parler.
Vous préférez l'e-mail ? Écrivez-nous à hola@habil.mx