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

Урок 11 — Не всичко отива при всички

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

  1. Колко от десетте са от франчайз (T-501 или T-502)?
  2. С рутера такъв, какъвто е днес, колко файла очакваш в пощенската кутия на партньора? А когато приключиш?
  3. Колко поръчки трябва да имат 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: този, който програмира маршрута, или този, който управлява бизнеса?


Защо е направено така

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • Кой какво получава се решава по съдържанието, на едно-единствено място

Преговор

  1. Каква е разликата между Multicast и Content-Based Router? Дай пример кога би използвал всеки.
  2. Какво прави in в условието ${variable.tienda} in 'T-501,T-502'?
  3. Защо каналът отговаря no aplica, вместо да си замълчи?
  4. Защо решението живее в canal-socio, а извикването — в al-socio?
  5. Какво печелиш, като преместиш списъка с франчайзите в променлива на средата?

Следва: в урок 12 една услуга престава да е само една: пускаш няколко нейни реплики, за да издържи на повече поръчки.

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

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