Índice do curso
Lição 01 — Minha primeira rota roda
Por Dorian Chávez · cofundador e Chief Executive Officer da Hábil ·
O que será alcançado: rodar uma rota de Camel, prever o que ela faz antes de ver e dar nome às três peças dela. É a única lição em que não se escreve nada do zero: a rota já vem pronta.
Antes de começar é preciso ter: a lição 00 concluída e o Docker funcionando. Nada mais: não se instala Java nem Camel.
O que é o Camel, em uma frase: um programa que move informação de um sistema para outro seguindo as instruções que alguém escreve para ele. Essas instruções se chamam rota. Hoje a rota move um arquivo de uma pasta para outra, que é o mais simples que existe. Nas próximas lições, a mesma ideia vai mover pedidos de uma loja entre sistemas que não se conhecem.
⚠️ Trabalhe dentro da pasta pessoal (~, por exemplo ~/practicas/), nunca em /tmp. No Mac com colima,
o Docker só consegue enxergar as pastas que estão dentro da home. Se o repositório foi clonado em outro lugar, a rota falha com
«Source file does not exist».
1. Prepare a pasta
Todo o trabalho próprio vai em mio/. É uma cópia de inicio/ e o git não a acompanha, então ali se pode quebrar o que quiser.
cd lecciones/01-mi-primera-ruta # entra a la carpeta de la lección
cp -R inicio mio # copia inicio/ completa (-R: con todo lo de adentro) y la llama mio/
cd mio # entra a tu copia
2. Leia a rota e faça a previsão
Abra primera-ruta.camel.yaml com o editor. Está escrita em YAML, um formato de texto em que a indentação
(os espaços no início de cada linha) indica o que vai dentro de quê, como as pastas dentro de pastas. Sem os
comentários, é isto:
- route:
id: primera-ruta
from:
uri: file:entrada
parameters:
include: ".*\\.json"
steps:
- log:
message: "Llegó la orden del archivo ${header.CamelFileName}: ${body}"
- to:
uri: file:salida
Antes de rodá-la, escreva as respostas em um papel (não há respostas erradas; o que importa é compará-las depois):
- Se um arquivo
orden-1001.jsonfor colocado na pastaentrada/, o que deve aparecer na tela? - Onde o arquivo vai terminar?
- O que vai ficar em
entrada/quando a rota terminar com ele?
3. Rode a rota
Coloque um pedido em entrada/ e inicie a rota:
mkdir -p entrada # crea la carpeta entrada/ (si ya existe, no pasa nada)
cp ../../../datos/ordenes/orden-1001.json entrada/ # copia la orden de ejemplo; ../ sube una carpeta
../../../herramientas/camel run primera-ruta.camel.yaml
O pedido é um arquivo JSON: texto com pares de nome e valor ("orden": "1001"). Abra-o antes de rodar:
é o que vai viajar.
Na primeira vez demora um pouco, porque o Docker baixa a imagem do Camel. Quando aparecer uma linha com
Started primera-ruta, a rota já está escutando. Alguns segundos depois aparece o anúncio do pedido. Para
pará-la, pressione Ctrl+C.
4. Compare com a previsão
Veja as três respostas e confira as pastas:
ls salida/ # lista lo que hay en salida/
ls -a entrada/ # -a muestra también lo escondido (lo que empieza con punto)
- A tela: o log diz
Llegó la orden del archivo orden-1001.json:e depois o pedido completo.${header.CamelFileName}foi trocado pelo nome do arquivo e${body}pelo conteúdo dele. - O arquivo: está em
salida/, idêntico a como entrou. entrada/: parece vazia, masls -amostra uma pasta escondida,.camel/, e dentro dela está o pedido. O Camel não apaga o que lê: separa para não processar de novo. Isso estava na previsão?
Se alguma resposta não coincidiu, anote por que isso deve ter acontecido. Essa anotação vale mais do que ter acertado.
5. Dê nome ao que apareceu
A rota tem três peças. Nomeie-as com uma imagem e depois com o nome formal:
| O que aparece no YAML | A imagem | O nome nos padrões de integração (EIP) |
|---|---|---|
A rota inteira: de from a to, passando por log |
A tubulação | Pipes and Filters |
file:entrada e file:salida, por onde se entra e se sai |
As estações | Message Endpoint |
| O pedido que viaja, com o nome de arquivo e o conteúdo dele | A carta | Message |
Os EIP (Enterprise Integration Patterns) são nomes que qualquer equipe de integração do mundo reconhece. Não é preciso memorizá-los hoje: em cada lição aparece um novo, bem na hora em que é usado.
Exercício: no mio/primera-ruta.camel.yaml, escreva acima de cada parte um comentário com o nome dela
(# estación, # tubería, # carta). Na carta há um detalhe: ela não aparece escrita no YAML. Por quê?
6. Mude a rota
Agora modifique a rota. Depois de cada mudança, coloque de novo o pedido em entrada/ e rode outra vez:
- Mude a mensagem do log para que diga
Recibí la orden ${header.CamelFileName}. Antes de rodar: o que se espera ver? - Mude a estação de saída para
file:procesadas. Que pasta nova se espera ver? - Coloque um arquivo que não seja
.jsonementrada/, por exemplonota.txt. A rota o pega? Que linha do YAML decide isso?
7. Confira
A partir da pasta da lição, não de mio/:
cd ..
./verifica
⚠️ O verifica esvazia e volta a encher mio/entrada/ e mio/salida/ para testar do zero. Na rota ele não mexe.
Está concluída quando aparecem as cinco marcas verdes:
✅ La ruta arrancó
✅ El log anunció la orden
✅ La orden llegó a salida/
✅ entrada/ quedó vacía
✅ Salió idéntica a como entró
Se a saída foi trocada para procesadas/ no passo 6, volte para salida/ antes de conferir.
Não roda? Tente com a nossa: ./verifica solucion. Se a nossa sai em verde e a própria não, compare as duas
com diff mio/primera-ruta.camel.yaml solucion/primera-ruta.camel.yaml. Usar a nossa não é trapaça: serve para que
um erro de hoje não atrapalhe as lições seguintes.
8. O mapa da viagem
Não é preciso entender isto hoje. O mapa do que será construído é o programa do README do curso: segue a ordem em que o pedido viaja, de quando é criado até que não se perca. Cada peça chega na própria lição; hoje bastam a rota, o endpoint e a mensagem.
Por que Camel: partimos de premissas, não de gostos. Buscamos algo leve, que escale por serviço, que se defina por configuração e que tenha licença aberta. No fim do curso, quem o fez mede por conta própria o que se ganha e o que se cede. O detalhe está em Por que Camel.
Por que foi feito assim
O que decidimos nesta lição, com o que descartamos e o que nos faria mudar de ideia:
- Apache Camel como motor de integração
- Rotas em YAML, na forma canônica
Revisão
Sem olhar o YAML, responda:
- O que faz
from, e o que fazto? - O que é a carta nesta rota, e por que não está escrita no YAML?
- O que o Camel faz com um arquivo que já leu?
- Para que a rota só pegasse arquivos
.xml, que linha seria preciso mudar? - O
nota.txtfoi colocado ementrada/. A rota o pegou? Que parte do YAML decidiu isso?
A seguir: na lição 02, a estação de entrada deixa de ser uma pasta: o pedido chega por HTTP e sai para uma API.
Prefere e-mail? Escreva para hola@habil.mx