241.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 | 布尔值 |
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: 前缀来从不同的系统加载资源。 | 字符串 |