242.2.2. 查询参数(79 参数)：

bridgeEndpoint (common)

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

false

布尔值

断开连接 （通用）

使用后是否与 Netty Channel 断开连接（关闭）。可用于使用者和制作者。

false

布尔值

keepalive ( common)

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

true

布尔值

重复利用Address （通用）

设置 以便于套接字多路

true

布尔值

reuseChannel （常见）

此选项允许制作者和消费者（在客户端模式中）为处理 Exchange 的生命周期重复使用相同的 Netty Channel。如果您需要多次在 Camel 路由中调用服务器并希望使用相同的网络连接，这将非常有用。使用这个选项时，频道不会返回到连接池，直到交换完成为止；如果断开连接选项被设置为 true，则断开连接。重复使用的频道作为交换属性存储在 Exchange 上，使用键 NettyConstants#NETTY_CHANNEL 获得频道，并可在路由期间获取频道。

false

布尔值

同步 （通用）

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

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

布尔值

Back log （消费者）

允许为 netty consumer （服务器）配置 backlog。请注意，积压是根据操作系统的最佳努力。将此选项设置为 200、500 或 1000 等值，告知 TCP 堆栈在未配置此选项时，接受队列的时长是多久，那么 backlog 依赖于 OS 设置。

int

bossCount (consumer)

当 netty 在 nio 模式下工作时，它会使用 Netty 中的默认 bossCount 参数，即 1。用户可使用此操作覆盖 Netty 中的默认 bossCount

1

int

bossGroup (consumer)

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

EventLoopGroup

chunkedMaxContentLength (consumer)

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

1048576

int

压缩 （消费者）

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

false

布尔值

disconnectOnNoReply (consumer)

如果启用了同步，则此选项将指示 NettyConsumer 是否应该断开连接，如果没有回复发送。

true

布尔值

exceptionHandler （消费者）

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

ExceptionHandler

exchangePattern (consumer)

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

ExchangePattern

httpMethodRestrict (consumer)

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

字符串

映射标头 （消费者）

如果启用了这个选项，则当从 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 （消费者）

使用自定义 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)

等待套接字连接可用。值以毫秒为单位。

10000

int

cookieHandler (producer)

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

CookieHandler

requestTimeout (producer)

在调用远程服务器时，允许使用 Netty producer 的超时。默认情况下，没有使用超时。该值以秒为单位，因此 eg 30000 为 30 秒。requestTimeout 使用 Netty 的 ReadTimeoutHandler 触发超时。

long

throwExceptionOnFailure (producer)

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

true

布尔值

clientInitializerFactory （生产者）

使用自定义 ClientInitializerFactory

ClientInitializer Factory

lazyChannelCreation (producer)

如果在启动 Camel producer 时，如果远程服务器没有启动并运行，则频道可能会延迟以避免异常。

true

布尔值

okStatusCodeRange (producer)

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

200-299

字符串

producerPoolEnabled (producer)

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

true

布尔值

producerPoolMaxActive （生产者）

设置池可分配的对象数量（签出至客户端或闲置等待签出）的上限。对于没有限制，使用负值。

-1

int

producerPoolMaxIdle （生产者）

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

100

int

producerPoolMinEvictable Idle （生产器）

在对象有资格被空闲对象驱除前，设置对象在池中可能处于闲置的时间（值数）。

300000

long

producerPoolMinIdle (producer)

在驱除器线程（如果活动）生成新对象之前，设置制作者池中允许的最少实例数。

int

useRelativePath (producer)

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

false

布尔值

allowSerializedHeaders (advanced)

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

false

布尔值

bootstrapConfiguration （高级）

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

NettyServerBootstrap Configuration

频道组 （高级）

使用显式频道组。

ChannelGroup

配置 （高级）

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

NettyHttpConfiguration

disableStreamCache (advanced)

确定 Netty HttpRequest#getContent （）或 HttpResponset#getContent （）的原始输入流是否已缓存(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_threads x 2。用户可以使用此操作覆盖 Netty 中的默认 workerCount。

int

Worker 组 （高级）

使用显式 EventLoopGroup 作为 boss 线程池。例如，使用多个使用者或制作者共享线程池。默认情况下，每个使用者或制作者都有自己的 worker 池，具有 2 个 x cpu 数核心线程。

EventLoopGroup

已解码器 (codec)

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

ChannelHandler

解码器 (codec)

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

字符串

编码 程序(codec)

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

ChannelHandler

编码代码 (codec)

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

字符串

enabledProtocols （安全）

使用 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 使用者将丰富的 Camel 消息，其中包含有关客户端证书的信息，如主题名称、签发者名称、序列号和有效日期范围。

false

布尔值

sslContextParameters （安全）

使用 SSLContextParameters 配置安全性

SSLContextParameters

sslHandler （安全）

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

SslHandler

trustStoreFile (security)

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

File

trustStoreResource (security)

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

字符串