JSLT

Поддерживается только производитель

Компонент JSLT позволяет обрабатывать JSON-сообщения с помощью JSLT- (opens in a new tab) выражений. Это может быть идеальным решением для преобразования JSON в JSON или запросов к данным.

Пользователям Maven необходимо добавить следующую зависимость для pom.xmlэтого компонента:

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jslt</artifactId>
    <version>x.x.x</version>
    <!-- use the same version as your Camel core version -->
</dependency>

URI format

jslt:specName[?options]

Где specName -- это локальный URI classpath спецификации, которую нужно вызвать; или полный URL удаленной спецификации (например: file://folder/myfile.vm).

Configuring Options

Компоненты Camel настраиваются на двух отдельных уровнях:

• уровень компонентов

• уровень конечной точки

Configuring Component Options

На уровне компонентов задаются общие и общие конфигурации, которые затем наследуются конечными точками. Это самый высокий уровень конфигурации.

Например, компонент может иметь настройки безопасности, учетные данные для аутентификации, URL-адреса для сетевого подключения и т. д.

У некоторых компонентов всего несколько параметров, а у других -- много. Поскольку компоненты обычно имеют предустановленные значения по умолчанию, которые широко используются, зачастую вам может потребоваться настроить лишь несколько параметров компонента, а то и вовсе ни одного.

Вы можете настроить компоненты, используя:

• Компонент DSL (opens in a new tab) .

• в файле конфигурации ( application.propertiesфайлы *.yaml, и т.д.).

• непосредственно в коде Java.

Configuring Endpoint Options

Настройка конечных точек обычно занимает больше времени, поскольку у них есть множество параметров. Эти параметры помогают вам настроить функции конечной точки. Параметры также классифицируются по тому, используется ли конечная точка как потребитель ( от ), как производитель ( от ) или и то, и другое.

Конечные точки чаще всего настраиваются непосредственно в URI конечной точки в виде параметров пути и запроса . Вы также можете использовать Endpoint DSL (opens in a new tab) и DataFormat DSL (opens in a new tab) в качестве типобезопасного способа настройки конечных точек и форматов данных в Java.

Хорошей практикой при настройке параметров является использование заполнителей свойств (opens in a new tab) .

Заполнители свойств обеспечивают несколько преимуществ:

• Они помогают предотвратить использование жестко запрограммированных URL-адресов, номеров портов, конфиденциальной информации и других настроек.

• Они позволяют вынести конфигурацию за пределы кода.

• Они помогают коду стать более гибким и пригодным для повторного использования.

В следующих двух разделах перечислены все параметры, сначала для компонента, а затем для конечной точки.

Component Options

Компонент JSLT поддерживает 6 опций, которые перечислены ниже.

allowTemplateFromHeader (producer)

• Разрешить или запретить использование шаблона ресурса из заголовка (по умолчанию -- false). Включение этого параметра позволяет указывать динамические шаблоны через заголовок сообщения. Однако это может рассматриваться как потенциальная уязвимость безопасности, если заголовок исходит от злоумышленника, поэтому используйте этот параметр с осторожностью.

• По умолчанию: false

• Тип: boolean

contentCache (producer)

• Устанавливает, использовать ли кэш содержимого ресурсов или нет.

• По умолчанию: true

• Тип: boolean

lazyStartProducer (producer)

• Следует ли запускать производитель в режиме ленивого запуска (при первом сообщении). Запуск в режиме ленивого запуска позволяет разрешить запуск CamelContext и маршрутов в ситуациях, когда производитель может выйти из строя при запуске, что приведет к сбою запуска маршрута. Отложив запуск в режим ленивого запуска, можно обработать сбой запуска во время маршрутизации сообщений с помощью обработчиков ошибок маршрутизации Camel. Имейте в виду, что после обработки первого сообщения создание и запуск производителя могут занять некоторое время и увеличить общее время обработки.

• По умолчанию: false

• Тип: boolean

autowiredEnabled (advanced)

• Включено ли автоматическое связывание. Это используется для параметров автоматического связывания (параметр должен быть помечен как autowired) путём поиска в реестре экземпляра соответствующего типа, который затем настраивается в компоненте. Это может использоваться для автоматической настройки источников данных JDBC, фабрик JMS-подключений, клиентов AWS и т. д.

• По умолчанию: true

• Тип: boolean

functions (advanced)

• JSLT можно расширить, подключив функции, написанные на Java.

• По умолчанию:

• Тип: Collection

objectFilter (advanced)

• JSLT можно расширить, подключив пользовательский фильтр объектов jslt.

• По умолчанию:

• Тип: JsonFilter

Endpoint Options

Конечная точка JSLT настраивается с использованием синтаксиса URI:

jslt:resourceUri

Со следующими параметрами пути и запроса :

Path Parameters (1 parameters)

resourceUri (producer)

• Тип: ребуемый путь к ресурсу. Можно указать префикс: classpath, file, http, ref или bean. classpath, file и http загружают ресурс по этим протоколам (classpath используется по умолчанию). ref ищет ресурс в реестре. bean вызывает метод bean-компонента, который будет использоваться в качестве ресурса. Для bean-компонента можно указать имя метода после точки, например, bean:myBean.myMethod.

• По умолчанию:

• Тип: String

Query Parameters (7 parameters)

allowContextMapAll (producer)

• Определяет, должна ли карта контекста разрешать доступ ко всем данным. По умолчанию доступен только текст и заголовки сообщения. Этот параметр можно включить для полного доступа к текущему Exchange и CamelContext. Это может представлять потенциальную угрозу безопасности, поскольку открывает доступ ко всем возможностям API CamelContext.

• По умолчанию: false

• Тип: boolean

allowTemplateFromHeader (producer)

• Разрешить или запретить использование шаблона ресурса из заголовка (по умолчанию -- false). Включение этого параметра позволяет указывать динамические шаблоны через заголовок сообщения. Однако это может рассматриваться как потенциальная уязвимость безопасности, если заголовок исходит от злоумышленника, поэтому используйте этот параметр с осторожностью.

• По умолчанию: false

• Тип: boolean

contentCache (producer)

• Устанавливает, использовать ли кэш содержимого ресурсов или нет.

• По умолчанию: true

• Тип: boolean

mapBigDecimalAsFloats (producer)

• Если значение равно true, то преобразователь будет использовать USE_BIG_DECIMAL_FOR_FLOATS в функциях сериализации.

• По умолчанию: false

• Тип: boolean

objectMapper (producer)

• Настройка пользовательского сопоставления объектов JSON, которое будет использоваться.

• По умолчанию:

• Тип: ObjectMapper

prettyPrint (common)

• Если true, JSON в выходном сообщении отображается корректно.

• По умолчанию: false

• Тип: boolean

lazyStartProducer (producer (advanced))

• Следует ли запускать производитель в режиме ленивого запуска (при первом сообщении). Запуск в режиме ленивого запуска позволяет разрешить запуск CamelContext и маршрутов в ситуациях, когда производитель может выйти из строя при запуске, что приведет к сбою запуска маршрута. Отложив запуск в режим ленивого запуска, можно обработать сбой запуска во время маршрутизации сообщений с помощью обработчиков ошибок маршрутизации Camel. Имейте в виду, что после обработки первого сообщения создание и запуск производителя могут занять некоторое время и увеличить общее время обработки.

• По умолчанию: false

• Тип: boolean

Message Headers

Компонент JSLT поддерживает 2 заголовка сообщения, которые перечислены ниже:

CamelJsltString (producer)

Constant: HEADER_JSLT_STRING (opens in a new tab)

• Шаблон JSLT в виде строки.

• По умолчанию:

• Тип: String

CamelJsltResourceUri (producer)

Constant: HEADER_JSLT_RESOURCE_URI (opens in a new tab)

• URI ресурса.

• По умолчанию:

• Тип: String

Usage

Passing values to JSLT

Camel может предоставлять информацию обмена в виде переменных при применении выражения JSLT к телу. Доступны следующие переменные обмена :

headers

• Заголовки сообщения In как объект JSON

variables

• Переменные

exchange.properties

• Свойства Exchange как JSON-объект. exchange-- имя переменной и propertiesпуть к свойствам Exchange. Доступно, если allowContextMapAllопция имеет значение true.

Все значения, которые невозможно преобразовать в JSON с помощью Джексона, отклоняются и не будут доступны в выражении JSLT.

Например, к названному заголовку typeи свойству обмена instanceможно получить доступ следующим образом:

{
  "type": $headers.type,
  "instance": $exchange.properties.instance
}

Examples

Например, вы можете использовать что-то вроде:

from("activemq:My.Queue").
  to("jslt:com/acme/MyResponse.json");

И файловый ресурс:

from("activemq:My.Queue").
  to("jslt:file://myfolder/MyResponse.json?contentCache=true").
  to("activemq:Another.Queue");

Вы также можете указать, какое выражение JSLT компонент должен использовать динамически через заголовок, например:

from("direct:in").
  setHeader("CamelJsltResourceUri").constant("path/to/my/spec.json").
  to("jslt:dummy?allowTemplateFromHeader=true");

Или отправьте целое выражение JSLT через заголовок: (подходит для запросов)

from("direct:in").
  setHeader("CamelJsltString").constant(".published").
  to("jslt:dummy?allowTemplateFromHeader=true");

Передача свойств обмена в выражение jslt может быть выполнена следующим образом:

from("direct:in").
  to("jslt:com/acme/MyResponse.json?allowContextMapAll=true");

Spring Boot Auto-Configuration

При использовании jslt с Spring Boot обязательно используйте следующую зависимость Maven для поддержки автоматической настройки:

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jslt-starter</artifactId>
  <version>x.x.x</version>
  <!-- use the same version as your Camel core version -->
</dependency>

Компонент поддерживает 7 опций, которые перечислены ниже.

camel.component.jslt.allow-template-from-header

• Разрешить или запретить использование шаблона ресурса из заголовка (по умолчанию -- false). Включение этого параметра позволяет указывать динамические шаблоны через заголовок сообщения. Однако это может рассматриваться как потенциальная уязвимость безопасности, если заголовок исходит от злоумышленника, поэтому используйте этот параметр с осторожностью.

• По умолчанию: false

• Тип: Boolean

camel.component.jslt.autowired-enabled

• Включено ли автоматическое связывание. Это используется для параметров автоматического связывания (параметр должен быть помечен как autowired) путём поиска в реестре экземпляра соответствующего типа, который затем настраивается в компоненте. Это может использоваться для автоматической настройки источников данных JDBC, фабрик JMS-подключений, клиентов AWS и т. д.

• По умолчанию: true

• Тип: Boolean

camel.component.jslt.content-cache

• Устанавливает, использовать ли кэш содержимого ресурсов или нет.

• По умолчанию: true

• Тип: Boolean

camel.component.jslt.enabled

• Включить ли автоматическую настройку компонента jslt. По умолчанию эта опция включена.

• По умолчанию:

• Тип: Boolean

camel.component.jslt.functions

• JSLT можно расширить, подключив функции, написанные на Java.

• По умолчанию:

• Тип: Collection

camel.component.jslt.lazy-start-producer

• Тип: Следует ли запускать производитель в режиме ленивого запуска (при первом сообщении). Запуск в режиме ленивого запуска позволяет разрешить запуск CamelContext и маршрутов в ситуациях, когда производитель может выйти из строя при запуске, что приведет к сбою запуска маршрута. Отложив запуск в режим ленивого запуска, можно обработать сбой запуска во время маршрутизации сообщений с помощью обработчиков ошибок маршрутизации Camel. Имейте в виду, что после обработки первого сообщения создание и запуск производителя могут занять некоторое время и увеличить общее время обработки.

• По умолчанию: false

• Тип: Boolean

camel.component.jslt.object-filter

• SLT можно расширить, подключив пользовательский фильтр объектов JSLT. Этот параметр относится к типу com.schibsted.spt.data.jslt.filters.JsonFilter.

• По умолчанию:

• Тип: JsonFilter