22.3. 组件选项
HTTP 组件支持 37 选项,如下所示。
Name | 描述 | 默认 | 类型 |
---|---|---|---|
cookieStore (producer) | 要使用自定义 org.apache.http.client.CookieStore。默认情况下,使用 org.apache.http.impl.client.BasicCookieStore,它只是一个 Cookie 存储。请注意,如果 bridgeEndpoint=true,则 Cookie 存储被强制成为 noop cookie 存储,因为 Cookie 不能像我们只是桥接(如作为代理)一样存储。 | CookieStore | |
copyHeaders (producer) | 如果这个选项为 true,则根据复制策略将 IN Exchange 标头复制到 OUT 交换标头中。将其设置为 false,仅允许包含来自 HTTP 响应的标头(不会传播 IN 标头)。 | true | 布尔值 |
lazyStartProducer (producer) | 制作者是否应该启动 lazy(在第一个消息上)。通过启动 lazy,您可以使用它来允许 CamelContext 和路由在启动期间启动,否则在启动期间出现问题,并导致路由启动失败。通过将这个启动延迟到 lazy 后,可以在通过 Camel 的路由错误处理程序路由消息期间处理启动失败。注意在处理第一个消息时,创建并启动制作者可能花费较少的时间,从而延长处理的总处理时间。 | false | 布尔值 |
responsePayloadStreamingThreshold (producer) | 这个阈值(以字节为单位)控制响应有效负载是否应以字节阵列形式存储在内存中,还是基于流传输。把它设置为 -1 始终使用 streaming 模式。 | 8192 | int |
skipRequestHeaders (producer (advanced)) | 是否跳过将所有 Camel 标头映射到 HTTP 请求标头。如果 HTTP 请求中不需要包含 Camel 标头的数据,则这可以避免为 JVM 垃圾回收器解析多个对象分配开销。 | false | 布尔值 |
skipResponseHeaders (producer (advanced)) | 是否跳过将所有 HTTP 响应标头映射到 Camel 标头。如果 HTTP 标头不需要数据,这可以避免为 JVM 垃圾收集器解析多个对象分配的开销。 | false | 布尔值 |
allowJavaSerializedObject (advanced) | 当请求使用 context-type=application/x-java-serialized-object 时,是否允许 java 序列化。默认为关闭。如果您启用此功能,则 Java 会将传入数据从请求反序列化到 Java,这可能会成为潜在的安全风险。 | false | 布尔值 |
authCachingDisabled (advanced) | 禁用验证方案缓存。 | false | 布尔值 |
automaticRetriesDisabled (advanced) | 禁用自动请求恢复并重新执行。 | false | 布尔值 |
autowiredEnabled (advanced) | 是否启用自动。这用于自动自动自动选项(选项必须标记为 autowired),方法是在 registry 中查找是否有匹配的类型实例,然后在组件上进行配置。这可用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
clientConnectionManager (advanced) | 使用自定义和共享的 HttpClientConnectionManager 管理连接。如果已经进行了配置,则此选项将始终用于此组件创建的所有端点。 | HttpClientConnectionManager | |
connectionsPerRoute (advanced) | 每个路由的连接数上限。 | 20 | int |
connectionStateDisabled (advanced) | 禁用连接状态跟踪。 | false | 布尔值 |
connectionTimeToLive (advanced) | 连接到 live 的时间,时间单位是 millisecond,默认值始终保持 active。 | long | |
contentCompressionDisabled (advanced) | 禁用自动内容解压缩。 | false | 布尔值 |
cookieManagementDisabled (advanced) | 禁用状态(cookie)管理。 | false | 布尔值 |
defaultUserAgentDisabled (advanced) | 如果用户未提供,则禁用此构建器设置的默认用户代理。 | false | 布尔值 |
httpBinding (advanced) | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 间的映射。 | HttpBinding | |
httpClientConfigurer (advanced) | 要使用自定义 HttpClientConfigurer 来执行要使用的 HttpClientClient 的配置。 | HttpClientConfigurer | |
httpConfiguration (advanced) | 使用 shared HttpConfiguration 作为基础配置。 | HttpConfiguration | |
httpContext (advanced) | 在执行请求时使用自定义 org.apache.http.protocol.HttpContext。 | HttpContext | |
maxTotalConnections (advanced) | 连接的最大数量。 | 200 | int |
redirectHandlingDisabled (advanced) | 禁用自动重定向处理。 | false | 布尔值 |
headerFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 过滤到 Camel 消息的标头。 | HeaderFilterStrategy | |
proxyAuthDomain (proxy) | 要使用的代理身份验证域。 | 字符串 | |
proxyAuthHost (proxy) | 代理身份验证主机。 | 字符串 | |
proxyAuthMethod (proxy) | 要使用的代理验证方法。 枚举值:
| 字符串 | |
proxyAuthNtHost (proxy) | 用于 NTML 的代理身份验证域(workstation 名称)。 | 字符串 | |
proxyAuthPassword (proxy) | 代理身份验证密码。 | 字符串 | |
proxyAuthPort (proxy) | 代理身份验证端口。 | 整数 | |
proxyAuthUsername (proxy) | 代理身份验证用户名。 | 字符串 | |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性。重要: 每个 HttpComponent 支持只有 org.apache.camel.support.jsse.SSLContextParameters 的一个实例。如果需要使用 2 个或更多不同的实例,您需要为每个实例定义一个新的 HttpComponent。 | SSLContextParameters | |
useGlobalSslContextParameters (security) | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
x509HostnameVerifier (security) | 使用自定义 X509HostnameVerifier,如 DefaultHostnameVerifier 或 NoopHostnameVerifier。 | HostnameVerifier | |
connectionRequestTimeout (timeout) | 从连接管理器请求连接时使用的超时(毫秒)。超时值为零将解释为无限超时。超时值为零将解释为无限超时。负值代表为未定义(系统默认值)。 | -1 | int |
connectTimeout (timeout) | 确定建立连接前的超时(以毫秒为单位)。超时值为零将解释为无限超时。超时值为零将解释为无限超时。负值代表为未定义(系统默认值)。 | -1 | int |
socketTimeout (timeout) | 定义套接字超时(以毫秒为单位),这是等待数据的超时时间,或者不同,在两个连续数据包之间不活跃的最大周期。超时值为零将解释为无限超时。负值代表为未定义(系统默认值)。 | -1 | int |