23.4. 端点选项

httpUri (common)

需要 调用的 HTTP 端点的 url。

URI

chunked (producer)

如果此选项为 false，则 Servlet 将禁用 HTTP 流，并为响应设置 content-length 标头。

true

布尔值

disableStreamCache (common)

确定是否缓存来自 Servlet 的原始输入流(Camel 将流读取到内存/覆盖流到文件，流缓存)缓存。默认情况下，Camel 将缓存 Servlet 输入流，以支持多次读取它，以确保 Camel 可以从流检索所有数据。但是，当您需要访问原始流时，您可以将这个选项设置为 true，例如将其直接流传输到文件或其他持久性存储。DefaultHttpBinding 会将请求输入流复制到流缓存中，如果此选项为 false，则将其放入消息正文中，以便支持多次读取流。如果您使用 Servlet 来桥接/代理端点，请考虑启用此选项来提高性能，以防不需要多次读取消息有效负载。http 制作者将默认缓存响应正文流。如果将此选项设置为 true，则制作者不会缓存响应正文流，而是将响应流用作消息正文。

false

布尔值

headerFilterStrategy (common)

使用自定义 HeaderFilterStrategy 过滤标题到 Camel 消息或从 Camel 消息过滤。

HeaderFilterStrategy

httpBinding （通用（高级）

使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。

HttpBinding

bridgeEndpoint (producer)

如果选项为 true，HttpProducer 将忽略 Exchange.HTTP_URI 标头，并将端点的 URI 用于请求。您还可以将选项 throwExceptionOnFailure 设置为 false，使 HttpProducer 发送所有错误响应。

false

布尔值

clearExpiredCookies (producer)

在发送 HTTP 请求前是否清除过期的 Cookie。这样可确保 Cookie 存储不会通过添加新的 Cookie （在它们过期时被删除）来保持增长。如果组件禁用了 Cookie 管理，这个选项也会禁用。

true

布尔值

connectionClose (producer)

指定是否必须在 HTTP 请求中添加 Connection Close 标头。默认情况下，connectionClose 为 false。

false

布尔值

CopyHeaders (producer)

如果这个选项为 true，则 IN Exchange 标头将根据复制策略复制到 OUT Exchange 标头。把它设置为 false，仅允许仅包含 HTTP 响应中的标头（不传播 IN 标头）。

true

布尔值

customHostHeader (producer)

将自定义主机标头用于制作者。如果没有在查询中设置，将忽略。当设置时，将覆盖从 url 派生的主机标头。

字符串

httpMethod (producer)

配置要使用的 HTTP 方法。如果设置，HttpMethod 标头无法覆盖这个选项。

Enum 值：

HttpMethods

ignoreResponseBody (producer)

如果此选项为 true，http 制作者不会读取响应正文并缓存输入流。

false

布尔值

lazyStartProducer (producer)

生成者是否应懒惰启动 （在第一个消息中）。通过懒惰启动，您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动，并导致路由启动失败。通过懒惰启动，启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意，在处理第一个消息时，创建并启动生成者可能需要稍等时间，并延长处理的总处理时间。

false

布尔值

preserveHostHeader (producer)

如果选项为 true，HttpProducer 会将 Host 标头设置为当前交换主机标头中包含的值，这可用于反向代理应用程序，其中您希望下游服务器收到的 Host 标头反映上游客户端调用的 URL，这允许使用 Host 标头为代理服务生成准确的 URL。

false

布尔值

throwExceptionOnFailure (producer)

在远程服务器失败时，禁用抛出 HttpOperationFailedException 的选项。无论 HTTP 状态代码是什么，都允许您获取所有响应。

true

布尔值

transferException (producer)

如果对消费者端启用和交换失败处理，如果导致 Exception 在响应中发送回序列化，作为 application/x-java-serialized-object 内容类型。在制作者一端，异常将被反序列化并按原样丢弃，而不是 HttpOperationFailedException。原因例外是需要序列化的。默认情况下是关闭的。如果您启用它，Java 将把请求中的传入数据反序列化到 Java，这可能会带来潜在的安全风险。

false

布尔值

cookieHandler （生成者（高级）

配置 Cookie 处理程序，以维护 HTTP 会话。

CookieHandler

cookieStore (producer (advanced))

使用自定义 CookieStore。默认情况下，使用 BasicCookieStore，它是一个只内存的 Cookie 存储。请注意，如果 bridgeEndpoint=true，则 Cookie 存储被强制为 noop cookie 存储，因为 Cookie 不能像我们刚刚桥接一样存储（例如作为代理）。如果设置了 cookieHandler，则 Cookie 存储也被迫成为 noop cookie 存储，因为 cookieHandler 执行 Cookie 处理。

