IP 配置属性

下表描述了可用于配置 IP 连接的属性

表 1. 连接工厂属性
属性名称	客户端?	服务器?	允许值	属性描述
`type`	是	是	client, server	确定连接工厂是客户端还是服务器。
`host`	是	否		目标的 hostname 或 IP 地址。
`port`	是	是		端口。
`serializer`	是	是		用于序列化负载的 `Serializer` 实现。默认为 `ByteArrayCrLfSerializer`
`deserializer`	是	是		用于反序列化负载的 `Deserializer` 实现。默认为 `ByteArrayCrLfSerializer`
`using-nio`	是	是	`true`, `false`	连接是否使用 NIO。更多信息请参阅 `java.nio` 包。参见关于非阻塞 I/O (NIO)。默认值：`false`。
`using-direct-buffers`	是	否	`true`, `false`	当使用 NIO 时，连接是否使用直接缓冲区。更多信息请参阅 `java.nio.ByteBuffer` 文档。如果 `using-nio` 为 `false`，则此属性必须为 `false`。
`apply-sequence`	是	是	`true`, `false`	当使用 NIO 时，可能需要重新排序消息。当此属性设置为 `true` 时，接收到的消息将添加 `correlationId` 和 `sequenceNumber` 头部。参见关于非阻塞 I/O (NIO)。默认值：`false`。
`so-timeout`	是	是		默认为 `0` (无限)，但 `single-use="true"` 的服务器连接工厂除外。在这种情况下，它默认为默认回复超时 (10 秒)。
`so-send-buffer-size`	是	是		参见 `java.net.Socket.` `setSendBufferSize()`。
`so-receive-buffer-size`	是	是		参见 `java.net.Socket.` `setReceiveBufferSize()`。
`so-keep-alive`	是	是	`true`, `false`	参见 `java.net.Socket.setKeepAlive()`。
`so-linger`	是	是		将 `linger` 设置为 `true` 并指定值。参见 `java.net.Socket.setSoLinger()`。
`so-tcp-no-delay`	是	是	`true`, `false`	参见 `java.net.Socket.setTcpNoDelay()`。
`so-traffic-class`	是	是		参见 `java.net.Socket.` `setTrafficClass()`。
`local-address`	否	是		在多宿主系统上，指定套接字绑定的接口的 IP 地址。
`task-executor`	是	是		指定用于套接字处理的特定执行器。如果未提供，则使用内部缓存线程执行器。某些平台需要使用特定的任务执行器（例如 `WorkManagerTaskExecutor`），在此情况下需要指定。
`single-use`	是	是	`true`, `false`	指定连接是否可用于多个消息。如果为 `true`，则每条消息使用新的连接。
`pool-size`	否	否		此属性不再使用。为了向后兼容，它会设置 backlog，但您应该使用 `backlog` 来指定服务器工厂的连接积压。
`backlog`	否	是		设置服务器工厂的连接积压。
`lookup-host`	是	是	`true`, `false`	指定是否对 IP 地址进行反向查找以转换为用于消息头的 hostname。如果为 false，则使用 IP 地址代替。默认值：`false`。
`interceptor-factory-chain`	是	是		参见 TCP 连接拦截器。
`ssl-context-support`	是	是		参见 `SSL/TLS 支持`。
`socket-factory-support`	是	是		参见 `SSL/TLS 支持`。
`socket-support`	是	是		参见 SSL/TLS 支持。
`nio-connection-support`	是	是		参见高级技术。
`read-delay`	是	是	long > 0	由于线程不足导致前一次读取失败后，重试读取前的延迟时间（毫秒）。默认值：100。仅当 `using-nio` 为 `true` 时适用。

下表描述了可用于配置 UDP 入站通道适配器的属性

