111.4. 组件选项
平台 HTTP 组件支持 5 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| handleWriteResponseError (consumer) | 当 Camel 完成处理消息后,HTTP 服务器正在写入响应。这个选项控制 Camel 在编写响应期间是否应该捕获任何故障,这允许Completion/UnitOfWork 将交换视为失败,并可以访问 HTTP 服务器的原因异常。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| 引擎 (advanced) | 用于服务请求的 HTTP 服务器引擎实施。 | PlatformHttpEngine | |
| headerFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 过滤到 Camel 消息的标头。 | HeaderFilterStrategy |
111.4.1. 端点选项 复制链接链接已复制到粘贴板!
平台 HTTP 端点使用 URI 语法进行配置:
platform-http:path
使用以下路径和查询参数:
111.4.1.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| path (consumer) | 必需 此端点提供 HTTP 请求的路径,用于代理使用 'proxy'。 | 字符串 |
111.4.1.2. 查询参数(21 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| consume (consumer) |
此端点的内容类型接受作为输入,如 application/xml 或 application/json. null 或 | 字符串 | |
| cookieDomain (consumer) | 设置哪些服务器可以接收 Cookie。 | 字符串 | |
| cookieHttpOnly (consumer) | 设置是否阻止客户端侧脚本访问创建的 Cookie。 | false | 布尔值 |
| cookieMaxAge (consumer) | 设置最大 Cookie 期限(以秒为单位)。 | Long | |
| cookiePath (consumer) | 设置请求的 URL 路径必须存在于请求的 URL 中才能发送 Cookie。 | / | 字符串 |
| cookieSameSite (consumer) | 设置是否阻止浏览器与跨站点请求发送 Cookie。Enum 值:
| lax | CookieSameSite |
| cookieSecure (consumer) | 设置 Cookie 是否仅通过 HTTPS 发送到具有加密请求的服务器。 | false | 布尔值 |
| handleWriteResponseError (consumer) | 当 Camel 完成处理消息后,HTTP 服务器正在写入响应。这个选项控制 Camel 在编写响应期间是否应该捕获任何故障,这允许Completion/UnitOfWork 将交换视为失败,并可以访问 HTTP 服务器的原因异常。 | false | 布尔值 |
| httpMethodRestrict (consumer) | 要服务的以逗号分隔的 HTTP 方法列表,如 GET、POST。如果没有指定方法,则会提供所有方法。 | 字符串 | |
| matchOnUriPrefix (consumer) | 如果找不到完全匹配,消费者是否应该尝试通过匹配 URI 前缀来查找目标消费者。 | false | 布尔值 |
| muteException (consumer) | 如果启用并且在消费者端进行交换失败处理,响应的正文不包含异常的堆栈追踪。 | true | 布尔值 |
| generate (consumer) | 此端点生成的内容类型,如 application/xml 或 application/json。 | 字符串 | |
| returnHttpRequestHeaders (consumer) | 是否将 HTTP 请求标头(Accept、User-Agent 等)包含在此端点生成的 HTTP 响应中。 | false | 布尔值 |
| useCookieHandler (consumer) | 是否启用允许 Cookie 添加、到期和检索的 Cookie Handler (目前仅支持 camel-platform-http-vertx)。 | false | 布尔值 |
| useStreaming (consumer) | 是否将流用于大型请求和响应(目前仅支持 camel-platform-http-vertx)。 | false | 布尔值 |
| bridgeErrorHandler (consumer (advanced)) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| fileNameExtWhitelist (consumer (advanced)) | 以逗号分隔的文件扩展列表。上传具有这些扩展将存储在本地。null 值或星号()将允许所有文件。 | 字符串 | |
| headerFilterStrategy (advanced) | 使用自定义 HeaderFilterStrategy 过滤到 Camel 消息的标头。 | HeaderFilterStrategy | |
| platformHttpEngine (advanced) | HTTP 服务器引擎实施,用于服务此端点的请求。 | PlatformHttpEngine |