Към съдържанието
Съдържание на курса

Урок 05 — Всичко или нищо

От · съосновател и 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. Отговори на лист хартия:

  1. Когато пристигне поръчка 1004, на коя стъпка се проваля маршрутът?
  2. Какво остава накрая в pedido_cabecera и какво в pedido_detalle за поръчка 1004?
  3. С какъв статус остава заглавната част?

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 — всичко или нищо

Преговор

  1. Какво е транзакция и какво означават потвърждаване и отмяна?
  2. Без транзакция какво остана в ERP от поръчка 1004 и защо това е проблем?
  3. Защо стъпката transacted стои преди INSERT-а на заглавната част?
  4. За какво служи всеки от двата нови bean-а?
  5. Магазинът получи 500. Какво трябва да направи с тази поръчка? (Още няма отговор: в третата част на курса, „Да не се проваля“, ще решиш кое се опитва отново и кое се отделя настрана.)

Следва: в урок 06 поръчката пътува към търговския партньор, който не получава нито JSON, нито таблици: получава EDI файл — текстов формат, който фирмите използват от десетилетия, за да си говорят.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx