241.3. Spring Boot Auto-Configuration

组件支持 78 个选项,它们如下所列。

名称描述默认类型

camel.component.netty4.configuration.allow-default-codec

如果既是,netty 组件都会安装一个默认的 codec,则 encoder/decoder 是 null,文本行是 false。将 allowDefaultCodec 设置为 false 可防止 netty 组件作为过滤器链中的第一个元素安装默认 codec。

true

布尔值

camel.component.netty4.configuration.allow-serialized-headers

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

false

布尔值

camel.component.netty4.configuration.auto-append-delimiter

在使用文本 codec 发送时,是否自动附加缺少的最终分隔符。

true

布尔值

camel.component.netty4.configuration.backlog

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

 

整数

camel.component.netty4.configuration.boss-count

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

1

整数

camel.component.netty4.configuration.boss-group

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

 

EventLoopGroup

camel.component.netty4.configuration.broadcast

设置以通过 UDP 选择多播

false

布尔值

camel.component.netty4.configuration.channel-group

使用显式 ChannelGroup。

 

ChannelGroup

camel.component.netty4.configuration.client-initializer-factory

使用自定义 ClientInitializerFactory

 

ClientInitializer Factory

camel.component.netty4.configuration.client-mode

如果 clientMode 为 true,netty 消费者将地址连接为 TCP 客户端。

false

布尔值

camel.component.netty4.configuration.connect-timeout

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

10000

整数

camel.component.netty4.configuration.correlation-manager

要使用自定义关联管理器来管理请求和回复消息的方式,在将请求/回复消息与 netty producer 搭配使用时进行映射。只有在您有方法将请求与回复请求(如请求和回复消息中都存在关联 id 时)进行使用。如果您希望在 netty 在同一频道(也称为连接)上的多个并发信息上,可以使用这个信息。当这样做时,您必须有关联请求和回复消息的方法,以便您可以在航班的 Camel Exchange 上存储正确的回复,然后再继续路由。我们建议在构建自定义关联管理器时扩展 TimeoutCorrelationManagerSupport。这为需要实施的超时和其他复杂性提供支持。如需了解更多详细信息,请参阅 producerPoolEnabled 选项。

 

NettyCamelState CorrelationManager

camel.component.netty4.configuration.decoder-max-line-length

用于文本行代码的最大行长度。

1024

整数

camel.component.netty4.configuration.decoders

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

 

list

camel.component.netty4.configuration.delimiter

用于文本行代码的分隔符。可能的值有 LINE 和 NULL。

 

TextLineDelimiter

camel.component.netty4.configuration.disconnect

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

false

布尔值

camel.component.netty4.configuration.disconnect-on-no-reply

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

true

布尔值

camel.component.netty4.configuration.enabled-protocols

使用 SSL 时要启用哪些协议

TLSv1,TLSv1.1,TLSv1.2

字符串

camel.component.netty4.configuration.encoders

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

 

list

camel.component.netty4.configuration.encoding

用于文本代码的编码(一个 charset 名称)。如果没有提供,Camel 将使用 JVM 默认 Charset。

 

字符串

camel.component.netty4.configuration.host

主机名.对于消费者,主机名为 localhost 或 0.0.0.0。对于制作者,主机名是要连接的远程主机

 

字符串

camel.component.netty4.configuration.keep-alive

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

true

布尔值

camel.component.netty4.configuration.key-store-format

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

 

字符串

camel.component.netty4.configuration.key-store-resource

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

 

字符串

camel.component.netty4.configuration.lazy-channel-creation

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

true

布尔值

camel.component.netty4.configuration.native-transport

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

false

布尔值

camel.component.netty4.configuration.need-client-auth

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

false

布尔值

camel.component.netty4.configuration.netty-server-bootstrap-factory

使用自定义 NettyServerBootstrapFactory

 

NettyServerBootstrap Factory

camel.component.netty4.configuration.network-interface

在使用 UDP 时,此选项可根据其名称指定网络接口,如 eth0 来加入多播组。

 

字符串

camel.component.netty4.configuration.no-reply-log-level

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

 

LoggingLevel

camel.component.netty4.configuration.options

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

 

map

camel.component.netty4.configuration.passphrase

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

 

字符串

camel.component.netty4.configuration.port

主机端口号

 

整数

camel.component.netty4.configuration.producer-pool-enabled

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

true

布尔值

camel.component.netty4.configuration.producer-pool-max-active

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

-1

整数

camel.component.netty4.configuration.producer-pool-max-idle

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

100

整数

camel.component.netty4.configuration.producer-pool-min-evictable-idle

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

300000

Long

camel.component.netty4.configuration.producer-pool-min-idle

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

 

整数

camel.component.netty4.configuration.protocol

要使用的协议,可以是 tcp 或 udp。

 

字符串

camel.component.netty4.configuration.receive-buffer-size

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

65536

整数

