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

Урок 01 — Първият ми маршрут работи

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

Преди да го пуснеш, запиши на лист хартия отговорите си (няма грешни отговори; важното е да ги сравниш след това):

  1. Ако сложиш файл orden-1001.json в папката entrada/, какво според теб ще се появи на екрана?
  2. Къде ще се озове файлът накрая?
  3. Какво ще остане в 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/ и го пусни отново:

  1. Смени съобщението в лога, за да казва Recibí la orden ${header.CamelFileName}. Преди да го пуснеш: какво очакваш да видиш?
  2. Смени изходната гара на file:procesadas. Каква нова папка очакваш да видиш?
  3. Сложи файл, който не е .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-а, отговори:

  1. Какво прави from и какво прави to?
  2. Какво е писмото в този маршрут и защо не е написано в YAML-а?
  3. Какво прави Camel с файл, който вече е прочел?
  4. Ако искаше маршрутът да взема само .xml файлове, кой ред би променил?
  5. Сложи nota.txt в entrada/. Взе ли го маршрутът? Коя част от YAML-а реши това?

Следва: в урок 02 входната гара вече не е папка: поръчката пристига по HTTP и излиза към един API.

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

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