35.12. Spring Boot Auto-Configuration
将 netty 与 Spring Boot 搭配使用时，请确保使用以下 Maven 依赖项支持自动配置：
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-netty-starter</artifactId>
<version>{CamelSBProjectVersion}</version>
<!-- Use your Camel Spring Boot version -->
</dependency>组件支持 74 选项，如下所示。
| Name | 描述 | 默认 | 类型 |
|---|---|---|---|
| camel.component.netty.allow-default-codec | 如果既是，netty 组件都会安装一个默认的 codec，则 encoder/decoder 是 null，文本行是 false。将 allowDefaultCodec 设置为 false 可防止 netty 组件作为过滤器链中的第一个元素安装默认 codec。 | true | 布尔值 |
| camel.component.netty.allow-serialized-headers | 仅在 transferExchange 为 true 时使用 TCP。当设置为 true 时，标头和属性中的 serializable 对象将添加到交换中。否则，Camel 将排除任何非序列化对象，并将其记录在 WARN 级别。 | false | 布尔值 |
| camel.component.netty.auto-append-delimiter | 在使用文本 codec 发送时，是否自动附加缺少的最终分隔符。 | true | 布尔值 |
| camel.component.netty.autowired-enabled | 是否启用自动。这用于自动自动自动选项（选项必须标记为 autowired），方法是在 registry 中查找是否有匹配的类型实例，然后在组件上进行配置。这可用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.netty.backlog | 允许为 netty 消费者(server)配置积压。请注意，积压只是取决于操作系统的最佳工作。将此选项设置为 200、500 或 1000 之类的值，告知 TCP 堆栈在未配置此选项时接受队列的时长，如果不配置这个选项，则后端日志依赖于 OS 设置。 | 整数 | |
| camel.component.netty.boss-count | 当 netty 在 nio 模式上工作时，它使用 Netty 中的默认 位于Count 参数，即 1。用户可以使用此选项覆盖 Netty 的默认 bossCount。 | 1 | 整数 |
| camel.component.netty.boss-group | 设置 BossGroup，它们可用于处理 NettyEndpoint 之间的服务器端的新连接。选项是 io.netty.channel.EventLoopGroup 类型。 | EventLoopGroup | |
| camel.component.netty.bridge-error-handler | 允许将消费者桥接到 Camel 路由 Error Handler，这意味着在消费者尝试获取传入的消息时发生任何异常，或像这样一样处理，消息现在将被作为消息进行处理，并由路由 Error Handler 处理。默认情况下，使用者将使用 org.apache.camel.spi.ExceptionHandler 处理异常，该处理程序将记录在 WARN 或 ERROR 级别并忽略。 | false | 布尔值 |
| camel.component.netty.broadcast | 设置 以选择 UDP 上的多播。 | false | 布尔值 |
| camel.component.netty.channel-group | 使用显式 ChannelGroup。选项是 io.netty.channel.group.ChannelGroup 类型。 | ChannelGroup | |
| camel.component.netty.client-initializer-factory | 使用自定义 ClientInitializerFactory。选项是 org.apache.camel.component.netty.ClientInitializerFactory 类型。 | ClientInitializerFactory | |
| camel.component.netty.client-mode | 如果 clientMode 为 true，netty 消费者将地址连接为 TCP 客户端。 | false | 布尔值 |
| camel.component.netty.configuration | 在创建端点时，使用 NettyConfiguration 作为配置。选项是 org.apache.camel.component.netty.NettyConfiguration 类型。 | NettyConfiguration | |
| camel.component.netty.connect-timeout | 等待套接字连接可用的时间。值以毫秒为单位。 | 10000 | 整数 |
| camel.component.netty.correlation-manager | 要使用自定义关联管理器来管理请求和回复消息的方式，在将请求/回复消息与 netty producer 搭配使用时进行映射。只有在您有方法将请求与回复请求（如请求和回复消息中都存在关联 id 时）进行使用。如果您希望在 netty 在同一频道（也称为连接）上的多个并发信息上，可以使用这个信息。当这样做时，您必须有关联请求和回复消息的方法，以便您可以在航班的 Camel Exchange 上存储正确的回复，然后再继续路由。我们建议在构建自定义关联管理器时扩展 TimeoutCorrelationManagerSupport。这为需要实施的超时和其他复杂性提供支持。如需了解更多详细信息，请参阅 producerPoolEnabled 选项。选项是 org.apache.camel.component.netty.NettyCamelStateCorrelationManager 类型。 | NettyCamelStateCorrelationManager | |
| camel.component.netty.decoder-max-line-length | 用于文本行代码的最大行长度。 | 1024 | 整数 |
| camel.component.netty.decoders | 要使用的解码器列表。您可以使用带有用逗号分开的值的 String，并在 Registry 中查找值。只需记得使用 # so Camel 知道它应该查找的值。 | 字符串 | |
| camel.component.netty.delimiter | 用于文本行代码的分隔符。可能的值有 LINE 和 NULL。 | TextLineDelimiter | |
| camel.component.netty.disconnect | 使用后是否立即断开（关闭）与 Netty Channel 的连接。可用于使用者和制作者。 | false | 布尔值 |
| camel.component.netty.disconnect-on-no-reply | 如果启用了同步，则此选项将指定 NettyConsumer，如果它应该断开连接，没有回复回复。 | true | 布尔值 |
| camel.component.netty.enabled | 是否启用 netty 组件的自动配置。默认启用。 | 布尔值 | |
| camel.component.netty.enabled-protocols | 使用 SSL 时要启用哪些协议。 | TLSv1,TLSv1.1,TLSv1.2 | 字符串 |
| camel.component.netty.encoders | 要使用的编码器列表。您可以使用带有用逗号分开的值的 String，并在 Registry 中查找值。只需记得使用 # so Camel 知道它应该查找的值。 | 字符串 | |
| camel.component.netty.encoding | 用于文本代码的编码（一个 charset 名称）。如果没有提供，Camel 将使用 JVM 默认 Charset。 | 字符串 | |
| camel.component.netty.executor-service | 使用给定的 EventExecutorGroup。选项是 io.netty.util.concurrent.EventExecutorGroup 类型。 | EventExecutorGroup | |
| camel.component.netty.hostname-verification | 要在 SSLEngine 上启用/禁用主机名验证。 | false | 布尔值 |
| camel.component.netty.keep-alive | 将 设置为，以确保因为不活跃而关闭套接字。 | true | 布尔值 |
| camel.component.netty.key-store-file | 用于加密的客户端侧证书密钥存储。 | File | |
| camel.component.netty.key-store-format | 用于有效负载加密的密钥存储格式。若未设置，则默认为 JKS。 | 字符串 | |
| camel.component.netty.key-store-resource | 用于加密的客户端侧证书密钥存储。从 classpath 中默认加载，但您可以使用 classpath:、file: 或 http: 前缀来从不同的系统加载资源。 | 字符串 | |
| camel.component.netty.lazy-channel-creation | 如果远程服务器在 Camel 制作者启动时未启动并运行，可以先创建频道来避免异常。 | true | 布尔值 |
| camel.component.netty.lazy-start-producer | 制作者是否应该启动 lazy（在第一个消息上）。通过启动 lazy，您可以使用它来允许 CamelContext 和路由在启动期间启动，否则在启动期间出现问题，并导致路由启动失败。通过将这个启动延迟到 lazy 后，可以在通过 Camel 的路由错误处理程序路由消息期间处理启动失败。注意在处理第一个消息时，创建并启动制作者可能花费较少的时间，从而延长处理的总处理时间。 | false | 布尔值 |
| camel.component.netty.maximum-pool-size | 为 netty consumer 排序线程池设置最大线程池大小。默认大小为 2 x cpu_core 加 1。将此值设置为 eg 10 然后使用 10 个线程，除非 2 x cpu_core 加 1 是更高的值，然后会被覆盖并使用。例如，如果存在 8 个内核，则消费者线程池为 17。此线程池用于路由 Camel 从 Netty 接收的消息。我们使用单独的线程池来确保消息的顺序以及某些消息将阻止，那么网络工作线程（事件循环）将会受到影响。 | 整数 | |
| camel.component.netty.native-transport | 是否使用原生传输，而不是 NIO。原生传输利用主机操作系统，且仅在某些平台上受支持。需要为您要使用的主机操作系统添加 netty JAR。要查看更多详细信息，请访问： | false | 布尔值 |
| camel.component.netty.need-client-auth | 配置服务器在使用 SSL 时是否需要客户端身份验证。 | false | 布尔值 |
| camel.component.netty.netty-server-bootstrap-factory | 使用自定义 NettyServerBootstrapFactory。选项是 org.apache.camel.component.netty.NettyServerBootstrapFactory 类型。 | NettyServerBootstrapFactory | |
| camel.component.netty.network-interface | 在使用 UDP 时，此选项可根据其名称指定网络接口，如 eth0 来加入多播组。 | 字符串 | |
| camel.component.netty.no-reply-log-level | 如果启用了同步，则此选项指定在日志记录没有回复时要使用的 NettyConsumer。 | LoggingLevel | |
| camel.component.netty.options | 允许使用 选项作为前缀来配置额外的 netty 选项。例如，option.child.keepAlive=false，以设置 netty 选项 child.keepAlive=false。有关可以使用的可能选项，请参阅 Netty 文档。 | map | |
| camel.component.netty.passphrase | 要使用的密码设置来加密/解密使用 SSH 发送的有效负载。 | 字符串 | |
| camel.component.netty.producer-pool-enabled | 制作者池是否启用。重要信息：如果您关闭此关闭，那么将使用一个共享连接用于制作者（如果您正在执行请求/回复）。这意味着，如果回复返回异常，则存在交集响应的问题。因此，您需要在请求和回复消息中有一个关联 id，以便您可以正确地将回复与负责在 Camel 中处理消息的 Camel 回调相关联。要这样做，您需要将 NettyCamelStateCorrelationManager 作为关联管理器实施，并通过 correlationManager 选项进行配置。如需了解更多详细信息，请参阅 correlationManager 选项。 | true | 布尔值 |
| camel.component.netty.producer-pool-max-idle | 设置池中空闲实例的数量。 | 100 | 整数 |
| camel.component.netty.producer-pool-max-total | 设置可由池分配的对象数量（签出到客户端，或者在给定时间闲置等待签出）。在没有限制的情况下使用负值。 | -1 | 整数 |
| camel.component.netty.producer-pool-min-evictable-idle | 在对象满足闲置对象驱除前，对象可能会处于空闲时间(millis)的最少时间（以 millis）设置。 | 300000 | Long |
| camel.component.netty.producer-pool-min-idle | 在驱除器线程（如果活跃）生成新对象前，设置制作池中允许的实例的最小数量。 | 整数 | |
| camel.component.netty.receive-buffer-size | 要在入站通信中使用的 TCP/UDP 缓冲大小。大小为字节。 | 65536 | 整数 |
| camel.component.netty.receive-buffer-size-predictor | 配置缓冲区大小预测器。请参阅 Jetty 文档和这个邮件线程的详细信息。 | 整数 | |
| camel.component.netty.reconnect | 仅在使用者中的 clientMode 中使用，如果启用，消费者会尝试在断开连接时重新连接。 | true | 布尔值 |
| camel.component.netty.reconnect-interval | 如果重新连接，并且启用了 clientMode。尝试重新连接的时间间隔（以 milli 秒为单位）。 | 10000 | 整数 |
| camel.component.netty.request-timeout | 允许在调用远程服务器时为 Netty producer 使用超时。默认情况下，不使用超时。该值在 milli 秒内，因此 eg 30000 为 30 秒。requestTimeout 使用 Netty 的 ReadTimeoutHandler 触发超时。 | Long | |
| camel.component.netty.reuse-address | 设置 以便促进套接字多路复用. | true | 布尔值 |
| camel.component.netty.reuse-channel | 此选项允许制作者和消费者（在客户端模式中）在处理 Exchange 的生命周期中重复使用相同的 Netty Channel。如果您需要在 Camel 路由中多次调用服务器，并且想要使用相同的网络连接，这很有用。当使用此功能时，在 Exchange 完成后，频道不会返回到连接池，如果断开连接选项被设置为 true，则频道不会返回到连接池。重复使用的频道作为带有键 NettyConstants#NETTY_CHANNEL 的交换属性存储在 Exchange 中，也可以在路由过程中获取频道并使用它来使用它。 | false | 布尔值 |
| camel.component.netty.security-provider | 用于有效负载加密的安全供应商。如果没有设置，则默认为 SunX509。 | 字符串 | |
| camel.component.netty.send-buffer-size | 在出站通信期间使用的 TCP/UDP 缓冲大小。大小为字节。 | 65536 | 整数 |
| camel.component.netty.server-closed-channel-exception-caught-log-level | 如果服务器(NettyConsumer)捕获 java.nio.channels.ClosedChannelException，则使用这个日志记录级别登录。这用于避免记录关闭频道例外，因为客户端可以断开，然后在 Netty 服务器中造成意外的异常。 | LoggingLevel | |
| camel.component.netty.server-exception-caught-log-level | 如果服务器(NettyConsumer)捕获异常，则使用此日志记录级别记录。 | LoggingLevel | |
| camel.component.netty.server-initializer-factory | 使用自定义 ServerInitializerFactory。选项是 org.apache.camel.component.netty.ServerInitializerFactory 类型。 | ServerInitializerFactory | |
| camel.component.netty.ssl | 设置，以指定是否将 SSL 加密应用到此端点。 | false | 布尔值 |
| camel.component.netty.ssl-client-cert-headers | 在 SSL 模式中启用和启用后，Netty consumer 将增强 Camel 消息以及包含客户端证书信息（如主题名称、签发者名称、序列号和有效日期范围）的信息。 | false | 布尔值 |
| camel.component.netty.ssl-context-parameters | 使用 SSLContextParameters 配置安全性。选项是 org.apache.camel.support.jsse.SSLContextParameters 类型。 | SSLContextParameters | |
| camel.component.netty.ssl-handler | 对可用于返回 SSL 处理程序的类的引用。选项是 io.netty.handler.ssl.SslHandler 类型。 | SslHandler | |
| camel.component.netty.sync | 将 设置为将端点设置为单向或请求响应。 | true | 布尔值 |
| camel.component.netty.tcp-no-delay | 设置 以提高 TCP 协议性能。 | true | 布尔值 |
| camel.component.netty.textline | 仅用于 TCP。如果没有指定 codec，您可以使用此标志来指示基于文本的 codec；如果没有指定或值为 false，则假设 Object Serialization 通过 TCP - 但是，默认情况下只允许 Strings 进行序列化。 | false | 布尔值 |
| camel.component.netty.transfer-exchange | 仅用于 TCP。您可以通过线路来传输交换，而不是只是正文。以下字段会被传输：在正文、传出正文、错误正文、标题、错误标头、交换属性、交换异常。这要求对象可以被序列化。Camel 将排除任何非序列化对象，并将其记录在 WARN 级别。 | false | 布尔值 |
| camel.component.netty.trust-store-file | 用于加密的服务器端证书密钥存储。 | File | |
| camel.component.netty.trust-store-resource | 用于加密的服务器端证书密钥存储。从 classpath 中默认加载，但您可以使用 classpath:、file: 或 http: 前缀来从不同的系统加载资源。 | 字符串 | |
| camel.component.netty.udp-byte-array-codec | 仅限 UDP。如果启用使用字节阵列代码而不是 Java 序列化协议。 | false | 布尔值 |
| camel.component.netty.udp-connectionless-sending | 此选项支持 udp 发送较少连接，这是实际触发和忘记。连接的 udp 会发送 PortUnreachableException（如果没有这些端口侦听接收端口）。 | false | 布尔值 |
| camel.component.netty.use-byte-buf | 如果 useByteBuf 为 true，netty producer 会在发送消息正文前将消息正文转变为 ByteBuf。 | false | 布尔值 |
| camel.component.netty.use-global-ssl-context-parameters | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
| camel.component.netty.using-executor-service | 是否使用排序的线程池，确保事件在同一频道中按顺序处理。 | true | 布尔值 |
| camel.component.netty.worker-count | 当 netty 在 nio 模式工作时，它使用 Netty（这是 cpu_core_threads x 2）的默认 workerCount 参数。用户可以使用此选项覆盖 Netty 的默认 workerCount。 | 整数 | |
| camel.component.netty.worker-group | 使用显式 EventLoopGroup 作为 scanner 线程池。例如，若要与多个使用者或制作者共享一个线程池。默认情况下，每个消费者或制作者都有自己的 worker 池，有 2 个 CPU 数量核心线程。选项是 io.netty.channel.EventLoopGroup 类型。 | EventLoopGroup |
