241.2.2. 查询参数(79 参数):


Expand
名称描述默认类型

bridgeEndpoint (common)

如果 选项为 true,则制作者将忽略 Exchange.HTTP_URI 标头,并使用端点的 URI 进行请求。您也可以将 throwExceptionOnFailure 设置为 false,以便制作者将所有故障响应发送回送。在网桥模式中工作的使用者将跳过 gzip 压缩和 WWW URL 表单编码(通过添加 Exchange.SKIP_GZIP_ENCODING 和 Exchange.SKIP_WWW_FORM_URLENCODED 标头到被使用的交换)。

false

布尔值

disconnect (common)

使用后是否立即断开(关闭)与 Netty Channel 的连接。可用于使用者和制作者。

false

布尔值

keepAlive (common)

设置 以确保因为不活跃而关闭套接字

true

布尔值

reuseAddress (common)

设置 以便于套接字多路

true

布尔值

reuseChannel (common)

此选项允许制作者和消费者(在客户端模式中)在处理 Exchange 的生命周期中重复使用相同的 Netty Channel。如果您需要在 Camel 路由中多次调用服务器,并且想要使用相同的网络连接,这很有用。当使用这个频道时,在交换完成前,不会返回到连接池;如果断开连接选项被设置为 true,则断开连接。重复使用的频道作为交换属性存储在 Exchange 上,使用密钥链路 NettyConstantsNETTY_CHANNEL,允许您在路由期间获取频道并使用它。

false

布尔值

sync (common)

设置 将端点设置为单向或请求响应

true

布尔值

tcpNoDelay (common)

设置 来提高 TCP 协议性能

true

布尔值

bridgeErrorHandler (consumer)

允许将消费者桥接到 Camel 路由 Error Handler,这意味着使用者试图获取传入消息或类似信息时出现任何异常,现在将作为一个消息进行处理,并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.Exception 处理程序处理异常,该处理程序将记录在 WARN 或 ERROR 级别,并忽略。

false

布尔值

matchOnUriPrefix (consumer)

如果找不到任何匹配项,Camel 应该尝试通过匹配 URI 前缀来查找目标使用者。

false

布尔值

send503whenSuspended (consumer)

是否要在消费者被暂停时回发送 HTTP 状态代码 503。如果 选项为 false,则当使用者暂停时 Netty Acceptor 被 unbound,以便客户端无法再连接。

true

布尔值

backlog (consumer)

允许为 netty 消费者(server)配置积压。请注意,积压只是取决于操作系统的最佳工作。将此选项设置为 200、500 或 1000 之类的值,告知 TCP 堆栈在未配置此选项时接受队列的时长,如果不配置这个选项,则后端日志依赖于 OS 设置。

 

int

bossCount (consumer)

当 netty 在 nio 模式上工作时,它使用 Netty 中的默认 位于Count 参数,即 1。用户可使用此操作覆盖 Netty 中的默认 bossCount

1

int

bossGroup (consumer)

设置 BossGroup,该组可用于处理 NettyEndpoint 中服务器端的新连接

 

EventLoopGroup

chunkedMaxContentLength (consumer)

该值以字节为单位,以字节在 Netty HTTP 服务器上接收的每个块帧的最大内容长度。

1048576

int

compression (consumer)

如果客户端支持来自 HTTP 标头的,则允许使用 gzip/defdef 进行 Netty HTTP 服务器上的压缩。

false

布尔值

disconnectOnNoReply (consumer)

如果启用了同步,则此选项将指定 NettyConsumer,如果它应该断开连接,没有回复回复。

true

布尔值

exceptionHandler (consumer)

要让使用者使用自定义 ExceptionHandler。请注意,如果启用了选项 bridgeErrorHandler,则不使用这个选项。默认情况下,消费者处理异常,这将在 WARN 或 ERROR 级别记录,并忽略。

 

ExceptionHandler

exchangePattern (consumer)

在使用者创建交换时设置交换模式。

 

ExchangePattern

httpMethodRestrict (consumer)

