2.0 和 2.1 之间的变化

请参阅 迁移指南,了解可能影响您应用程序的重要更改。

新组件

2.1 版本添加了许多新组件。

JSR-223 脚本支持

在 Spring Integration 2.0 中,我们添加了对 Groovy 的支持。 通过 Spring Integration 2.1,我们通过实现对 JSR-223(“Java™ 平台脚本”)的支持,大大扩展了对其他语言的支持。 现在,您可以使用任何支持 JSR-223 的脚本语言,包括:

  • Javascript

  • Ruby 和 JRuby

  • Python 和 Jython

  • Groovy

有关更多详细信息,请参阅 脚本支持

AMQP 支持

Spring Integration 2.1 添加了几个通道适配器,用于使用 高级消息队列协议 (AMQP) 接收和发送消息。 此外,Spring Integration 还提供了点对点消息通道和发布-订阅消息通道,两者都由 AMQP 交换机和队列支持。

有关更多详细信息,请参阅 AMQP 支持

MongoDB 支持

从 2.1 版本开始,Spring Integration 通过提供基于 MongoDB 的 MessageStore 来支持 MongoDB

有关更多详细信息,请参阅 MongoDb 支持

Redis 支持

从 2.1 版本开始,Spring Integration 通过提供基于 Redis 的 MessageStore 以及发布-订阅消息适配器来支持 Redis,这是一种高级键值存储。

有关更多详细信息,请参阅 Redis 支持

支持 Spring 的资源抽象

在 2.1 版本中,我们引入了一个新的资源入站通道适配器,它基于 Spring 的资源抽象,以支持各种底层资源的实际类型(例如文件、URL 或类路径资源)的更大灵活性。 因此,它类似于文件入站通道适配器,但更通用。

有关更多详细信息,请参阅 资源入站通道适配器

存储过程组件

通过 Spring Integration 2.1,JDBC 模块还通过添加几个新组件(包括入站和出站通道适配器以及出站网关)来提供存储过程支持。 存储过程支持利用 Spring 的 SimpleJdbcCall 类,因此支持以下数据库的存储过程:

  • Apache Derby

  • DB2

  • MySQL

  • Microsoft SQL Server

  • Oracle

  • PostgreSQL

  • Sybase

存储过程组件还支持以下数据库的 SQL 函数:

  • MySQL

  • Microsoft SQL Server

  • Oracle

  • PostgreSQL

有关更多详细信息,请参阅 存储过程

XPath 和 XML 验证过滤器

Spring Integration 2.1 提供了一个新的基于 XPath 的消息过滤器。 它是 XML 模块的一部分。 XPath 过滤器允许您使用 XPath 表达式过滤消息。 我们还添加了 XML 验证过滤器的文档。

有关更多详细信息,请参阅 使用 XPath 过滤器XML 验证过滤器

负载增强器

自 Spring Integration 2.1 起,我们添加了负载增强器。 负载增强器定义了一个端点,该端点通常将 Message 传递到公开的请求通道,然后期望收到回复消息。 然后,回复消息成为评估表达式以增强目标负载的根对象。

有关更多详细信息,请参阅 负载增强器

FTP 和 SFTP 出站网关

Spring Integration 2.1 提供了两个新的出站网关,用于与远程文件传输协议 (FTP) 或安全文件传输协议 (SFTP) 服务器进行交互。 这两个网关允许您直接执行一组有限的远程命令。

例如,您可以使用这些出站网关来列出、检索和删除远程文件,并让 Spring Integration 消息流继续处理远程服务器的响应。

有关更多详细信息,请参阅 FTP 出站网关SFTP 出站网关

FTP 会话缓存

从 2.1 版本开始,我们为远程文件适配器(例如 FTP、SFTP 等)的会话管理提供了更大的灵活性。

具体来说,我们弃用了 cache-sessions 属性(可通过 XML 命名空间支持获得)。 作为替代,我们在 CachingSessionFactory 上添加了 sessionCacheSizesessionWaitTimeout 属性。

