Съдържание на курса
Урок 05 — Всичко или нищо
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: когато един ред от поръчката е грешен, ERP да не остава с поръчка наполовина: или се записва всичко, или не се записва нищо. Постигаш го, като добавиш една-единствена стъпка към маршрута от урок 04.
Преди да започнеш, ти трябват: завършен урок 04 и включена средата от урок 00:
docker compose -f infra/compose.yaml up -d --wait # desde la carpeta raíz de la práctica
Новото днес, в едно изречение
В урок 04 твоят маршрут пише в ERP на няколко стъпки: заглавната част, после всеки ред и накрая процедурата. Ако някоя стъпка по средата се провали, предишните вече са записани. Днес обвиваш всички тези стъпки в транзакция: пакет, който ERP потвърждава целия или отменя целия.
Картината: банков превод. От едната сметка се изважда, а към другата се добавя. Ако банката направи изваждането и после добавянето се провали, парите биха изчезнали. Затова двете операции вървят заедно: или минават и двете, или не минава нито една.
| Дума | Какво означава |
|---|---|
| Транзакция | Група записи, която базата третира като един-единствен |
| Потвърждаване (commit) | Когато всичко завърши добре, базата записва цялата група наведнъж |
| Отмяна (rollback) | Ако нещо се провали, базата изтрива всичко, което групата е записала, сякаш никога не се е случвало |
1. Подготви папката си
cd lecciones/05-todo-o-nada
cp -R inicio mio
inicio/ е маршрутът от урок 04, вече завършен, със split и CALL, плюс три нови части, които идват готови.
2. Запознай се с поръчката, която ще се провали
Отвори datos/ordenes/orden-1004-renglon-invalido.json в основната папка на курса. Има два реда:
| Ред | Продукт | Количество | Цена |
|---|---|---|---|
| 1 | Бяла чаша | 1 | 89.50 |
| 2 | Синя покривка | 0 | 249.00 |
ERP не приема количество 0: таблицата pedido_detalle има правило (CHECK (cantidad > 0)), което отхвърля този
ред. Както в реална система, която не позволява да регистрираш „нула покривки“.
3. Предвиди
Твоят маршрут записва първо заглавната част, после ред 1 и после ред 2. Отговори на лист хартия:
- Когато пристигне поръчка 1004, на коя стъпка се проваля маршрутът?
- Какво остава накрая в
pedido_cabeceraи какво вpedido_detalleза поръчка 1004? - С какъв статус остава заглавната част?
4. Провери го
Пусни verifica с маршрута такъв, какъвто идва, без да променяш нищо:
./verifica
Ще излязат две червени отметки:
❌ Quedó la cabecera de la 1004 sin su detalle completo: falta la transacción
❌ Quedaron renglones sueltos de la 1004
Попитай ERP какво е останало:
docker compose -f ../../infra/compose.yaml exec erp \
mariadb -uintegracion -ppractica erp -e "SELECT * FROM pedido_cabecera; SELECT * FROM pedido_detalle WHERE pedido='1004';"
Заглавната част на 1004 е там, в RECIBIDO, с обща сума 89.50, и има един ред: чашата. Покривката
изобщо не е влязла и процедурата изобщо не се е изпълнила. Това е поръчка, за която ERP вярва, че съществува, която никой няма да изпълни и която
някой ще трябва да намери и да изтрие на ръка.
Позна ли? Забележи, че магазинът все пак научи за грешката (маршрутът му отговори с 500), но това не почиства вече записаното.
5. Прочети новите части
Отвори mio/orden-al-erp.camel.yaml. Отгоре, до връзката erp, която вече познаваш, има два нови bean-а:
| Bean | Какво прави | В картината с банката |
|---|---|---|
transacciones (един DataSourceTransactionManager) |
Отваря, потвърждава или отменя транзакцията върху връзката erp |
Касиерът, който води операцията |
todoONada (една SpringTransactionPolicy) |
Правилото, което ще използваш в маршрута: „ако вече има отворена транзакция, присъедини се; ако няма, отвори една“ (PROPAGATION_REQUIRED) |
Политиката на банката: двете операции вървят заедно |
А в mio/dependencias.txt има още две части, които Camel сваля при стартиране: camel-spring и spring-jdbc. Те
са тези, които умеят да управляват транзакции. Не пишеш Java: всичко се декларира в YAML-а.
6. Добави стъпката
Намери в маршрута коментара, който казва TE TOCA. Там отива една-единствена стъпка:
- transacted:
ref: todoONada
transacted означава: оттук до края на маршрута всичко се случва в транзакция, с
правилото todoONada. Ако която и да е стъпка по-долу се провали, се отменя всичко, записано от тази точка нататък.
Обърни внимание къде стои: преди записването на заглавната част. Какво би станало, ако я сложиш след INSERT-а на
заглавната част?
Този шаблон си има име в EIP: Transactional Client. Маршрутът не само праща съобщения: той иска от дестинацията да третира няколко записа като един.
7. Провери
./verifica
⚠️ Както в урок 04, verifica изпразва таблиците на ERP, преди да тества.
Урокът е завършен, когато видиш шестте зелени отметки:
✅ 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
Последната е също толкова важна, колкото останалите: транзакцията не бива да пречи на добрите поръчки.
Провери пак ERP както в стъпка 4. Сега от 1004 не остава нищо: нито заглавна част, нито чаша.
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-al-erp.camel.yaml solucion/orden-al-erp.camel.yaml ти казва по какво се различават.
| Какво виждаш | Какво правиш |
|---|---|
| Същите две червени отметки от стъпка 4 | Стъпката transacted липсва или е след заглавната част |
La ruta no arrancó |
Провери отстъпа на стъпката: transacted е на същото ниво като останалите стъпки |
El puerto 8080 está ocupado |
Останал е работещ маршрут: спри го с Ctrl+C |
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- В ERP — всичко или нищо
Преговор
- Какво е транзакция и какво означават потвърждаване и отмяна?
- Без транзакция какво остана в ERP от поръчка 1004 и защо това е проблем?
- Защо стъпката
transactedстои предиINSERT-а на заглавната част? - За какво служи всеки от двата нови bean-а?
- Магазинът получи 500. Какво трябва да направи с тази поръчка? (Още няма отговор: в третата част на курса, „Да не се проваля“, ще решиш кое се опитва отново и кое се отделя настрана.)
Следва: в урок 06 поръчката пътува към търговския партньор, който не получава нито JSON, нито таблици: получава EDI файл — текстов формат, който фирмите използват от десетилетия, за да си говорят.
Предпочитате имейл? Пишете ни на hola@habil.mx