要禁用 Netty HTTP consumer 上的 HTTP 方法。您可以用逗号分隔多个。

 

字符串

mapHeaders (consumer)

如果启用了这个选项,则当从 Netty 绑定到 Camel 消息时,将映射标头(如作为标头添加到 Camel 消息)。您可以关闭这个选项来禁用这个选项。该标头仍然可以从 org.apache.camel.component.netty.http.NettyHttpMessage 消息访问,方法为 Netty HTTP 请求 io.netty.handler.codec.http.HttpRequest 实例。

true

布尔值

maxHeaderSize (consumer)

所有标头的最大长度。如果每个标头的长度的总和超过这个值,则将引发 io.netty.handler.codec.TooLongFrameException。

8192

int

nettyServerBootstrapFactory (consumer)

使用自定义 NettyServerBootstrapFactory

 

NettyServerBootstrap Factory

nettySharedHttpServer (consumer)

使用共享的 Netty HTTP 服务器。如需了解更多详细信息,请参阅 Netty HTTP Server 示例。

 

NettySharedHttpServer

noReplyLogLevel (consumer)

如果启用了同步,则此选项指定在日志记录没有回复时要使用的 NettyConsumer。

WARN

LoggingLevel

serverClosedChannel ExceptionCaughtLogLevel (consumer)

如果服务器(NettyConsumer)捕获 java.nio.channels.ClosedChannelException,则使用这个日志记录级别登录。这用于避免记录关闭频道例外,因为客户端可以断开,然后在 Netty 服务器中造成意外的异常。

DEBUG

LoggingLevel

serverExceptionCaughtLog Level (consumer)

如果服务器(NettyConsumer)捕获异常,则使用此日志记录级别记录。

WARN

LoggingLevel

serverInitializerFactory (consumer)

使用自定义 ServerInitializerFactory

 

ServerInitializer Factory

traceEnabled (consumer)

指定是否为这个 Netty HTTP 用户启用 HTTP TRACE。默认关闭 TRACE。

false

布尔值

urlDecodeHeaders (consumer)

如果启用了这个选项,则当从 Netty 绑定到 Camel Message 时,标头值将被 URL 解码(例如 %20)是空格字符。请注意,默认的 org.apache.camel.component.netty.http.NettyHttpBinding 使用这个选项,因此如果实施了自定义 org.apache.camel.component.netty4.http.NettyHttpBinding,因此您需要相应地对标头进行解码。

false

布尔值

usingExecutorService (consumer)

是否使用排序的线程池,确保事件在同一频道中按顺序处理。

true

布尔值

connectTimeout (producer)

等待套接字连接可用的时间。值为 millis。

10000

int

cookieHandler (producer)

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

 

CookieHandler

requestTimeout (producer)

允许在调用远程服务器时为 Netty producer 使用超时。默认情况下,不使用超时。该值在 milli 秒内,因此 eg 30000 为 30 秒。requestTimeout 使用 Netty 的 ReadTimeoutHandler 触发超时。

 

long

throwExceptionOnFailure (producer)

禁用丢弃 HttpOperationFailedException 的选项(如果来自远程服务器的响应失败)。这可让您获得所有响应,无论 HTTP 状态代码如何。

true

布尔值

clientInitializerFactory (producer)

使用自定义 ClientInitializerFactory

 

ClientInitializer Factory

lazyChannelCreation (producer)

如果远程服务器在 Camel 制作者启动时未启动并运行,可以先创建频道来避免异常。

true

布尔值

okStatusCodeRange (producer)

被视为成功响应的状态代码。值包括:可以定义多个范围,以逗号分隔,例如 200-204,209,301-304。每个范围必须是单个数字,或使用包括横线的短划线。默认范围为 200-299

200-299

字符串

producerPoolEnabled (producer)

