集成端点
本节介绍了 Spring Integration 提供的各种通道适配器和消息网关,以支持与外部系统的基于消息的通信。 每个系统,从 AMQP 到 Zookeeper,都有其自己的集成要求,本节将涵盖这些要求。
端点快速参考表
如前几节所述,Spring Integration 提供了许多用于与外部系统、文件系统等接口的端点。
为了透明的依赖管理,Spring Integration 提供了一个 BOM (bill-of-materials) POM,可以将其导入 Maven 配置中:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.integration</groupId>
<artifactId>spring-integration-bom</artifactId>
<version>{project-version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
回顾一下:
-
入站通道适配器用于单向集成,将数据引入消息应用程序。
-
出站通道适配器用于单向集成,将数据从消息应用程序发送出去。
-
入站网关用于双向集成流,其中其他系统调用消息应用程序并接收回复。
-
出站网关用于双向集成流,其中消息应用程序调用某个外部服务或实体并期望获得结果。
下表总结了各种端点,并提供了指向相应章节的快速链接。
模块 | 入站适配器 | 出站适配器 | 入站网关 | 出站网关 |
---|---|---|---|---|
AMQP |
||||
Apache Camel |
N |
N |
||
Apache Cassandra |
N |
N |
||
Debezium |
N |
N |
N |
|
Events |
N |
N |
||
Feed |
N |
N |
N |
|
File |
N |
|||
FTP(S) |
N |
|||
GraphQL |
N |
N |
N |
|
Hazelcast |
N |
N |
||
HTTP |
||||
JDBC |
N |
|||
JMS |
||||
JMX |
N |
|||
JPA |
N |
|||
Apache Kafka |
||||
N |
N |
|||
MongoDB |
N |
N |
||
MQTT |
N |
N |
||
R2DBC |
N |
N |
||
Redis |
Redis 入站通道适配器、Redis 队列入站通道适配器、Redis 存储入站通道适配器、Redis 流入站通道适配器 |
Redis 出站通道适配器、Redis 队列出站通道适配器、Redis 存储出站通道适配器、Redis 流出站通道适配器 |
||
Resource |
N |
N |
N |
|
RSocket |
N |
N |
||
SFTP |
N |
|||
SMB |
N |
|||
STOMP |
N |
N |
||
Stream |
N |
N |
||
Syslog |
N |
N |
N |
|
TCP |
||||
UDP |
N |
N |
||
WebFlux |
||||
Web Services |
N |
N |
||
Web Sockets |
N |
N |
||
XMPP |
N |
N |
||
ZeroMQ |
N |
N |
此外,如 核心消息 中所述,Spring Integration 提供了用于与普通 Java 对象 (POJO) 接口的端点。
如 通道适配器 中所述,<int:inbound-channel-adapter>
元素允许您轮询 Java 方法以获取数据。
<int:outbound-channel-adapter>
元素允许您将数据发送到 void
方法。
如 消息网关 中所述,<int:gateway>
元素允许任何 Java 程序调用消息流。
所有这些都无需在源代码级别依赖 Spring Integration 即可工作。
在这种情况下,出站网关的等效是使用服务激活器(参见 服务激活器)来调用返回某种 Object
的方法。
从 5.2.2
版本开始,所有入站网关都可以配置一个 errorOnTimeout
布尔标志,当下游流在回复超时期间没有返回回复时,抛出 MessageTimeoutException
。
计时器直到线程将控制权返回给网关才启动,因此通常只有当D下游流是异步的,或者由于某个处理程序(例如 过滤器)返回 null
而停止时才有用。
这种异常可以在 errorChannel
流上处理,例如为请求客户端生成补偿回复。