表 2. UDP 入站通道适配器属性
属性名称	允许值	属性描述
`port`		适配器监听的端口。
`multicast`	`true`, `false`	UDP 适配器是否使用多播。
`multicast-address`		当 multicast 为 true 时，适配器加入的多播地址。
`pool-size`		指定可并发处理多少个数据包。仅当未配置 task-executor 时适用。默认值：5。
task-executor		指定用于套接字处理的特定执行器。如果未提供，则使用内部 pooled 执行器。某些平台需要使用特定的任务执行器（例如 `WorkManagerTaskExecutor`），在此情况下需要指定。线程需求参见 pool-size。
`receive-buffer-size`		用于接收 `DatagramPackets` 的缓冲区大小。通常设置为最大传输单元 (MTU) 大小。如果使用的缓冲区小于发送数据包的大小，可能会发生截断。您可以使用 `check-length` 属性检测到这一点。
`check-length`	`true`, `false`	UDP 适配器是否期望接收到的数据包中包含数据长度字段。用于检测数据包截断。
`so-timeout`		更多信息请参阅 `java.net.DatagramSocket` 中的 `setSoTimeout()` 方法。
`so-send-buffer-size`		用于 UDP 确认数据包。更多信息请参阅 `java.net.DatagramSocket` 中的 `setSendBufferSize()` 方法。
`so-receive-buffer-size`		更多信息请参阅 `java.net.DatagramSocket.setReceiveBufferSize()`。
`local-address`		在多宿主系统上，指定套接字绑定的接口的 IP 地址。
`error-channel`		如果下游组件抛出异常，包含异常和失败消息的 `MessagingException` 消息将被发送到此通道。
`lookup-host`	`true`, `false`	指定是否对 IP 地址进行反向查找以转换为用于消息头的 hostname。如果为 `false`，则使用 IP 地址代替。默认值：`false`。

下表描述了可用于配置 UDP 出站通道适配器的属性

表 3. UDP 出站通道适配器属性
属性名称	允许值	属性描述
`host`		目标的 hostname 或 IP 地址。对于多播 UDP 适配器，即多播地址。
`port`		目标上的端口。
`multicast`	`true`, `false`	UDP 适配器是否使用多播。
`acknowledge`	`true`, `false`	UDP 适配器是否需要目标发送确认。启用此功能时，需要设置以下四个属性：`ack-host`, `ack-port`, `ack-timeout` 和 `min-acks-for- success`。
`ack-host`		当 `acknowledge` 为 `true` 时，表示应将确认发送到的主机或 IP 地址。通常是当前主机，但也可能不同——例如，正在使用网络地址转换 (NAT) 时。
`ack-port`		当 `acknowledge` 为 `true` 时，表示应将确认发送到的端口。适配器将监听此端口以接收确认。
`ack-timeout`		当 `acknowledge` 为 `true` 时，表示适配器等待确认的时间（毫秒）。如果在指定时间内未收到确认，适配器将抛出异常。
`min-acks-for- success`		默认为 1。对于多播适配器，您可以将其设置为更大的值，这要求从多个目标接收确认。
`check-length`	`true`, `false`	UDP 适配器是否在发送到目标的数据包中包含数据长度字段。
`time-to-live`		对于多播适配器，指定 `MulticastSocket` 的 time-to-live 属性。控制多播的范围。更多信息请参阅 Java API 文档。
`so-timeout`		更多信息请参阅 `java.net.DatagramSocket` 的 setSoTimeout() 方法。
`so-send-buffer-size`		更多信息请参阅 `java.net.DatagramSocket` 中的 `setSendBufferSize()` 方法。
`so-receive-buffer-size`		用于 UDP 确认数据包。更多信息请参阅 `java.net.DatagramSocket` 中的 `setReceiveBufferSize()` 方法。
local-address		在多宿主系统上，对于 UDP 适配器，指定套接字绑定用于回复消息的接口的 IP 地址。对于多播适配器，它还决定发送多播数据包的接口。
`task-executor`		指定用于处理确认的特定执行器。如果未提供，则使用内部单线程执行器。某些平台需要使用特定的任务执行器（例如 `WorkManagerTaskExecutor`），在此情况下需要指定。一个线程专门用于处理确认（如果 `acknowledge` 选项为 true）。
`destination-expression`	SpEL 表达式	一个 SpEL 表达式，用于评估确定出站 UDP 数据包的目标 `SocketAddress`。
`socket-expression`	SpEL 表达式	一个 SpEL 表达式，用于评估确定用于发送出站 UDP 数据包的数据报套接字。

下表描述了可用于配置 TCP 入站通道适配器的属性