制作者池是否启用。重要信息:如果您关闭此关闭,那么将使用一个共享连接用于制作者(如果您正在执行请求/回复)。这意味着,如果回复返回异常,则存在交集响应的问题。因此,您需要在请求和回复消息中有一个关联 id,以便您可以正确地将回复与负责在 Camel 中处理消息的 Camel 回调相关联。要这样做,您需要将 NettyCamelStateCorrelationManager 作为关联管理器实施,并通过 correlationManager 选项进行配置。如需了解更多详细信息,请参阅 correlationManager 选项。

true

布尔值

producerPoolMaxActive (producer)

设置可由池分配的对象数量(签出到客户端,或者在给定时间闲置等待签出)。在没有限制的情况下使用负值。

-1

int

producerPoolMaxIdle (producer)

设置池中空闲实例的数量。

100

int

producerPoolMinEvictable Idle (producer)

在对象满足闲置对象驱除前,对象可能会处于空闲时间(millis)的最少时间(以 millis)设置。

300000

long

producerPoolMinIdle (producer)

在驱除器线程(如果活跃)生成新对象前,设置制作池中允许的实例的最小数量。

 

int

useRelativePath (producer)

设置是否在 HTTP 请求中使用相对路径。

false

布尔值

allowSerializedHeaders (advanced)

仅在 transferExchange 为 true 时使用 TCP。当设置为 true 时,标头和属性中的 serializable 对象将添加到交换中。否则,Camel 将排除任何非序列化对象,并将其记录在 WARN 级别。

false

布尔值

bootstrapConfiguration (advanced)

要使用自定义配置的 NettyServerBootstrapConfiguration 来配置这个端点。

 

NettyServerBootstrap Configuration

channelGroup (advanced)

使用显式 ChannelGroup。

 

ChannelGroup

配置 (高级)

使用自定义配置的 NettyHttpConfiguration 来配置此端点。

 

NettyHttpConfiguration

disableStreamCache (advanced)

确定 Netty HttpRequestgetContent ()或 HttpResponsetgetContent ()的原始输入流是否已被缓存(Camel 将把流读取到基于轻量级内存的流缓存)中。默认情况下,Camel 将缓存 Netty 输入流,以支持多次读取,以确保 Camel 可以从流检索所有数据。但是,当您需要访问原始流(如直接流传输到文件或其他持久性存储)时,您可以将这个选项设置为 true。请记住,如果启用这个选项,则不能多次读取 Netty 流,而且您需要手动在 Netty 原始流中重置 reader 索引。另外,当 Netty HTTP 服务器/HTTP 客户端处理时,Netty 将自动关闭 Netty 流,这意味着如果异步路由引擎正在使用,则可能会继续路由 org.apache.camel.Exchange 无法读取 Netty 流,因为 Netty 已关闭它。

false

布尔值

headerFilterStrategy (advanced)

使用自定义 org.apache.camel.spi.HeaderFilterStrategy 过滤标头。

 

HeaderFilterStrategy

nativeTransport (advanced)

是否使用原生传输,而不是 NIO。原生传输利用主机操作系统,且仅在某些平台上受支持。需要为您要使用的主机操作系统添加 netty JAR。更多信息请参阅 :http://netty.io/wiki/native-transports.html

false

布尔值

nettyHttpBinding (advanced)

使用自定义 org.apache.camel.component.netty4.http.NettyHttpBinding 绑定到/从 Netty 和 Camel Message API 绑定。

 

NettyHttpBinding

选项 (高级)

允许使用 选项作为前缀来配置额外的 netty 选项。例如,option.child.keepAlive=false,以设置 netty 选项 child.keepAlive=false。有关可以使用的可能选项,请参阅 Netty 文档。

 

map

receiveBufferSize (advanced)

要在入站通信中使用的 TCP/UDP 缓冲大小。大小为字节。

65536

int

receiveBufferSizePredictor (advanced)

配置缓冲区大小预测器。请参阅 Jetty 文档和这个邮件线程的详细信息。

 

int

sendBufferSize (advanced)

在出站通信期间使用的 TCP/UDP 缓冲大小。大小为字节。

65536

int

同步 (高级)

设置同步处理是否应当严格使用,还是允许 Camel 使用异步处理(如果受支持)。

false

布尔值

