Съдържание на курса
Урок 01 — Първият ми маршрут работи
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: да пуснеш един маршрут на Camel, да предвидиш какво прави, преди да го видиш, и да дадеш име на трите му части. Това е единственият урок, в който не пишеш нищо от нулата: маршрутът вече е готов.
Преди да започнеш, ти трябват: завършен урок 00 и работещ Docker. Нищо повече: не инсталираш Java, нито Camel.
Какво е Camel, в едно изречение: програма, която мести информация от една система към друга, като следва инструкциите, които ти ѝ пишеш. Тези инструкции се наричат маршрут. Днес маршрутът мести един файл от една папка в друга — най-простото нещо, което съществува. В следващите уроци същата идея ще мести поръчките на един магазин между системи, които не се познават.
⚠️ Работи в личната си папка (~, например ~/practicas/), никога в /tmp. На Mac с colima
Docker вижда само папките, които са вътре в твоя home. Ако си клонирал хранилището другаде, маршрутът се проваля със
Source file does not exist.
1. Подготви папката си
Всичко твое отива в mio/. Тя е копие на inicio/ и git не я следи, така че там можеш да чупиш каквото поискаш.
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. Прочети маршрута и предвиди
Отвори primera-ruta.camel.yaml с редактора си. Написан е на YAML — текстов формат, в който отстъпът
(интервалите в началото на всеки ред) показва кое в кое влиза, като папки в папки. Без
коментарите изглежда така:
- 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
Преди да го пуснеш, запиши на лист хартия отговорите си (няма грешни отговори; важното е да ги сравниш след това):
- Ако сложиш файл
orden-1001.jsonв папкатаentrada/, какво според теб ще се появи на екрана? - Къде ще се озове файлът накрая?
- Какво ще остане в
entrada/, когато маршрутът приключи с него?
3. Пусни го
Сложи една поръчка в entrada/ и стартирай маршрута:
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
Поръчката е JSON файл: текст с двойки име и стойност ("orden": "1001"). Отвори го, преди да пуснеш маршрута:
точно това ще пътува.
Първия път се бави малко, защото Docker сваля образа на Camel. Когато видиш ред със
Started primera-ruta, маршрутът вече слуша. Няколко секунди по-късно се появява съобщението за поръчката. За да
го спреш, натисни Ctrl+C.
4. Сравни с предвиждането си
Погледни трите си отговора и провери папките:
ls salida/ # lista lo que hay en salida/
ls -a entrada/ # -a muestra también lo escondido (lo que empieza con punto)
- Екранът: логът казва
Llegó la orden del archivo orden-1001.json:(„пристигна поръчката от файла…“), а след това цялата поръчка.${header.CamelFileName}е заменено с името на файла, а${body}— със съдържанието му. - Файлът: той е в
salida/, същият, какъвто е влязъл. entrada/: изглежда празна, ноls -aпоказва една скрита папка,.camel/, и вътре е твоята поръчка. Camel не изтрива това, което чете: отделя го настрана, за да не го обработи отново. Беше ли го предвидил?
Ако някой отговор не съвпадна, запиши защо според теб е станало така. Тази бележка струва повече от това да си познал.
5. Дай име на това, което видя
Маршрутът има три части. Назови ги първо с картина, а после с официалното им име:
| Какво виждаш в YAML-а | Картината | Името му в шаблоните за интеграция (EIP) |
|---|---|---|
Целият маршрут: от from до to, през log |
Тръбата | Pipes and Filters |
file:entrada и file:salida, откъдето се влиза и излиза |
Гарите | Message Endpoint |
| Поръчката, която пътува, с името на файла и съдържанието си | Писмото | Message |
EIP (Enterprise Integration Patterns) са имена, които всеки интеграционен екип по света разпознава. Не е нужно да ги наизустяваш днес: във всеки урок се появява по един нов, точно когато го използваш.
Упражнение: в твоя mio/primera-ruta.camel.yaml напиши над всяка част коментар с името ѝ
(# estación, # tubería, # carta). При писмото има една подробност: то не е написано в YAML-а. Защо?
6. Промени го
Сега промени маршрута. След всяка промяна сложи пак поръчката в entrada/ и го пусни отново:
- Смени съобщението в лога, за да казва
Recibí la orden ${header.CamelFileName}. Преди да го пуснеш: какво очакваш да видиш? - Смени изходната гара на
file:procesadas. Каква нова папка очакваш да видиш? - Сложи файл, който не е
.json, вentrada/, напримерnota.txt. Взема ли го маршрутът? Кой ред от YAML-а решава това?
7. Провери
От папката на урока, не от mio/:
cd ..
./verifica
⚠️ verifica изпразва и пълни отново mio/entrada/ и mio/salida/, за да тества от нулата. Маршрута ти не го пипа.
Урокът е завършен, когато видиш петте зелени отметки:
✅ La ruta arrancó
✅ El log anunció la orden
✅ La orden llegó a salida/
✅ entrada/ quedó vacía
✅ Salió idéntica a como entró
Ако в стъпка 6 си сменил изхода на procesadas/, върни го на salida/, преди да проверяваш.
Не тръгва? Опитай с нашето решение: ./verifica solucion. Ако нашето излиза в зелено, а твоето — не, сравни двете
с diff mio/primera-ruta.camel.yaml solucion/primera-ruta.camel.yaml. Да ползваш нашето не е измама: то е, за да не
те спре днешна грешка в следващите уроци.
8. Картата на пътуването
Не е нужно да разбираш това днес. Картата на онова, което ще построиш, е програмата в README на курса: следва реда, в който пътува поръчката — от създаването ѝ до това да не се загуби. Всяка част идва в своя урок; днес ти трябват само маршрутът, endpoint-ът и съобщението.
Защо Camel: тръгнахме от предпоставки, не от вкусове. Търсехме нещо леко, което се мащабира услуга по услуга, което се дефинира с конфигурация и което е с отворен лиценз. В края на курса сам ще измериш какво печели и от какво отстъпва. Подробностите са в Защо Camel.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Apache Camel като интеграционен двигател
- Маршрути на YAML, в каноничната им форма
Преговор
Без да гледаш YAML-а, отговори:
- Какво прави
fromи какво правиto? - Какво е писмото в този маршрут и защо не е написано в YAML-а?
- Какво прави Camel с файл, който вече е прочел?
- Ако искаше маршрутът да взема само
.xmlфайлове, кой ред би променил? - Сложи
nota.txtвentrada/. Взе ли го маршрутът? Коя част от YAML-а реши това?
Следва: в урок 02 входната гара вече не е папка: поръчката пристига по HTTP и излиза към един API.
Предпочитате имейл? Пишете ни на hola@habil.mx