有关更多详细信息,请参阅 FTP 会话缓存SFTP 会话缓存

框架重构

我们以多种方式重构了 Spring Integration 框架,所有这些都在本节中进行了描述。

路由器配置标准化

我们通过 Spring Integration 2.1 对所有路由器实现中的路由器参数进行了标准化,以提供更一致的用户体验。

在 Spring Integration 2.1 中,我们删除了 ignore-channel-name-resolution-failures 属性,转而将其行为与 resolution-required 属性合并。 此外,resolution-required 属性现在默认为 true

从 Spring Integration 2.1 开始,如果未定义默认输出通道,路由器不再默默地丢弃任何消息。 这意味着,默认情况下,路由器现在至少需要一个已解析的通道(如果未设置 default-output-channel),并且默认情况下,如果未确定通道(或尝试发送不成功),则会抛出 MessageDeliveryException

但是,如果您确实想默默地丢弃消息,可以将 default-output-channel="nullChannel"

随着路由器参数的标准化和前面描述的参数的合并,旧的基于 Spring Integration 的应用程序可能会中断。

有关更多详细信息,请参阅 路由器

XML 模式更新到 2.1

Spring Integration 2.1 附带了更新的 XML 模式(2.1 版本)。 它提供了许多改进,例如前面 x2.1-router-standardization 路由器标准化。

从现在开始,开发人员必须始终声明最新的 XML 模式(当前为 2.1 版本)。 或者,他们可以使用无版本模式。 通常,最好的选择是使用无版本命名空间,因为它们会自动使用 Spring Integration 的最新可用版本。

以下示例声明了一个无版本的 Spring Integration 命名空间:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:int="http://www.springframework.org/schema/integration"
   xsi:schemaLocation="http://www.springframework.org/schema/integration
           https://www.springframework.org/schema/integration/spring-integration.xsd
           http://www.springframework.org/schema/beans
           https://www.springframework.org/schema/beans/spring-beans.xsd">
...
</beans>

以下示例声明了一个带有显式版本的 Spring Integration 命名空间:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:int="http://www.springframework.org/schema/integration"
   xsi:schemaLocation="http://www.springframework.org/schema/integration
           https://www.springframework.org/schema/integration/spring-integration-2.2.xsd
           http://www.springframework.org/schema/beans
           https://www.springframework.org/schema/beans/spring-beans.xsd">
...
</beans>

旧的 1.0 和 2.0 模式仍然存在。 但是,如果应用程序上下文仍然引用其中一个已弃用的模式,则验证器在初始化时会失败。

源代码管理和构建基础设施

2.1 版本对源代码管理和构建基础设施引入了许多更改。 本节涵盖了这些更改。

源代码现托管在 Github 上

自 2.0 版本以来,Spring Integration 项目使用 Git 进行版本控制。 为了进一步提高社区可见性,该项目已从 SpringSource 托管的 Git 存储库迁移到 Github。 Spring Integration Git 存储库位于:spring-integration

对于该项目,我们还改进了提供代码贡献的过程。 此外,我们确保每次提交都经过同行评审。 事实上,核心提交者现在遵循与贡献者相同的流程。 有关更多详细信息,请参阅 贡献

使用 Sonar 改进源代码可见性

为了提供更好的源代码可见性并因此监控 Spring Integration 源代码的质量,我们设置了一个 Sonar 实例。 我们每晚收集指标并将其发布到 sonar.spring.io

新示例

对于 Spring Integration 的 2.1 版本,我们还扩展了 Spring Integration Samples 项目,并添加了许多新示例,例如涵盖 AMQP 支持的示例、展示新负载增强器的示例、说明测试 Spring Integration 流片段技术的示例以及针对 Oracle 数据库执行存储过程的示例。 有关详细信息,请访问 spring-integration-samples