Índice do curso
Lição 10 — Todos os canais
Por Dorian Chávez · cofundador e Chief Executive Officer da Hábil ·
O que será alcançado: que o router mande o mesmo pedido, ao mesmo tempo, para os três destinos (a API, o ERP e o parceiro), e que responda à loja o que cada um disse. E ver com os próprios olhos o que acontece quando um dos três está fora do ar.
Antes de começar é preciso ter: as lições 05, 07 e 09 concluídas e o ambiente da 00 ligado.
⚠️ Esta lição acrescenta uma coluna ao ERP (correlacion, para guardar o fio da 09). Se o ambiente já estava
no ar de antes, recrie o ERP uma vez, a partir da raiz do curso:
docker compose -f infra/compose.yaml up -d --wait --force-recreate -V erp
--force-recreate o cria de novo e -V apaga os dados dele, e assim ele inicia com as tabelas novas. Se isso for esquecido,
o verifica avisa e dá este mesmo comando.
A novidade de hoje, em uma frase
Na 08 o router passava o pedido para um serviço. Hoje há quatro serviços e o router distribui três cópias do pedido, uma por destino, todas ao mesmo tempo:
┌→ int-rest → API de pedidos
tienda → POST /ordenes → [router] ────┼→ int-bd → ERP
└→ int-edi → SFTP del socio (850)
O int-bd é a lição 05 atrás do router, e o int-edi é a lição 07. Não é preciso escrevê-los de novo: já vêm prontos.
A imagem: um aviso que o escritório manda a três filiais. Ele não espera a primeira responder para mandá-lo à segunda: manda às três ao mesmo tempo e depois reúne as três respostas.
Este padrão tem nome nos EIP: Multicast. Um mesmo pedido vai para vários destinos fixos.
1. Prepare a pasta
cd lecciones/10-todos-los-canales
cp -R inicio mio
Agora mio/ tem quatro pastas, uma por serviço: orden-router, int-rest, int-bd e int-edi.
2. Leia o router
Abra mio/orden-router/orden-router.camel.yaml. No alto tudo já é conhecido: o fio da 09 e o envelope ce-*. Embaixo
há algo novo: três rotas de canal, canal-api, canal-erp e canal-socio. Cada uma chama o próprio serviço e
é feita para deixar uma única linha com o que aconteceu, responda ou não o serviço dela:
| Se o serviço… | A linha é… |
|---|---|
| responde, ainda que com erro | {"canal":"erp","codigo":200}, com o código HTTP que ele deu |
| nem sequer responde (está fora do ar) | {"canal":"erp","error":"UnknownHostException"}, com o nome do erro |
Para isso usam doTry e doCatch: tenta a chamada e, se ela falhar, captura o erro e o transforma em linha.
Por que tanto cuidado? Porque ao testar esta lição vimos que, sem as rotas de canal, quando um serviço estava fora do ar o router devolvia à loja o pedido completo, com o nome e o e-mail do cliente. Uma resposta de erro nunca deve levar dados pessoais.
Hoje a rota principal só chama um dos três:
- to:
uri: direct:canal-api
direct: é uma chamada a outra rota do mesmo arquivo, sem rede no meio. O TODO de cima diz o que falta.
3. Faça a previsão
Responda em um papel:
- Com o router como está, se o pedido 1003 for mandado, que destinos o recebem?
- Quando ele for mandado aos três: se o ERP estiver fora do ar, a API e o parceiro recebem o pedido ou não?
- Nesse caso, que código HTTP a loja deve receber?
Confira a primeira:
./verifica
Saem quatro marcas vermelhas. A API tem o pedido; o ERP e o parceiro não têm nada.
4. Escreva o multicast
Troque o to: direct:canal-api por um multicast que chame os três canais:
- multicast:
parallelProcessing: true
aggregationStrategy: "#juntarRespuestas"
steps:
- to:
uri: direct:canal-api
# … los otros dos canales
| Parâmetro | O que faz |
|---|---|
parallelProcessing: true |
Os três ao mesmo tempo. Sem isto, um depois do outro: o parceiro esperaria o ERP terminar |
aggregationStrategy: "#juntarRespuestas" |
Como as três respostas são reunidas. juntarRespuestas é um bean que já vem declarado no alto, e as coloca em uma lista |
Depois do multicast, o corpo é essa lista de três linhas. Responda à loja com um setBody:
{"orden":"${variable.orden}","canales":[${join(",")}]}
${join(",")} une as três linhas da lista separando-as com vírgulas. Use a notação canônica, como nos demais
setBody do arquivo (expression: → simple: → expression:).
5. Suba e mande um pedido
Antes de subir à mão, anote a chave do parceiro na pasta do int-edi: é o serviço que se conecta ao SFTP dele, como na 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
Espere os quatro Started. Em outro terminal, a partir da raiz do curso:
curl -s -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' -d @datos/ordenes/orden-1001.json
A loja recebe o que cada canal disse:
{"orden":"1001","canales":[{"canal":"api","codigo":201},{"canal":"erp","codigo":200},{"canal":"socio","codigo":200}]}
Os canais trabalham ao mesmo tempo, mas o router espera os três terminarem antes de responder, e a lista sai na ordem em que estão escritos no YAML (api, erp, socio), não na ordem em que foram terminando. Repare nos logs: as três linhas de «contestó» do router saem quase ao mesmo tempo, e a ordem delas, sim, pode mudar de uma execução para outra.
Se o canal do parceiro disser 500, confira o log do int-edi. Se aparecer reject HostKey, faltou anotar a chave.
6. Desligue um canal
Agora a pergunta 2. Com tudo no ar, desligue só o int-bd e mande outro pedido:
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
- A API e o parceiro receberam, sim, o pedido. Um canal fora do ar não detém os outros dois.
- A linha do ERP diz
UnknownHostException: o router procurou oint-bdpelo nome e ninguém respondeu. - A loja recebeu um 200, embora um destino não tenha o pedido.
Se este passo for repetido com o mesmo pedido, o parceiro responde 500: ele já tem esse 850 e não o sobrescreve, como na 07.
Reveja a previsão 3. E agora a pergunta que a lição deixa: o que fazemos com o ERP, que não tem o pedido? Mandamos de novo? Quando? E se a API já o tem: mandamos de novo para ela também? Escreva a resposta: ela será comparada com o que for construído nas lições 19 e 22.
Desligue tudo:
DONDE=mio docker compose -f compose.yaml down
7. O fio nos três destinos
O fio da 09 viaja no envelope para os três canais. Mas cada destino o guarda de um jeito:
| Destino | Onde fica o fio |
|---|---|
| API | No log dela: correlacion=<id> |
| ERP | Na coluna nova pedido_cabecera.correlacion |
| Parceiro | Em nenhuma parte do arquivo. O int-edi o anota no próprio log, e o 850 sai igual ao da 07 |
Por que não o mandamos ao parceiro? Porque ao parceiro só se enviam os campos que o formato X12 combina com ele. O
fio é nosso, da nossa integração; colocá-lo em um campo que o parceiro não pediu não se faz. Com o parceiro, o fio
já existe: são os números de controle do 850 vistos na 06. Quando o parceiro responder com a confirmação de recebimento,
o 997, o AK1 dele cita o GS06 (o do grupo) e o AK2 o ST02 (o da transação). O ISA13, o do
envelope completo, é citado por outra confirmação, o TA1. Isso é usado na lição 21.
Nem todos os destinos podem guardar o ID da integração. Por isso, mais adiante, uma base de estado vai unir o fio ao número de controle.
8. Confira
./verifica
O verifica reinicia a API, esvazia o ERP e a caixa postal do parceiro, anota a chave do parceiro em mio/int-edi/, sobe os
quatro serviços e manda o pedido 1003 com um fio próprio. Está concluída quando aparecem as seis marcas verdes:
✅ 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)
Três das seis são confirmadas pelo próprio destino: o registro da API, a tabela do ERP e a caixa postal do parceiro.
Não roda? ./verifica solucion testa a nossa, e
diff mio/orden-router/orden-router.camel.yaml solucion/orden-router/orden-router.camel.yaml diz em que elas são
diferentes.
| O que aparece | O que fazer |
|---|---|
Tu ERP no tiene la columna correlacion |
Recrie o ERP com o comando do início |
| Vermelho só no ERP, ou só no parceiro | Esse canal não está no multicast |
El router no contestó que los tres canales la recibieron e só aparece uma linha |
Falta o setBody com ${join(",")}, ou o multicast continua sendo um único to |
El puerto 8080 está ocupado |
Os serviços ficaram no ar: DONDE=mio docker compose -f compose.yaml down |
Por que foi feito assim
O que decidimos nesta lição, com o que descartamos e o que nos faria mudar de ideia:
- O fio de correlação viaja com o pedido, mas não sai de casa
- O pedido sai para todos os canais, e o router conta o que aconteceu
Revisão
- O que faz um multicast, e o que muda com
parallelProcessing: true? - Para que serve o bean
juntarRespuestas, e o que faz${join(",")}? - Por que cada canal deixa uma linha mesmo que o serviço dele esteja fora do ar? O que teria escapado sem isso?
- Com o ERP fora do ar, que destinos receberam o pedido e que código a loja recebeu? Por que esse código é um problema?
- Por que o fio não é mandado ao parceiro, e que número cumpre esse papel com ele?
A seguir: na lição 11 nem todos os pedidos vão para todos os destinos: o router decide para quais, conforme o que o pedido trouxer.
Prefere e-mail? Escreva para hola@habil.mx