表 4. TCP 入站通道适配器属性
属性名称	允许值	属性描述
`channel`		用于发送入站消息的通道。
`connection-factory`		如果连接工厂的类型是 `server`，则此适配器“拥有”该工厂。如果类型是 `client`，则由出站通道适配器“拥有”，此适配器接收出站适配器创建的连接上的任何入站消息。
`error-channel`		如果下游组件抛出异常，包含异常和失败消息的 `MessagingException` 消息将被发送到此通道。
`client-mode`	`true`, `false`	当为 `true` 时，入站适配器在建立连接和接收该连接上的入站消息方面充当客户端。默认值：`false`。另请参阅 `retry-interval` 和 `scheduler`。连接工厂必须是 `client` 类型且 `single-use` 设置为 `false`。
`retry-interval`		在 `client-mode` 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。
`scheduler`	`true`, `false`	指定用于管理 `client-mode` 连接的 `TaskScheduler`。如果未指定，则默认为全局 Spring Integration `taskScheduler` Bean，其默认池大小为 10。参见配置任务调度器。

下表描述了可用于配置 TCP 出站通道适配器的属性

表 5. TCP 出站通道适配器属性
属性名称	允许值	属性描述
`channel`		接收出站消息的通道。
`connection-factory`		如果连接工厂的类型是 `client`，则此适配器“拥有”该工厂。如果类型是 `server`，则由入站通道适配器“拥有”，此适配器尝试将消息与接收到原始入站消息的连接进行关联。
`client-mode`	`true`, `false`	当为 `true` 时，出站适配器在启动时尝试建立连接。当为 `false` 时，连接在发送第一条消息时建立。默认值：`false`。另请参阅 `retry-interval` 和 `scheduler`。连接工厂必须是 `client` 类型且 `single-use` 设置为 `false`。
`retry-interval`		在 `client-mode` 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。
`scheduler`	`true`, `false`	指定用于管理 `client-mode` 连接的 `TaskScheduler`。如果未指定，则默认为全局 Spring Integration `taskScheduler` Bean，其默认池大小为 10。参见配置任务调度器。

下表描述了可用于配置 TCP 入站网关的属性

表 6. TCP 入站网关属性
属性名称	允许值	属性描述
`connection-factory`		连接工厂必须是 server 类型。
`request-channel`		用于发送入站消息的通道。
`reply-channel`		可能接收回复消息的通道。通常，回复会到达添加到入站消息头部的临时回复通道。
`reply-timeout`		网关等待回复的时间（毫秒）。默认值：1000（1 秒）。
`error-channel`		如果下游组件抛出异常，包含异常和失败消息的 `MessagingException` 消息将被发送到此通道。来自该流程的任何回复随后作为响应由网关返回。
`client-mode`	`true`, `false`	当为 `true` 时，入站网关在建立连接和接收（以及回复）该连接上的入站消息方面充当客户端。默认值：false。另请参阅 `retry-interval` 和 `scheduler`。连接工厂必须是 `client` 类型且 `single-use` 设置为 `false`。
`retry-interval`		在 `client-mode` 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。
`scheduler`	`true`, `false`	指定用于管理 `client-mode` 连接的 `TaskScheduler`。如果未指定，则默认为全局 Spring Integration `taskScheduler` Bean，其默认池大小为 10。参见配置任务调度器。

下表描述了可用于配置 TCP 出站网关的属性

表 7. TCP 出站网关属性
属性名称	允许值	属性描述
`connection-factory`		连接工厂必须是 `client` 类型。
`request-channel`		接收出站消息的通道。
`reply-channel`		可选。用于发送回复消息的通道。
`remote-timeout`		网关等待来自远程系统的回复的时间（毫秒）。与 `remote-timeout-expression` 互斥。默认值：10000（10 秒）。注意：在 4.2 之前的版本中，此值默认为 `reply-timeout`（如果设置）。
`remote-timeout-expression`		一个 SpEL 表达式，用于评估确定网关等待来自远程系统的回复的时间（毫秒）。与 `remote-timeout` 互斥。
`request-timeout`		如果未使用单次连接工厂，网关等待获取共享连接访问权限的时间（毫秒）。
`reply-timeout`		网关将回复发送到 reply-channel 时等待的时间（毫秒）。仅当 reply-channel 可能阻塞（例如当前已满的有界 QueueChannel）时适用。
`async`		发送后释放发送线程；回复（或错误）将在接收线程上发送。
`unsolicited` `MessageChannel`		用于发送非请求消息和延迟回复的通道。