transferException (高级)

如果对使用者端启用和交换失败处理,并且如果导致的例外在响应中作为应用程序/x-java-serialized-object 内容类型发送回序列化,则进行后定。在制作者端,异常会按原样进行反序列化和丢弃,而不是 HttpOperationFailedException。导致的异常需要被序列化。默认情况下关闭。如果您启用此功能,Java 将把传入的数据从请求中反序列化为 Java,这可能会成为潜在的安全风险。

false

布尔值

transferExchange (advanced)

仅用于 TCP。您可以通过线路来传输交换,而不是只是正文。以下字段会被传输:在正文、传出正文、错误正文、标题、错误标头、交换属性、交换异常。这要求对象是序列化的。Camel 将排除任何非序列化对象,并在 WARN 级别记录它。

false

布尔值

workerCount (advanced)

当 netty 在 nio 模式下工作时,它会使用来自 Netty 的默认 workerCount 参数,即 cpu_core_threads2。用户可使用此操作覆盖 Netty 中的默认 workerCount

 

int

workerGroup (advanced)

使用显式 EventLoopGroup 作为 scanner 线程池。例如,若要与多个使用者或制作者共享一个线程池。默认情况下,每个消费者或制作者都有自己的 worker 池,有 2 个 CPU 数量核心线程。

 

EventLoopGroup

decoder (codec)

弃用 使用单个解码器。这个选项已弃用,使用 encoders 替代。

 

ChannelHandler

decoders (codec)

要使用的解码器列表。您可以使用带有用逗号分开的值的 String,并在 Registry 中查找值。只需记得使用 为值加上前缀,因此 Camel 知道它应该查找。

 

字符串

encoder (codec)

弃用 使用单个编码程序。这个选项已弃用,使用 encoders 替代。

 

ChannelHandler

encoders (codec)

要使用的编码器列表。您可以使用带有用逗号分开的值的 String,并在 Registry 中查找值。只需记得使用 为值加上前缀,因此 Camel 知道它应该查找。

 

字符串

enabledProtocols (security)

使用 SSL 时要启用哪些协议

TLSv1,TLSv1.1,TLSv1.2

字符串

keyStoreFile (security)

用于加密的客户端证书密钥存储

 

File

keyStoreFormat (security)

用于有效负载加密的密钥存储格式。如果没有设置,则默认为 JKS

 

字符串

keyStoreResource (security)

用于加密的客户端侧证书密钥存储。从 classpath 中默认加载,但您可以使用 classpath:、file: 或 http: 前缀来从不同的系统加载资源。

 

字符串

needClientAuth (security)

配置服务器在使用 SSL 时是否需要客户端身份验证。

false

布尔值

密语 (安全性)

要使用的密码设置,用于加密/解密使用 SSH 发送的有效负载

 

字符串

securityConfiguration (security)

指的是 org.apache.camel.component.netty4.http.NettyHttpSecurityConfiguration,以配置安全 Web 资源。

 

NettyHttpSecurity Configuration

securityOptions (security)

使用映射中的键/值对配置 NettyHttpSecurityConfiguration

 

map

securityProvider (security)

用于有效负载加密的安全供应商。如果没有设置,则默认为 SunX509。

 

字符串

SSL (安全性)

设置以指定是否将 SSL 加密应用到此端点

false

布尔值

sslClientCertHeaders (security)

在 SSL 模式中启用和启用后,Netty consumer 将增强 Camel 消息以及包含客户端证书信息(如主题名称、签发者名称、序列号和有效日期范围)的信息。

false

布尔值

sslContextParameters (security)

使用 SSLContextParameters 配置安全性

 

SSLContextParameters

sslHandler (security)

对可用于返回 SSL 处理程序的类的引用

 

SslHandler

trustStoreFile (security)

用于加密的服务器端证书密钥存储

 

File

trustStoreResource (security)

用于加密的服务器端证书密钥存储。从 classpath 中默认加载,但您可以使用 classpath:、file: 或 http: 前缀来从不同的系统加载资源。

 

字符串

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat