跳到主要内容
版本：7.0.2

TCP 适配器

DeepSeek V3 中英对照 TCP Adapters

提供了使用连接工厂的 TCP 入站和出站通道适配器（前文已提及）。这些适配器具有两个相关属性：connection-factory 和 channel。connection-factory 属性指示适配器将使用哪个连接工厂来管理连接。channel 属性指定消息到达出站适配器的通道，以及入站适配器放置消息的通道。虽然入站和出站适配器可以共享一个连接工厂，但服务器连接工厂始终由入站适配器“拥有”。客户端连接工厂始终由出站适配器“拥有”。每种类型的适配器只能有一个获取对连接工厂的引用。以下示例展示了如何定义客户端和服务器 TCP 连接工厂：

<bean id="javaSerializer"
      class="org.springframework.core.serializer.DefaultSerializer"/>
<bean id="javaDeserializer"
      class="org.springframework.core.serializer.DefaultDeserializer"/>

<int-ip:tcp-connection-factory id="server"
    type="server"
    port="1234"
    deserializer="javaDeserializer"
    serializer="javaSerializer"
    using-nio="true"
    single-use="true"/>

<int-ip:tcp-connection-factory id="client"
    type="client"
    host="localhost"
    port="#{server.port}"
    single-use="true"
    so-timeout="10000"
    deserializer="javaDeserializer"
    serializer="javaSerializer"/>

<int:channel id="input" />

<int:channel id="replies">
    <int:queue/>
</int:channel>

<int-ip:tcp-outbound-channel-adapter id="outboundClient"
    channel="input"
    connection-factory="client"/>

<int-ip:tcp-inbound-channel-adapter id="inboundClient"
    channel="replies"
    connection-factory="client"/>

<int-ip:tcp-inbound-channel-adapter id="inboundServer"
    channel="loop"
    connection-factory="server"/>

<int-ip:tcp-outbound-channel-adapter id="outboundServer"
    channel="loop"
    connection-factory="server"/>

<int:channel id="loop"/>

在上述配置中，到达 input 通道的消息通过 client 连接工厂创建的连接进行序列化，在服务器端接收后放入 loop 通道。由于 loop 是 outboundServer 的输入通道，消息会通过同一连接回传，由 inboundClient 接收，并存入 replies 通道。传输过程中使用了 Java 序列化。

通常，入站适配器使用 type="server" 类型的连接工厂，用于监听传入的连接请求。在某些情况下，您可能希望以相反的方式建立连接，即入站适配器连接到外部服务器，然后在该连接上等待入站消息。

该拓扑通过在入站适配器上设置 client-mode="true" 来支持。在这种情况下，连接工厂必须为 client 类型，并且必须将 single-use 设置为 false。

还有两个属性支持这一机制。retry-interval 属性（以毫秒为单位）指定框架在连接失败后尝试重新连接的频率。scheduler 属性则提供一个 TaskScheduler，用于调度连接尝试并测试连接是否仍处于活动状态。

如果你没有提供调度器，框架将使用默认的 taskScheduler bean。

对于出站适配器，连接通常在发送第一条消息时建立。出站适配器上的 client-mode="true" 会导致适配器启动时建立连接。默认情况下，适配器会自动启动。同样，连接工厂必须是 client 类型，并且设置 single-use="false"。同时支持 retry-interval 和 scheduler 配置。如果连接失败，连接将由调度器或在发送下一条消息时重新建立。

对于入站和出站连接，如果适配器已启动，你可以通过发送 <control-bus /> 命令强制适配器建立连接：@adapter_id.retryConnection()。然后，你可以使用 @adapter_id.isClientModeConnected() 来检查当前状态。