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

Урок 10 — Всички канали

От · съосновател и 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. Предвиди

Отговори на лист хартия:

  1. С рутера такъв, какъвто е, ако пратиш поръчка 1003, кои дестинации я получават?
  2. Когато пращаш на трите: ако ERP е паднал, получават ли API-то и партньорът поръчката, или не?
  3. В този случай какъв 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

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

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

  • Нишката за корелация пътува с поръчката, но не излиза от къщи
  • Поръчката излиза към всички канали, а рутерът разказва какво се е случило

Преговор

  1. Какво прави един multicast и какво се променя с parallelProcessing: true?
  2. За какво служи bean-ът juntarRespuestas и какво прави ${join(",")}?
  3. Защо всеки канал оставя ред, дори услугата му да е паднала? Какво би изтекло иначе?
  4. При паднал ERP кои дестинации получиха поръчката и какъв код получи магазинът? Защо този код е проблем?
  5. Защо нишката не се праща на партньора и кой номер изпълнява тази роля при него?

Следва: в урок 11 не всички поръчки отиват към всички дестинации: рутерът решава към кои, според това, което носи поръчката.

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

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