XSLT
Общее описание
Трансформационный блок XSLT позволяет обрабатывать сообщения с использованием шаблона XSLT.
Настройка блока
В данном разделе описаны параметры блока XSLT, которые необходимо заполнить при настройке и примеры заполнения значений этих параметров.
Базовые параметры блока XSLT
| Название в UI | Название атрибута | Обязательный | Описание | Значение по умолчанию | Тип данных |
|---|---|---|---|---|---|
| Загрузить схему или темплейт | В данном поле вы можете выбрать или загрузить схему или шаблон, выбрав его из списка загруженных файлов или в файловом навигаторе. | Файл | |||
| Allow Template From Header | allowTemplateFromHeader | Определяет разрешать ли использовать шаблон ресурса из заголовка или нет (по умолчанию false). Включение этого параметра позволяет указывать динамические шаблоны через заголовок сообщения. Однако это может рассматриваться как потенциальная уязвимость системы безопасности, если заголовок исходит от злоумышленника, поэтому используйте его с осторожностью. | False | Логическое значение | |
| Content Cache | contentCache | Определяет кэшировать ли содержимое ресурса (файл таблицы стилей) при его загрузке на старте. Если установлено значение false, файл таблицы стилей будет перезагружаться при обработке каждого сообщения. | True | Логическое значение | |
| Delete Output File | deleteOutputFile | Если у вас значение параметра Output установлено file, то этот параметр определяет, следует ли удалять выходной файл после завершения обработки. Например, если выходной файл является временным, его лучше удалять после использования. | False | Логическое значение | |
| Fail On Null Body | failOnNullBody | Определяет следует ли генерировать исключение, если тело входного сообщения пустое (NULL). | True | Логическое значение | |
| Output | output | Определяет тип вывода. Возможные значения:
Первые три значения параметра (string, bytes, DOM) задают сохранение в памяти. Если выбрано значение file, то файл передается непосредственно в java.io.File. Для файла вы должны указать имя файла в заголовке IN с ключом XsltConstants.XSLT_FILE_NAME. Кроме того, все пути к файлу должны быть созданы заранее, в противном случае во время выполнения будет сгенерировано исключение. | Список | ||
| Transformer Cache Size | transformerCacheSize | Количество объектов javax.xml.transform.Transformer, которые кэшируются для повторного использования, что позволяет избежать вызовов Template.newTransformer(). | Целочисленное значение |
Расширенные параметры блока XSLT
| Название в UI | Название | Обязательный | Описание | Значение по умолчанию | Тип данных |
|---|---|---|---|---|---|
| Lazy Start Producer | Lazy Start Producer | Определяет должен ли отправитель стартовать в отложенном режиме, т.е. при получении первого сообщения. Для выявления ошибок и отладки при активации потока, выставьте значение в False. Если поток используется редко или необходима его быстрая активация, то выставьте значение в True. Учтите, что обработка первого сообщения в этом случае будет замедлена. | False | Логическое значение | |
| Entity Resolver | Entity Resolver | Задает пользовательский обработчик, который указывает XSLT блоку, где найти дополнительные ресурсы (например, DTD, внешние схемы) для трансформации XML с использованием движка SAXSource. | Строка | ||
| Error Listener | Error Listener | Позволяет настроить пользовательский обработчик ошибок, перехватывающий предупреждения и ошибки во время XSLT-трансформации. Примечание: При указании пользовательского обработчика стандартный обработчик перестает действовать. Используйте эту опцию с осторожностью. | Строка | ||
| Result Handler Factory | Result Handler Factory | Позволяет использовать пользовательский интерфейс для обработки результата трансформации. | Строка | ||
| Transformer Factory Class | Transformer Factory Class | Задает полное и однозначное имя пользовательского класса для XSLT трансформации. | Строка | ||
| Transformer Factory Configuration Strategy | Transformer Factory Configuration Strategy | Задает стратегию настройки, применяемую к только что созданным экземплярам классов трансформации. | Строка | ||
| Uri Resolver | Uri Resolver | Задает пользовательский обработчик URI. | Строка | ||
| Xslt Message Logger | Xslt Message Logger | Получатель сообщений, сгенерированных во время преобразований XSLT. | Строка |