IP 配置属性

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 时适用。

port

适配器监听的端口。

multicast

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

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

指定是否对 IP 地址进行反向查找以转换为用于消息头的 hostname。如果为 false，则使用 IP 地址代替。默认值：false。

host

目标的 hostname 或 IP 地址。对于多播 UDP 适配器，即多播地址。

port

目标上的端口。

multicast

UDP 适配器是否使用多播。

acknowledge

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

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 表达式，用于评估确定出站 UDP 数据包的目标 SocketAddress。

socket-expression

一个 SpEL 表达式，用于评估确定用于发送出站 UDP 数据包的数据报套接字。

channel

用于发送入站消息的通道。

connection-factory

如果连接工厂的类型是 server，则此适配器“拥有”该工厂。如果类型是 client，则由出站通道适配器“拥有”，此适配器接收出站适配器创建的连接上的任何入站消息。

error-channel

如果下游组件抛出异常，包含异常和失败消息的 MessagingException 消息将被发送到此通道。

client-mode

当为 true 时，入站适配器在建立连接和接收该连接上的入站消息方面充当客户端。默认值：false。另请参阅 retry-interval 和 scheduler。连接工厂必须是 client 类型且 single-use 设置为 false。

retry-interval

在 client-mode 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。

scheduler

指定用于管理 client-mode 连接的 TaskScheduler。如果未指定，则默认为全局 Spring Integration taskScheduler Bean，其默认池大小为 10。参见配置任务调度器。

channel

接收出站消息的通道。

connection-factory

如果连接工厂的类型是 client，则此适配器“拥有”该工厂。如果类型是 server，则由入站通道适配器“拥有”，此适配器尝试将消息与接收到原始入站消息的连接进行关联。

client-mode

当为 true 时，出站适配器在启动时尝试建立连接。当为 false 时，连接在发送第一条消息时建立。默认值：false。另请参阅 retry-interval 和 scheduler。连接工厂必须是 client 类型且 single-use 设置为 false。

retry-interval

在 client-mode 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。

scheduler

指定用于管理 client-mode 连接的 TaskScheduler。如果未指定，则默认为全局 Spring Integration taskScheduler Bean，其默认池大小为 10。参见配置任务调度器。

connection-factory

连接工厂必须是 server 类型。

request-channel

用于发送入站消息的通道。

reply-channel

可能接收回复消息的通道。通常，回复会到达添加到入站消息头部的临时回复通道。

reply-timeout

网关等待回复的时间（毫秒）。默认值：1000（1 秒）。

error-channel

如果下游组件抛出异常，包含异常和失败消息的 MessagingException 消息将被发送到此通道。来自该流程的任何回复随后作为响应由网关返回。

client-mode

当为 true 时，入站网关在建立连接和接收（以及回复）该连接上的入站消息方面充当客户端。默认值：false。另请参阅 retry-interval 和 scheduler。连接工厂必须是 client 类型且 single-use 设置为 false。

retry-interval

在 client-mode 下，指定两次连接尝试之间或连接失败后等待的毫秒数。默认值：60000（60 秒）。

scheduler

指定用于管理 client-mode 连接的 TaskScheduler。如果未指定，则默认为全局 Spring Integration taskScheduler Bean，其默认池大小为 10。参见配置任务调度器。

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

用于发送非请求消息和延迟回复的通道。