|
对于最新的稳定版本，请使用 Spring Integration 6.4.0！ |
TCP 网关
入站 TCP 网关和出站 TCP 网关分别使用服务器和客户端连接工厂。
每个连接一次可以处理一个请求或响应。TcpInboundGatewayTcpOutboundGateway
入站网关在构造包含传入负载的消息并将其发送到 后，等待响应，并通过将响应消息写入连接来发送响应消息中的负载。requestChannel
对于入站网关，您必须保留或填充标头，因为它用于将消息与连接相关联。
源自网关的消息会自动设置标头。
如果回复是作为新消息构建的，则需要设置 header。
可以从传入消息中捕获标头值。ip_connectionId |
与入站适配器一样，入站网关通常使用连接工厂，该工厂侦听传入的连接请求。
在某些情况下，您可能希望反向建立连接，以便入站网关连接到外部服务器，然后等待并回复该连接上的入站邮件。type="server"
在入站网关上使用支持此拓扑。
在这种情况下，连接工厂必须是 type 并且必须设置为 。client-mode="true"clientsingle-usefalse
两个附加属性支持此机制。
它指定 （以毫秒为单位） 框架在连接失败后尝试重新连接的频率。
提供 a 来计划连接尝试并测试连接是否仍处于活动状态。retry-intervalschedulerTaskScheduler
如果网关已启动，则可以通过发送命令来强制网关建立连接，并使用 检查当前状态。<control-bus/>@adapter_id.retryConnection()@adapter_id.isClientModeConnected()
出站网关在通过连接发送消息后，等待响应，构建响应消息，并将其放在回复通道上。 通过连接进行的通信是单线程的。 一次只能处理一条消息。 如果另一个线程在收到当前响应之前尝试发送消息，它将阻塞，直到任何先前的请求完成（或超时）。 但是，如果将客户端连接工厂配置为一次性连接，则每个新请求都会获得自己的连接并立即得到处理。 以下示例配置入站 TCP 网关：
<int-ip:tcp-inbound-gateway id="inGateway"
request-channel="tcpChannel"
reply-channel="replyChannel"
connection-factory="cfServer"
reply-timeout="10000"/>如果使用配置了默认序列化器或反序列化器的连接工厂，则消息是分隔数据，并且网关可以由简单的客户端（如 telnet）使用。\r\n
以下示例显示了出站 TCP 网关：
<int-ip:tcp-outbound-gateway id="outGateway"
request-channel="tcpChannel"
reply-channel="replyChannel"
connection-factory="cfClient"
request-timeout="10000"
remote-timeout="10000"/> <!-- or e.g. remote-timeout-expression="headers['timeout']" -->目前，出站网关 不可用。client-mode
从版本 5.2 开始，可以使用属性 .
如果连接工厂配置为（每个请求/回复的新连接），则网关将关闭输出流;这会向服务器发出 EOF 信号。
如果服务器使用 EOF 来确定消息的结尾，而不是流中的某个分隔符，但保持连接打开以接收回复，则这非常有用。closeStreamAfterSendsingle-use
通常，调用线程将在网关中阻塞，等待回复（或超时）。
从版本 5.3 开始，您可以在网关上设置该属性，并释放发送线程以执行其他工作。
回复（或错误）将在接收线程上发送。
这仅适用于使用 时，它在使用 NIO 时被忽略，因为存在争用条件，即在收到回复后发生的套接字错误可以在回复之前传递给网关。asyncTcpNetClientConnectionFactory
使用共享连接 （） 时，当另一个请求正在处理时，新请求将被阻止，直到收到当前回复。
如果您希望在长期连接池上支持并发请求，请考虑使用 。singleUse=falseCachingClientConnectionFactory |
从版本 5.4 开始，可以使用 .
未经请求的入站消息以及延迟回复（客户端超时）将发送到此通道。
要在服务器端支持此功能，您现在可以向连接工厂注册多个 s。
网关和通道适配器会自动注册自身。
从服务器发送未经请求的邮件时，必须将 appropriate 添加到发送的邮件中。unsolicitedMessageChannelTcpSenderIpHeaders.CONNECTION_ID