CookieStore

deleteWithBody (producer (advanced))

HTTP DELETE 是否应包含邮件正文。默认情况下，HTTP DELETE 不包含任何 HTTP 正文。但是，在一些罕见的情形中，用户可能需要包含邮件正文。

false

布尔值

getWithBody (producer (advanced))

HTTP GET 是否应该包含邮件正文。默认情况下，HTTP GET 不包含任何 HTTP 正文。但是，在一些罕见的情形中，用户可能需要包含邮件正文。

false

布尔值

okStatusCodeRange (producer (advanced))

被视为成功响应的状态代码。值为 inclusive。可以定义多个范围，用逗号分开，例如 200-204,209,301-304。每个范围都必须是一个数字，或使用包含短划线的 from-to。

200-299

字符串

skipRequestHeaders (producer (advanced))

是否跳过将所有 Camel 标头映射为 HTTP 请求标头。如果需要包含来自 Camel 标头的数据，则这可以避免为 JVM 垃圾收集器解析带有许多对象分配的开销。

false

布尔值

skipResponseHeaders (producer (advanced))

是否跳过将所有 HTTP 响应标头映射到 Camel 标头。如果 HTTP 标头不需要数据，这可以避免为 JVM 垃圾收集器使用多个对象分配解析开销。

false

布尔值

userAgent (producer (advanced))

要设置自定义 HTTP User-Agent 请求标头。

字符串

ClientBuilder （高级）

提供对此端点生产者或使用者使用的新 RequestConfig 实例使用的 http 客户端请求参数的访问权限。

HttpClientBuilder

clientConnectionManager （高级）

使用自定义 HttpClientConnectionManager 来管理连接。

HttpClientConnectionManager

connectionsPerRoute （高级）

每个路由的最大连接数。

20

int

httpclient ( 高级)

设置供制作者使用的自定义 HttpClient。

HttpClient

httpClientConfigurer (advanced)

为由生产者或消费者创建的新 HttpClient 实例注册自定义配置策略，如 配置身份验证机制等。

HttpClientConfigurer

httpClientOptions （高级）

使用 map 中的键/值来配置 HttpClient。

Map

httpContext （高级）

使用自定义 HttpContext 实例。

HttpContext

maxTotalConnections （高级）

连接的最大数量。

200

int

useSystemProperties （高级）

将系统属性用作配置的回退。

false

布尔值

proxyAuthDomain (proxy)

与 NTML 搭配使用的代理身份验证域。

字符串

proxyAuthHost (proxy)

代理身份验证主机。

字符串

proxyAuthMethod (proxy)

要使用的代理身份验证方法。

Enum 值：

字符串

proxyAuthNtHost (proxy)

与 NTML 搭配使用的代理身份验证域(workstation 名称)。

字符串

proxyAuthPassword (proxy)

代理身份验证密码。

字符串

proxyAuthPort (proxy)

代理身份验证端口。

int

proxyAuthScheme (proxy)

要使用的代理身份验证方案。

Enum 值：

字符串

proxyAuthUsername (proxy)

代理身份验证用户名。

字符串

proxyHost (proxy)

要使用的代理主机名。

字符串

proxyPort (proxy)

要使用的代理端口。

int

authDomain (security)

与 NTML 搭配使用的身份验证域。

字符串

authenticationPreemptive (security)

如果这个选项为 true，则 camel-http 会将抢占基本身份验证发送到服务器。

false

布尔值

authHost (security)

与 NTML 搭配使用的身份验证主机。

字符串

authmethod （安全）

可以使用身份验证方法作为以逗号分隔的值 Basic、Digest 或 NTLM 列表。

字符串

authMethodPriority (security)

优先选择使用哪种身份验证方法，可以是 Basic、Digest 或 NTLM。

Enum 值：

字符串

authPassword (security)

身份验证密码。

字符串

authUsername (security)

身份验证用户名.

字符串

sslContextParameters (security)

使用 SSLContextParameters 配置安全性。重要： 每个 HttpComponent 仅支持 org.apache.camel.util.jsse.SSLContextParameters 的一个实例。如果您需要使用 2 个或更多不同的实例，您需要为每个实例定义一个新的 HttpComponent。

SSLContextParameters

x509HostnameVerifier (security)

使用自定义 X509HostnameVerifier，如 DefaultHostnameVerifier 或 NoopHostnameVerifier。

HostnameVerifier