camel.component.netty4.configuration.receive-buffer-size-predictor

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

 

整数

camel.component.netty4.configuration.reconnect

仅在使用者中使用,如果启用了此操作,使用者将尝试重新连接。

true

布尔值

camel.component.netty4.configuration.reconnect-interval

如果重新连接,并且启用了 clientMode。尝试重新连接的时间间隔(以秒为单位)

10000

整数

camel.component.netty4.configuration.request-timeout

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

 

Long

camel.component.netty4.configuration.reuse-address

设置 以便于套接字多路

true

布尔值

camel.component.netty4.configuration.reuse-channel

此选项允许制作者和消费者(在客户端模式中)在处理 Exchange 的生命周期中重复使用相同的 Netty Channel。如果您需要在 Camel 路由中多次调用服务器,并且想要使用相同的网络连接,这很有用。当使用此功能时,在 Exchange 完成后,频道不会返回到连接池,如果断开连接选项被设置为 true,则频道不会返回到连接池。重复使用的频道作为带有键 NettyConstants#NETTY_CHANNEL 的交换属性存储在 Exchange 中,也可以在路由过程中获取频道并使用它来使用它。

false

布尔值

camel.component.netty4.configuration.security-provider

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

 

字符串

camel.component.netty4.configuration.send-buffer-size

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

65536

整数

camel.component.netty4.configuration.server-closed-channel-exception-caught-log-level

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

 

LoggingLevel

camel.component.netty4.configuration.server-exception-caught-log-level

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

 

LoggingLevel

camel.component.netty4.configuration.server-initializer-factory

使用自定义 ServerInitializerFactory

 

ServerInitializer Factory

camel.component.netty4.configuration.ssl

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

false

布尔值

camel.component.netty4.configuration.ssl-client-cert-headers

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

false

布尔值

camel.component.netty4.configuration.ssl-context-parameters

使用 SSLContextParameters 配置安全性

 

SSLContextParameters

camel.component.netty4.configuration.ssl-handler

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

 

SslHandler

camel.component.netty4.configuration.sync

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

true

布尔值

camel.component.netty4.configuration.tcp-no-delay

设置 来提高 TCP 协议性能

true

布尔值

camel.component.netty4.configuration.textline

仅用于 TCP。如果没有指定 codec,您可以使用此标志来指示基于文本的 codec;如果未指定或值为 false,则通过 TCP 假定 Object Serialization。

false

布尔值

camel.component.netty4.configuration.transfer-exchange

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

false

布尔值

camel.component.netty4.configuration.trust-store-resource

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

 

字符串

camel.component.netty4.configuration.udp-byte-array-codec

仅限 UDP。如果启用使用字节阵列代码而不是 Java 序列化协议。

false

布尔值

camel.component.netty4.configuration.udp-connectionless-sending

此选项支持 udp 发送较少连接,这是实际触发和忘记。连接的 udp 会发送 PortUnreachableException(如果没有这些端口侦听接收端口)。

false

布尔值

camel.component.netty4.configuration.use-byte-buf

如果 useByteBuf 为 true,netty producer 会在发送消息正文前将消息正文转变为 ByteBuf。

false

布尔值

camel.component.netty4.configuration.using-executor-service

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

true

布尔值

camel.component.netty4.configuration.worker-count

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

 

整数

camel.component.netty4.configuration.worker-group

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

 

EventLoopGroup

camel.component.netty4.enabled

启用 netty4 组件

true

布尔值

camel.component.netty4.executor-service

使用给定的 EventExecutorGroup。选项是 io.netty.util.concurrent.EventExecutorGroup 类型。

 

字符串

camel.component.netty4.maximum-pool-size

EventExecutorGroup 的线程池大小(如果其使用)。默认值为 16。

16

整数

camel.component.netty4.resolve-property-placeholders

启动时,组件是否应自行解析属性占位符。只有 String 类型的属性才能使用属性占位符。

true

布尔值

camel.component.netty4.ssl-context-parameters

使用 SSLContextParameters 配置安全性。选项是一个 org.apache.camel.util.jsse.SSLContextParameters 类型。

 

字符串

camel.component.netty4.use-global-ssl-context-parameters

启用使用全局 SSL 上下文参数。

false

布尔值

camel.component.netty4.configuration.client-pipeline-factory

@deprecated use #setClientInitializerFactory

 

ClientInitializer Factory

camel.component.netty4.configuration.decoder

自定义 ChannelHandler 类,可用于执行入站有效负载的特殊汇总。

 

ChannelHandler

camel.component.netty4.configuration.encoder

自定义 ChannelHandler 类,可用于对出站有效负载进行特殊汇总。

 

ChannelHandler

camel.component.netty4.configuration.key-store-file

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

 

File

camel.component.netty4.configuration.server-pipeline-factory

@deprecated use #setServerInitializerFactory

 

ServerInitializer Factory

camel.component.netty4.configuration.trust-store-file

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

 

File