HTTP Trigger
Общее описание
Блок HTTP Trigger – это инициирующий блок интеграционного потока, который позволяет принимать входящие запросы на указанный ресурс по HTTP.
Блок HTTP Trigger может использоваться только в качестве инициирующего блока.
Настройка блока
В данном разделе описаны параметры блока, которые необходимо заполнить при настройке.
Базовые параметры
| Название в UI (имя атрибута в коде) | Обязательный | Описание | Значение по умолчанию | Тип данных |
|---|---|---|---|---|
| path | Да | Путь, по которому конечная точка обрабатывает HTTP-запросы, для прокси-серверов - 'proxy' | Строка | |
| consumes | Тип контента, который конечная точка принимает в качестве входных данных, например application/xml или application/json. null или / означает отсутствие ограничений. | Строка | ||
| cookieDomain | Определяет какой сервер может получать файлы cookie | Строка | ||
| cookieHttpOnly | Да | Определяет следует ли запрещать клиентским скриптам доступ к созданным файлам cookie | False | Логическое значение |
| cookieMaxAge | Устанавливает максимальное время жизни файлов cookie в секундах | Длинное целое число | ||
| cookiePath | Задаёт путь к URL, который должен существовать в запрашиваемом URL, чтобы можно было отправлять файлы cookie | / | Строка | |
| cookieSameSite | Указывает, должен ли браузер блокировать отправку файлов cookie вместе с межсайтовыми запросами. Возможные значения:
| LAX | Список | |
| cookieSecure | Да | Указывает, отправляется ли файл cookie на сервер только с зашифрованным запросом по протоколу HTTPS | False | Логическое значение |
| handleWriteResponseError | Да | Определяет, следует ли перехватывать любые сбои при записи ответа и сохранять их в памяти для доступа к этим данным в процессе работы интеграционного потока | False | Логическое значение |
| httpMethodRestrict | Список HTTP-методов, разделенных запятыми, например GET, POST. Если методы не указаны, будут доступны все методы | Строка | ||
| matchOnUriPrefix | Да | Определяет будет ли выполняться поиск ресурса по префиксу URI | False | Логическое значение |
| muteException | Да | Если эта функция включена, и система не смогла обработать запрос во время обработки данных блоком-инициатором, в теле ответа не будет трассировки стека ошибки | True | Логическое значение |
| produces | Тип контента, который возвращает ресурс, например application/xml или application/json | Строка | ||
| returnHttpRequestHeaders | Да | Определяет следует ли включать заголовки HTTP-запросов (Accept, User-Agent и т. д.) в HTTP-ответ, формируемый системой | False | Логическое значение |
| useCookieHandler | Да | Определяет следует ли включить обработчик файлов cookie, который позволяет добавлять файлы cookie, устанавливать время жизни и извлекать их | False | Логическое значение |
| useStreaming | Да | Определяет следует ли использовать потоковую передачу для больших запросов и ответов | False | Логическое значение |
Расширенные параметры
| Название в UI (имя атрибута в коде) | Обязательный | Описание | По умолчанию | Тип данных |
|---|---|---|---|---|
| bridgeErrorHandler | Позволяет связать блок-инициатор с обработчиком ошибок маршрутизации. Это означает, что любые ошибки (если есть), возникающие при попытке потребителя ESB получить входящие сообщения и т.п., теперь будут обрабатываться как сообщения и обрабатываться обработчиком ошибок маршрутизации. Важно: это возможно только в том случае, если сторонний компонент позволяет ESB получать уведомления о возникновении ошибок. Некоторые компоненты обрабатывают их только внутри себя, поэтому использование bridgeErrorHandler невозможно | False | Логическое значение | |
| exceptionHandler | Предназначен для того, чтобы блок-инициатор мог использовать собственный ExceptionHandler. Обратите внимание: если включена опция bridgeErrorHandler, то эта опция не используется. По умолчанию блок-инициатор будет обрабатывать исключения, которые будут регистрироваться на уровне WARN или ERROR и игнорироваться | Строка | ||
| exchangePattern | Устанавливает шаблон обмена во время начала обработки сообщения блоком-инициатором. Возможные значения:
| Список | ||
| fileNameExtWhitelist | Список расширений файлов, разделённых запятыми или пробелами. Файлы с такими расширениями будут храниться локально. Нулевое значение или звёздочка (*) разрешают загрузку всех файлов | Строка | ||
| headerFilterStrategy | Предназначен для того, чтобы использовать пользовательскую логику фильтрации заголовков в отправляемых и получаемых сообщениях | Строка | ||
| platformHttpEngine | Предназначен для использования HTTP движка для обработки запросов к ресурсу | Строка |