Общая информация

Apache Camel — открытый кроссплатформенный java-фреймворк, который позволяет проводить интеграцию приложений в простой и понятной форме. Camel использует доменные языки (Domain Specific Language - DSL) для описания проектных шаблонов интеграции или маршрутов.

В Citeck используется Yaml DSL для описания маршрутов в формате YAML и XML DSL.

Camel-контекст – главная сущность Camel. Контекст является контейнером среды выполнения Camel. Контекст предоставляет много полезных сервисов, наиболее значимыми являются маршруты, компоненты, языки, конверторы типов, реестр, endpointы и форматы данных.

Маршрут – определение интеграционного потока. Например, для объединения двух систем маршрут определяет, как именно эти системы взаимодействуют.

Компоненты — подробно описаны в официальном справочнике Apache Camel. Выбирайте версию справочника, соответствующую версии Camel в вашем приложении; в проверенной конфигурации используется Camel 4.14.8.

Компонент

Описание

Bean

Для вызова методов Java-бинов, хранящихся в реестре

Direct

Вызывает другой endpoint из того же контекста синхронно

File

Читает и записывает файлы

Timer

Генерирует сообщения с определенным интервалом, используя java.util.Timer

JDBC

Предоставляет доступ к базам данных через JDBC

Jetty

Предоставляет endpoint на основе HTTP для получения и отправки HTTP запросов

Журнал доступен по адресу: v2/journals?journalId=ecos-camel-dsl&viewMode=table&ws=admin$workspace

../../_images/camel_dsl.png

Пример контекста с маршрутом:

../../_images/Camel_1.png

Тип запуска:

Тип

Описание

MANUALLY

Работает, как и обычный Camel DSL. Запускается и останавливается через действие

IMPORT_DATA

Используется для описания обработки файла при Импорте данных

В контекст Camel DSL можно прикладывать файлы в формате base64. В конфиге можно указать название файла и его контент:

file:
  name: Пользователи.xlsx
  content: 'UEsDLVsnEoVzlgUAAJYFAAATAAAAW0NvbnRlbnRfVHlwZXNdLnhtbDw/eG1sIHZlcnNpb249IjEuMCIgZW5jb2Rpbmc9IlVURi04IiBzd='

После деплоя в Camel DSL будет сразу приложенный файл:

../../_images/Camel_content.png

Примечание

Атрибут = свойство = поле

Целевая БД = БД назначения = целевой источник данных — куда данные помещаются

Исходная БД = исходный источник данных — откуда данные берутся