Съдържание на курса
Урок 11 — Не всичко отива при всички
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: рутерът да решава, поръчка по поръчка, дали тя отива при партньора, или не, според това от кой магазин идва. API-то и ERP продължават да получават всички; партньорът — само своите.
Преди да започнеш, ти трябват: завършен урок 10 и включена средата от урок 00 (с ERP, пресъздаден в урок 10).
Новото днес, в едно изречение
В урок 10 всяка поръчка отиваше към трите дестинации. Но търговският партньор не оперира всички магазини: само франчайзите, T-501 и T-502. Ако му пратиш поръчката на собствен магазин, при него пристига поръчка, която не е негова и която той би могъл да изпълни. Днес каналът на партньора поглежда поръчката, преди да я прати.
Картината: пощальонът, който разнася в един квартал. Не оставя всички писма във всички къщи: чете адреса на всяко и решава.
Този шаблон се нарича Content-Based Router: дестинацията зависи от съдържанието на съобщението.
| Multicast (урок 10) | Content-Based Router (днес) | |
|---|---|---|
| При кого отива? | При всички дестинации, винаги | Само при тези, които изпълняват едно условие |
| Кой решава? | Никой: списъкът е фиксиран | Правило, което чете поръчката |
Днес използваш двата заедно: multicast-ът продължава да разпределя към трите канала, а вътре в канала на партньора едно условие решава дали поръчката продължава, или не.
1. Подготви папката си
cd lecciones/11-no-todo-va-a-todos
cp -R inicio mio
2. Предвиди
Отвори партидата от 10 поръчки, папката datos/ordenes/lote-10/, в основната папка на курса. В нея има десет поръчки и един LEEME.md. Без да пускаш
нищо, отвори поръчките, виж полето им "tienda" и отговори на лист хартия:
- Колко от десетте са от франчайз (T-501 или T-502)?
- С рутера такъв, какъвто е днес, колко файла очакваш в пощенската кутия на партньора? А когато приключиш?
- Колко поръчки трябва да имат API-то и ERP?
Провери днешното състояние:
./verifica
Излизат две червени отметки. Партньорът има и десетте 850-ки, а API-то и ERP също имат десет. Днес каналът на партньора праща всичко.
3. Прочети канала на партньора
Отвори mio/orden-router/orden-router.camel.yaml и намери маршрута canal-socio. Сега той има две части:
| Маршрут | Какво прави |
|---|---|
canal-socio |
Решава дали поръчката отива при партньора. Тук е TODO-то |
al-socio |
Праща поръчката на int-edi и оставя реда с това, което е отговорил, като канала от урок 10 |
Разделянето им оставя решението на едно-единствено място: ако утре се промени кой е партньор, се пипа един ред, а не извикването.
4. Напиши условието
В TODO-то смени to: direct:al-socio с choice. Вече използва един в урок 09, в рутера, за да решиш
откъде идва нишката:
- choice:
when:
- expression:
simple:
expression: "…tu condición…"
steps:
- to:
uri: direct:al-socio
otherwise:
steps:
# … el canal contesta que no aplica
Условието. Магазинът на поръчката вече е запазен в ${variable.tienda}. В езика simple на Camel
in пита дали дадена стойност е в списък, разделен със запетаи:
${variable.tienda} in 'T-501,T-502'
Клонът otherwise. Поръчките, които не са от франчайз, не отиват при партньора, но каналът трябва да го каже: един
setBody с {"canal":"socio","resultado":"no aplica"}. Ако каналът си замълчи, магазинът няма да знае дали
рутерът е решил да не я праща, или е забравил. no aplica („не се отнася“) и „провали се“ не са едно и също и отговорът трябва да ги различава.
5. Сравни с предвиждането си
./verifica
Сега партньорът има четири 850-ки — тези на поръчки 2002, 2005, 2007 и 2010, а магазинът получи no aplica за
останалите шест. Позна ли 4? API-то и ERP продължават да имат десетте: условието живее само в канала на партньора.
Ако излезе Socio: … y tiene «850-2002.edi 850-2007.edi», твоето условие изключва T-502. Провери списъка.
6. Провери
Урокът е завършен, когато видиш петте зелени отметки:
✅ Arrancaron el router y los tres canales
✅ API: tiene las 10 órdenes del lote
✅ ERP: tiene las 10 órdenes REGISTRADO
✅ Socio: solo llegaron los 850 de franquicia (850-2002.edi 850-2005.edi 850-2007.edi 850-2010.edi)
✅ El router le dijo a la tienda «no aplica» en las 6 que no son de franquicia
Отметките за API-то, ERP и партньора броят в дестинацията: регистъра на API-то, редовете в ERP и файловете в пощенската кутия.
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/orden-router.camel.yaml solucion/orden-router/orden-router.camel.yaml ти казва по какво се
различават.
| Какво виждаш | Какво правиш |
|---|---|
| Партньорът има десетте | Условието липсва или to е останал извън when |
| Партньорът има две | Списъкът в условието има само един магазин |
Esperaba «no aplica» en 6 respuestas y lo vi en 0 |
Липсва setBody в otherwise |
Tu ERP no tiene la columna correlacion |
Пресъздай ERP, както казва урок 10 |
Упражнение: правилото извън маршрута
Днес списъкът с франчайзите е написан вътре в маршрута. Ако партньорът отвори още един франчайз, някой трябва да редактира YAML-а, да го прегледа и да го внедри отново, за да смени една бизнес стойност. Премести го в конфигурацията: стойност, която се сменя, без да се пипа маршрутът.
1. В условието си смени списъка с променлива на средата със стойност по подразбиране:
${variable.tienda} in '{{env:FRANQUICIAS:T-501,T-502}}'
{{env:FRANQUICIAS:…}} означава: „използвай променливата на средата FRANQUICIAS; ако не съществува, използвай това, което е след
двоеточието“. Пусни ./verifica: трябва да остане пет от пет, защото използва стойността по подразбиране.
2. Сега смени правилото, без да пипаш маршрута. Създай mio/franquicias.yaml с това:
services:
orden-router:
environment:
FRANQUICIAS: "T-501"
Това е файл, който се добавя към compose файла на урока: добавя една променлива на средата на рутера и не променя нищо друго.
3. Изпразни пощенската кутия на партньора, вдигни услугите с двата файла, прати партидата и виж пощенската кутия:
docker compose -f ../../infra/compose.yaml exec socio-sftp sh -c 'rm -f /home/socio/entrada/*'
(cd mio/int-edi && ../../../../herramientas/confiar-en-socio)
DONDE=mio docker compose -f compose.yaml -f mio/franquicias.yaml up -d
for f in ../../datos/ordenes/lote-10/orden-*.json; do
curl -s -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' -d @$f; echo
done
docker compose -f ../../infra/compose.yaml exec socio-sftp ls /home/socio/entrada
DONDE=mio docker compose -f compose.yaml down
Преди да го пуснеш, предвиди: колко 850-ки очакваш в пощенската кутия и колко отговора с no aplica?
В отговорите гледай само реда на канала socio. API-то и ERP вече имаха тези поръчки от последното ти
verifica, така че техните редове казват друго; за партньора пощенската кутия започна празна. Когато приключиш, пусни ./verifica,
за да оставиш всичко както беше.
4. Отговори: какво се промени и какво — не? Кой трябва да може да сменя FRANQUICIAS: този, който програмира маршрута, или този, който
управлява бизнеса?
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Кой какво получава се решава по съдържанието, на едно-единствено място
Преговор
- Каква е разликата между Multicast и Content-Based Router? Дай пример кога би използвал всеки.
- Какво прави
inв условието${variable.tienda} in 'T-501,T-502'? - Защо каналът отговаря
no aplica, вместо да си замълчи? - Защо решението живее в
canal-socio, а извикването — вal-socio? - Какво печелиш, като преместиш списъка с франчайзите в променлива на средата?
Следва: в урок 12 една услуга престава да е само една: пускаш няколко нейни реплики, за да издържи на повече поръчки.
Предпочитате имейл? Пишете ни на hola@habil.mx