Съдържание на курса
Урок 10 — Всички канали
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: рутерът да праща една и съща поръчка едновременно на трите дестинации (API-то, ERP и партньора) и да отговаря на магазина какво е казала всяка. И да видиш със собствените си очи какво става, когато една от трите е паднала.
Преди да започнеш, ти трябват: завършени уроци 05, 07 и 09 и включена средата от урок 00.
⚠️ Този урок добавя една колона в ERP (correlacion, за да пази нишката от урок 09). Ако средата ти вече е била
вдигната отпреди, пресъздай ERP веднъж, от основната папка на курса:
docker compose -f infra/compose.yaml up -d --wait --force-recreate -V erp
--force-recreate го създава наново, а -V му изтрива данните, така тръгва с новите таблици. Ако забравиш,
verifica те предупреждава и ти дава същата тази команда.
Новото днес, в едно изречение
В урок 08 рутерът подаваше поръчката на една услуга. Днес услугите са четири и рутерът разпределя три копия на поръчката, по едно за дестинация, всички по едно и също време:
┌→ int-rest → API de pedidos
tienda → POST /ordenes → [router] ────┼→ int-bd → ERP
└→ int-edi → SFTP del socio (850)
int-bd е твоят урок 05 зад рутера, а int-edi е твоят урок 07. Не ги пишеш отново: идват готови.
Картината: съобщение, което централата праща до три клона. Не чака първият да отговори, за да го прати на втория: праща го на трите едновременно и после събира трите отговора.
Този шаблон си има име в EIP: Multicast. Една и съща поръчка отива към няколко фиксирани дестинации.
1. Подготви папката си
cd lecciones/10-todos-los-canales
cp -R inicio mio
Сега mio/ има четири папки, по една за услуга: orden-router, int-rest, int-bd и int-edi.
2. Прочети рутера
Отвори mio/orden-router/orden-router.camel.yaml. Горната част я познаваш цялата: нишката от урок 09 и плика ce-*. Долу
има нещо ново: три маршрута на канали, canal-api, canal-erp и canal-socio. Всеки вика своята услуга и
е направен така, че да остави един-единствен ред за това, което се е случило, независимо дали услугата му отговаря:
| Ако услугата… | Редът е… |
|---|---|
| отговори, макар и с грешка | {"canal":"erp","codigo":200}, с HTTP кода, който е дала |
| дори не отговори (паднала е) | {"canal":"erp","error":"UnknownHostException"}, с името на грешката |
За това използват doTry и doCatch: опитва извикването и ако то се провали, улавя грешката и я превръща в ред.
Защо толкова внимание? Защото докато тествахме този урок, видяхме, че без маршрутите на каналите, когато една услуга беше паднала, рутерът връщаше на магазина цялата поръчка, с името и имейла на клиента. Отговор за грешка никога не бива да носи лични данни.
Днес основният маршрут вика само един от трите:
- to:
uri: direct:canal-api
direct: е извикване на друг маршрут от същия файл, без мрежа по средата. TODO-то отгоре казва какво липсва.
3. Предвиди
Отговори на лист хартия:
- С рутера такъв, какъвто е, ако пратиш поръчка 1003, кои дестинации я получават?
- Когато пращаш на трите: ако ERP е паднал, получават ли API-то и партньорът поръчката, или не?
- В този случай какъв HTTP код според теб получава магазинът?
Провери първото:
./verifica
Излизат четири червени отметки. API-то има поръчката; ERP и партньорът нямат нищо.
4. Напиши multicast-а
Смени to: direct:canal-api с multicast, който вика трите канала:
- multicast:
parallelProcessing: true
aggregationStrategy: "#juntarRespuestas"
steps:
- to:
uri: direct:canal-api
# … los otros dos canales
| Параметър | Какво прави |
|---|---|
parallelProcessing: true |
Трите едновременно. Без това — един след друг: партньорът би чакал ERP да приключи |
aggregationStrategy: "#juntarRespuestas" |
Как се събират трите отговора. juntarRespuestas е bean, който вече е деклариран отгоре, и ги слага в списък |
След multicast-а тялото е този списък от три реда. Отговори на магазина със setBody:
{"orden":"${variable.orden}","canales":[${join(",")}]}
${join(",")} съединява трите реда от списъка, като ги разделя със запетаи. Използвай каноничния запис, както в останалите
setBody във файла (expression: → simple: → expression:).
5. Вдигни го и му прати една поръчка
Преди да го вдигнеш на ръка, запиши ключа на партньора в папката на int-edi: това е услугата, която се свързва с неговия SFTP, както в урок 07.
(cd mio/int-edi && ../../../../herramientas/confiar-en-socio)
DONDE=mio docker compose -f compose.yaml up -d
DONDE=mio docker compose -f compose.yaml logs -f
Изчакай четирите Started. В друг терминал, от основната папка на курса:
curl -s -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' -d @datos/ordenes/orden-1001.json
Магазинът получава какво е казал всеки канал:
{"orden":"1001","canales":[{"canal":"api","codigo":201},{"canal":"erp","codigo":200},{"canal":"socio","codigo":200}]}
Каналите работят едновременно, но рутерът изчаква да приключат и трите, преди да отговори, а списъкът излиза
в последователността, в която са написани в YAML-а (api, erp, socio), а не в тази, в която са приключвали. Обърни внимание на логовете:
трите реда с contestó на рутера излизат почти едновременно и тяхната последователност може да се променя от едно пускане на
друго.
Ако каналът на партньора каже 500, провери лога на int-edi. Ако видиш reject HostKey, пропуснал си да запишеш ключа.
6. Изключи един канал
Сега въпрос 2. С всичко вдигнато изключи само int-bd и прати друга поръчка:
DONDE=mio docker compose -f compose.yaml stop int-bd
curl -s -w ' %{http_code}\n' -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' \
-d @datos/ordenes/orden-1003.json
{"orden":"1003","canales":[{"canal":"api","codigo":…},{"canal":"erp","error":"UnknownHostException"},{"canal":"socio","codigo":200}]} 200
- API-то и партньорът наистина получиха поръчката. Един паднал канал не спира другите два.
- Редът на ERP казва
UnknownHostException: рутерът потърсиint-bdпо име и никой не отговори. - Магазинът получи 200, макар че една дестинация няма поръчката.
Ако повториш тази стъпка със същата поръчка, партньорът отговаря с 500: вече има тази 850-ка и не я презаписва, както в урок 07.
Прегледай предвиждане 3. А сега въпросът, който урокът оставя: какво правим с ERP, който няма поръчката? Пращаме ли му я отново? Кога? А ако API-то вече я има: пращаме ли я отново и на него? Запиши отговора си: ще го сравниш с това, което ще построиш в уроци 19 и 22.
Изключи всичко:
DONDE=mio docker compose -f compose.yaml down
7. Нишката в трите дестинации
Нишката от урок 09 пътува в плика до трите канала. Но всяка дестинация я пази по различен начин:
| Дестинация | Къде остава нишката |
|---|---|
| API | В неговия лог: correlacion=<id> |
| ERP | В новата колона pedido_cabecera.correlacion |
| Партньор | Никъде във файла. int-edi я записва в собствения си лог, а 850-ката излиза същата като в урок 07 |
Защо не я пращаме на партньора? Защото на партньора се пращат само полетата, които форматът X12 уговаря с него.
Нишката е наша, на нашата интеграция; да я пъхнем в поле, което партньорът не е искал, не се прави. С партньора нишката
вече съществува: това са контролните номера на 850-ката, които видя в урок 06. Когато партньорът отговори със своето потвърждение за получаване,
997, неговият AK1 цитира GS06 (този на групата), а неговият AK2 — ST02 (този на транзакцията). ISA13, този на
целия плик, го цитира друго потвърждение, TA1. Това го използваш в урок 21.
Не всички дестинации могат да пазят твоя идентификатор. Затова по-нататък една база на състоянието ще свърже нишката с контролния номер.
8. Провери
./verifica
verifica рестартира API-то, изпразва ERP и пощенската кутия на партньора, записва ключа на партньора в mio/int-edi/, вдига
четирите услуги и праща поръчка 1003 със собствена нишка. Урокът е завършен, когато видиш шестте зелени отметки:
✅ Arrancaron el router y los tres canales
✅ La tienda mandó la 1003 y el router contestó lo que dijo cada canal: api=201 erp=200 socio=200
✅ API: tiene el pedido 1003, con el hilo tienda-…
✅ ERP: tiene el pedido 1003 REGISTRADO, con el hilo tienda-…
✅ Socio: tiene el 850 de la 1003 en su SFTP
✅ int-edi anotó el hilo (al socio no se le manda: con él, el hilo es el número de control del X12)
Три от шестте ги потвърждава самата дестинация: регистърът на API-то, таблицата на ERP и пощенската кутия на партньора.
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/orden-router.camel.yaml solucion/orden-router/orden-router.camel.yaml ти казва по какво се
различават.
| Какво виждаш | Какво правиш |
|---|---|
Tu ERP no tiene la columna correlacion |
Пресъздай ERP с командата от началото |
| Червено само при ERP или само при партньора | Този канал не е в твоя multicast |
El router no contestó que los tres canales la recibieron и се появява само един ред |
Липсва setBody с ${join(",")} или multicast-ът още е само един to |
El puerto 8080 está ocupado |
Услугите са останали вдигнати: DONDE=mio docker compose -f compose.yaml down |
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Нишката за корелация пътува с поръчката, но не излиза от къщи
- Поръчката излиза към всички канали, а рутерът разказва какво се е случило
Преговор
- Какво прави един multicast и какво се променя с
parallelProcessing: true? - За какво служи bean-ът
juntarRespuestasи какво прави${join(",")}? - Защо всеки канал оставя ред, дори услугата му да е паднала? Какво би изтекло иначе?
- При паднал ERP кои дестинации получиха поръчката и какъв код получи магазинът? Защо този код е проблем?
- Защо нишката не се праща на партньора и кой номер изпълнява тази роля при него?
Следва: в урок 11 не всички поръчки отиват към всички дестинации: рутерът решава към кои, според това, което носи поръчката.
Предпочитате имейл? Пишете ни на hola@habil.mx