Общая информация
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
Пример контекста с маршрутом:
Тип запуска:
Тип |
Описание |
|---|---|
MANUALLY |
Работает, как и обычный Camel DSL. Запускается и останавливается через действие |
IMPORT_DATA |
Используется для описания обработки файла при Импорте данных |
В контекст Camel DSL можно прикладывать файлы в формате base64. В конфиге можно указать название файла и его контент:
file:
name: Пользователи.xlsx
content: 'UEsDLVsnEoVzlgUAAJYFAAATAAAAW0NvbnRlbnRfVHlwZXNdLnhtbDw/eG1sIHZlcnNpb249IjEuMCIgZW5jb2Rpbmc9IlVURi04IiBzd='
После деплоя в Camel DSL будет сразу приложенный файл:
Примечание
Атрибут = свойство = поле
Целевая БД = БД назначения = целевой источник данных — куда данные помещаются
Исходная БД = исходный источник данных — откуда данные берутся