111.4. 组件选项


平台 HTTP 组件支持 5 个选项,如下所列。

Expand
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 参数)

Expand
Name描述默认值类型

path (consumer)

必需 此端点提供 HTTP 请求的路径,用于代理使用 'proxy'。

 

字符串

111.4.1.2. 查询参数(21 参数)

Expand
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 值:

  • STRICT
  • LAX
  • NONE

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 值:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

fileNameExtWhitelist (consumer (advanced))

以逗号分隔的文件扩展列表。上传具有这些扩展将存储在本地。null 值或星号()将允许所有文件。

 

字符串

headerFilterStrategy (advanced)

使用自定义 HeaderFilterStrategy 过滤到 Camel 消息的标头。

 

HeaderFilterStrategy

platformHttpEngine (advanced)

HTTP 服务器引擎实施,用于服务此端点的请求。

 

PlatformHttpEngine

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部