HTTP Trigger
Общее описание
Блок HTTP Trigger – это инициирующий блок интеграционного потока, который позволяет принимать входящие запросы на указанный ресурс по HTTP.
Блок HTTP Trigger может использоваться только в качестве инициирующего блока.
Настройка блока
В данном разделе описаны параметры блока, которые необходимо заполнить при его настройке.
Базовые параметры
| Название в UI | Название атрибута | Описание | Значение по умолчанию | Тип данных |
|---|---|---|---|---|
| Path | path | Обязательный параметр Путь, по которому конечная точка обрабатывает HTTP-запросы, для прокси-серверов - 'proxy' | Строка | |
| Consumes | consumes | Тип контента, который конечная точка принимает в качестве входных данных, например application/xml или application/json. null или / означает отсутствие ограничений. | Строка | |
| Cookie Domain | cookieDomain | Определяет какой сервер может получать файлы cookie | Строка | |
| cookieHttpOnly | Cookie Http Only | Определяет следует ли запрещать клиентским скриптам доступ к созданным файлам cookie | False | Логическое значение |
| Cookie Max Age | cookieMaxAge | Устанавливает максимальное время жизни файлов cookie в секундах | Длинное целое число | |
| Cookie Path | cookiePath | Задаёт путь к URL, который должен существовать в запрашиваемом URL, чтобы можно было отправлять файлы cookie | / | Строка |
| Cookie Same Site | cookieSameSite | Указывает, должен ли браузер блокировать отправку файлов cookie вместе с межсайтовыми запросами. Возможные значения:
| LAX | Список |
| Cookie Secure | cookieSecure | Указывает, отправляется ли файл cookie на сервер только с зашифрованным запросом по протоколу HTTPS | False | Логическое значение |
| Handle Write Response Error | handleWriteResponseError | Определяет, следует ли перехватывать любые сбои при записи ответа и сохранять их в памяти для доступа к этим данным в процессе работы интеграционного потока | False | Логическое значение |
| Http Method Restrict | httpMethodRestrict | Список HTTP-методов, разделенных запятыми, например GET, POST. Если методы не указаны, будут доступны все методы | Строка | |
| Match On Uri Prefix | matchOnUriPrefix | Определяет будет ли выполняться поиск ресурса по префиксу URI | False | Логическое значение |
| Mute Exception | muteException | Если эта функция включена, и система не смогла обработать запрос во время обработки данных блоком-инициатором, в теле ответа не будет трассировки стека ошибки | True | Логическое значение |
| Produces | produces | Тип контента, который возвращает ресурс, например application/xml или application/json | Строка | |
| Return Http Request Headers | returnHttpRequestHeaders | Определяет следует ли включать заголовки HTTP-запросов (Accept, User-Agent и т. д.) в HTTP-ответ, формируемый системой | False | Логическое значение |
| Use Cookie Handler | useCookieHandler | Определяет следует ли включить обработчик файлов cookie, который позволяет добавлять файлы cookie, устанавливать время жизни и извлекать их | False | Логическое значение |
| Use Streaming | useStreaming | Определяет следует ли использовать потоковую передачу для больших запросов и ответов | False | Логическое значение |
Расширенные параметры
| Название в UI | Название атрибута | Описание | По умолчанию | Тип данных |
|---|---|---|---|---|
| bridgeErrorHandler | Позволяет связать блок-инициатор с обработчиком ошибок маршрутизации. Это означает, что любые ошибки (если есть), возникающие при попытке потребителя ESB получить входящие сообщения и т.п., теперь будут обрабатываться как сообщения и обрабатываться обработчиком ошибок маршрутизации. Важно: это возможно только в том случае, если сторонний компонент позволяет ESB получать уведомления о возникновении ошибок. Некоторые компоненты обрабатывают их только внутри себя, поэтому использование bridgeErrorHandler невозможно | False | Логическое значение | |
| Exception Handler | exceptionHandler | Предназначен для того, чтобы блок-инициатор мог использовать собственный ExceptionHandler. Обратите внимание: если включена опция bridgeErrorHandler, то эта опция не используется. По умолчанию блок-инициатор будет обрабатывать исключения, которые будут регистрироваться на уровне WARN или ERROR и игнорироваться | Строка | |
| Exchange Pattern | exchangePattern | Устанавливает шаблон обмена во время начала обработки сообщения блоком-инициатором. Возможные значения:
| Список | |
| File Name Ext Whitelist | fileNameExtWhitelist | Список расширений файлов, разделённых запятыми или пробелами. Файлы с такими расширениями будут храниться локально. Нулевое значение или звёздочка (*) разрешают загрузку всех файлов | Строка | |
| Header Filter Strategy | headerFilterStrategy | Предназначен для того, чтобы использовать пользовательскую логику фильтрации заголовков в отправляемых и получаемых сообщениях | Строка | |
| Platform Http Engine | platformHttpEngine | Предназначен для использования HTTP движка для обработки запросов к ресурсу | Строка |