Changes Between 2.2 and 3.0

现在，HTTP 模块为入境终结点提供了强大的请求映射支持。我们将 UriPathHandlerMapping 类替换为 IntegrationRequestMappingHandlerMapping，该类在应用程序上下文中以 integrationRequestMappingHandlerMapping 的 Bean 名称注册。在解析 HTTP 入境终结点时，一个新的 IntegrationRequestMappingHandlerMapping Bean 也会被注册，或者一个现有的 Bean 会被复用。要实现灵活的请求映射配置，Spring Integration 为 <http:inbound-channel-adapter/> 和 <http:inbound-gateway/> 提供了 <request-mapping/> 子元素。现在，两个 HTTP 入境终结点都完全基于 Spring MVC 3.1 中引入的请求映射基础设施。例如，单个入境终结点上支持多条路径。有关更多信息，请参阅 HTTP Namespace Support。

我们添加了一个新的 IntegrationEvaluationContextFactoryBean 来允许配置自定义 PropertyAccessor 实现以及函数，以便在整个框架中的 SpEL 表达式中使用。有关更多信息，请参阅 Spring Expression Language (SpEL)。

为了使用静态`Method`函数来自定义 SpEL EvaluationContext，我们引入了`<spel-function/>`组件。我们还添加了两个内置函数：#jsonPath`和#xpath`。有关更多信息，请参阅SpEL Functions。

为了使用`PropertyAccessor`实现来自定义 SpEL EvaluationContext，我们添加了`<spel-property-accessors/>`组件。有关更多信息，请参阅Property Accessors。

我们添加了一个新的基于 Redis 的 MetadataStore实现。您可以使用`RedisMetadataStore`来维护`MetadataStore`在应用程序重新启动期间的状态。此新的`MetadataStore`实现可以与适配器一起使用，例如：

我们添加了新的基于队列的组件。我们添加了 <int-redis:queue-inbound-channel-adapter/> 和 <int-redis:queue-outbound-channel-adapter/> 组件，用于分别对 Redis list 执行“右弹”和“左推”操作。

有关更多信息，“see Redis Support”。

您现在可以指示框架将答复通道和错误通道存储在注册表中以供以后解析。对于可能会丢失`replyChannel`或`errorChannel`的情况（例如，在序列化消息时），这非常有用。有关更多信息，请参阅Header Enricher。

除了现有的 eMongoDbMessageStore 之外，我们还引入了新的 ConfigurableMongoDbMessageStore。这为 MongoDB 提供了一个更强大、更灵活的 MessageStore 实现。它与现有存储不向后兼容，但我们建议将其用于新应用程序。现有应用程序可以使用它，但旧存储中的消息不可用。有关更多信息，请参阅 MongoDb Support。

在 2.2 SyslogToMapTransformer 的基础上，Spring Integration 3.0 引入了 UDP 和 TCP 入站通道适配器，这些适配器专为接收 SYSLOG 消息而特别定制。有关更多信息，请参阅 Syslog Support。

我们添加了文件入站通道适配器，这些适配器使用`tail`命令在文本文件末尾添加行时生成消息。请参阅'tail’ing Files。

我们添加了 <int-jmx:tree-polling-channel-adapter/>。此适配器查询 JMX MBean 树，并发送一条消息，其有效负载是与查询匹配的对象图。默认情况下，MBean 被映射到原语和简单对象（例如 Map、List 和数组）。例如，它允许简单地转换为 JSON。

IntegrationMBeanExporter 现在允许通过 naming-strategy 属性配置自定义 ObjectNamingStrategy。

有关更多信息，请参阅 JMX Support。

当连接打开或关闭，或发生异常时，TcpConnection 实例现在会发出 ApplicationEvent 实例（特别是 TcpConnectionEvent 实例）。此更改使应用程序能够使用正常的 Spring ApplicationListener 机制了解 TCP 连接的变更。

我们已将 AbstractTcpConnection 重命名为 TcpConnectionSupport。此类的子类自定义连接可以使用其方法发布事件。类似地，我们已将 AbstractTcpConnectionInterceptor 重命名为 TcpConnectionInterceptorSupport。

此外，我们还添加了 <int-ip:tcp-connection-event-inbound-channel-adapter/>。默认情况下，此适配器将所有 TcpConnectionEvent 实例发送到 Channel。

此外，TCP 连接工厂现在提供了一个名为 getOpenConnectionIds() 的新方法，该方法返回一个列表，其中包含所有打开连接的标识符。它可以让应用程序广播到所有打开的连接，还有其他用途。

最后，连接工厂还提供了一个名为 closeConnection(String connectionId) 的新方法，该方法可以让应用程序通过其 ID 显式关闭连接。

有关更多信息，请参阅TCP Connection Events。

<int:inbound-channel-adapter/>`现在支持使用<expression/>`和`<script/>`子元素来创建一个`MessageSource`。请参阅Channel Adapter Expressions and Scripts。

内容充实器现在为`<header/>`子元素提供配置，以使用来自底层消息流的答复消息中的标头来充实出站消息。有关更多信息，请参阅Payload Enricher。

以前，消息 ID 是使用 JDK `UUID.randomUUID()`方法生成的。在此版本中，默认机制已更改为使用更高效、显著更快的算法。此外，我们还添加了更改用于生成消息 ID 的策略的功能。有关更多信息，请参阅Message ID Generation。

您现在可以为所有网关方法设置通用标题，我们还添加了更多选项，以便在消息中添加有关调用哪个方法的信息。

您现在可以完全定制以何种方式将网关方法调用映射到消息。

GatewayMethodMetadata 现在是公共类。它让您能够从 Java 中以编程方式配置 GatewayProxyFactoryBean。

有关更多信息，请参阅 Messaging Gateways。

有关更多信息，请参阅 HTTP Support。

有关更多信息，请参阅 “JSON Transformers” 中的 Transformer。

以前，<chain> 中元素的 id 属性被忽略，并且在某些情况下不允许。现在，id 属性允许用于 <chain> 中的所有元素。链元素的 bean 名称是周围链的 id 和元素自身的 id 的组合。例如：'myChain$child.myTransformer.handler'。有关更多信息，请参阅 Message Handler Chain。

`AbstractCorrelatingMessageHandler`提供了一个名为`empty-group-min-timeout`的新属性，允许空组到期以比部分组到期更长的计划来运行。直到至少过了此毫秒数才修改空组，否则它们不会从`MessageStore`中删除。有关更多信息，请参阅Configuring an Aggregator with XML。

现在可以使用新的 FileListFilter 实现，这些实现使用持久 MetadataStore。可以在系统重新启动后使用这些实现来防止重复的文件。有关更多信息，请参阅 Reading Files、FTP Inbound Channel Adapter 和 SFTP Inbound Channel Adapter。

我们为脚本组件引入了一个新的 variables 属性。此外，现在允许将变量绑定用于内联脚本。有关更多信息，请参阅 Groovy support 和 Scripting Support。

以前，在通道的 dispatcher 子元素上配置 LoadBalancingStrategy 时，唯一可用的选项是使用预定义的值枚举，这让开发者无法设置 LoadBalancingStrategy 的自定义实现。您现在可以使用 load-balancer-ref 提供 LoadBalancingStrategy 的自定义实现的引用。有关详细信息，请参阅 xref:channel/implementations.adoc#channel-implementations-directchannel[DirectChannel。

以前，发送到没有任何订阅者的 <publish-subscribe-channel/> 会返回 false 结果。如果与 MessagingTemplate 结合使用，这会导致抛出异常。现在，PublishSubscribeChannel 有一个称为 minSubscribers（默认值：0）的属性。如果消息发送到至少最小数量的订阅者，则发送操作被认为是成功的（即使该数量为零）。如果应用程序希望在这种情况下收到异常，请将最小订阅者设置为至少 1。

默认情况下，FTP、SFTP 和 FTPS 终结点不再缓存会话。

我们从所有终结点中删除了已弃用的 cached-sessions 属性。以前，此属性的值控制的嵌入式缓存机制无法限制高速缓存的大小，高速缓存可能会无限增长。版本 2.1 引入了 CachingConnectionFactory，它已成为缓存会话的首选方式（现在也是唯一方式）。

现在，CachingConnectionFactory 提供了一种新方法：resetCache()。此方法立即关闭空闲会话并导致正在使用的会话在返回到缓存时关闭。

DefaultSftpSessionFactory（与 CachingSessionFactory 结合使用）现在支持通过单个 SSH 连接多路复用通道（仅限 SFTP）。

所有出站网关（如 <jdbc:outbound-gateway/> 或 <jms:outbound-gateway/>）都设计用于“请求-答复”场景。外部服务应该有答复并将其发布到 reply-channel 或 replyChannel 消息头。不过，在某些情况下外部系统可能不总是返回结果（例如，在 SELECT 以空 ResultSet 结束时的 <jdbc:outbound-gateway/> 或者单向 web 服务）。因此，开发人员需要一种选项来配置是否需要答复。为此，我们为出站网关组件引入了 requires-reply 特性。在大多数情况下，requires-reply 的默认值为 true。如果没有结果，将抛出 ReplyRequiredException。将该值更改为 false 意味着，如果外部服务不返回任何内容，消息流将在那一刻结束，类似于出站通道适配器。

请注意，以前曾存在 requiresReply 特性，但在 AbstractReplyProducingMessageHandler 中设置为 false，并且没有办法使用 XML 命名空间为出站网关对其进行配置。

以前，<int-amqp:outbound-gateway/> 在调用消息转换器之前映射头，并且转换器可以覆盖头，例如 content-type。出站适配器在转换之后映射头，这意味着使用来自出站 Message 的 content-type 之类的头（如果存在）。

从这个版本开始，网关现在在消息转换后映射头，这与适配器一致。如果您的应用程序依赖于之前的行为（其中转换器的头覆盖映射的头），则需要过滤那些头（在消息到达网关之前）或适当地设置它们。受 SimpleMessageConverter 影响的头是 content-type 和 content-encoding。自定义消息转换器可能设置其他头。

对于标准 CallableStatement.getObject 方法不支持的更复杂的特定于数据库的类型，我们在具有 OUT 方向的 <sql-parameter-definition/> 元素中引入了两个新的附加特性：

存储过程入站通道适配器 <returning-resultset/> 子元素的 row-mapper 特性现在支持对 RowMapper bean 定义的引用。以前，它只包含一个类名（仍然支持）。

有关更多信息，请参阅 Stored Procedures。

Web 服务出站网关“uri”属性现在支持 Spring Web 服务支持的所有 URI 方案的`<uri-variable/>`替换。有关更多信息，请参阅Outbound URI Configuration。

Redis 入站通道适配器现在可以使用“null”值作为“serializer”属性，原始数据作为消息有效负载。

Redis 出站通道适配器现在具有“topic-expression”属性，用于在运行时确定“Message”的 Redis 主题。

Redis 入站通道适配器还具有“topic-patterns”属性，除了现有的“topics”属性外。

有关更多信息，请参阅 Redis Support。

以前，当 <filter/> 具有 <request-handler-advice-chain/> 时，放弃操作都在建议链范围内执行（包括 discard-channel 中的任何下游流）。过滤器元素现在具有一个名为 discard-within-advice 的属性（默认值：true），以允许在建议链完成后执行丢弃操作。请参阅 Advising Filters。

请求处理程序建议链现在可以通过注释进行配置。请参阅 Advising Endpoints Using Annotations。

此转换器现在可以正确地将 byte[] 和 char[] 有效负载转换为 String。如需了解更多信息，请参阅 Transformer。

要持久保留或合并的有效负载现在可以为 java.lang.Iterable 类型。

在这种情况下，由“Iterable”返回的每个对象都被视为一个实体，并使用底层的“EntityManager”进行持久化或合并。迭代器返回的空值将被忽略。

在执行持久化操作后，JPA 适配器现在具有附加属性，可以从关联的持久化上下文中选择性地刷新和清除实体。

检索网关没有机制来指定要检索的第一条记录，这是一个常见的用例。检索网关现在支持通过将`first-result`和`first-result-expression`属性添加到网关定义来指定此参数。有关更多信息，请参阅Retrieving Outbound Gateway。

JPA 检索网关和入站适配器现在具有一个属性，可以将结果集中的最大结果数指定为表达式。此外，我们引入了“max-results”属性来替换已被弃用的“max-number-of-results”。“max-results”和“max-results-expression”用于分别提供结果集中的最大结果数或计算最大结果数的表达式。

如需了解更多信息，请参阅 JPA Support。

以前，<delayer> 提供了一个 delay-header-name 属性来在运行时确定延迟值。在复杂的情况下，<delayer> 之前必须使用 <header-enricher>。Spring Integration 3.0 引入了 expression 属性和 expression 子元素，用于动态延迟确定。delay-header-name 属性现已弃用，因为您可以指定 expression 中的标头评估。此外，我们还引入了 ignore-expression-failures 来控制表达式评估失败时的行为。如需了解更多信息，请参阅 Delayer。

Spring Integration 3.0 添加了一组针对 MySQL 版本 5.6.4 及更高版本的 DDL 脚本。现在 MySQL 支持小数秒，因此在从基于 MySQL 的消息存储进行轮询时可以改善 FIFO 顺序。有关更多信息，请参阅The Generic JDBC Message Store。

先前，如果 IMAP 空闲连接失败，则会记录下来，但没有机制通知应用程序。此类异常现在会生成`ApplicationEvent`实例。应用程序可以使用 <int-event:inbound-channel-adapter> 或配置为接收`ImapIdleExceptionEvent`（或其超类之一）的任何`ApplicationListener`来获取这些事件。

现在，TCP 连接工厂能够配置灵活的机制，通过 TCP 传输所选头（以及有效负载）。新的 TcpMessageMapper 能够选择标头，您需要配置适当的序列化器或反序列化器，将结果 Map 写入到 TCP 流。我们添加了 MapJsonSerializer 作为一个便利机制，以便通过 TCP 传输头和有效负载。更多信息，请参阅 Transferring Headers。

以前，在配置 <message-driven-channel-adapter/> 时，如果你想使用一个特定 TaskExecutor，你需要声明一个容器 Bean，并通过设置 container 属性，将其提供给适配器。我们添加了 task-executor，使其可以直接在适配器上进行设置。这除了已经具有的一些其他容器属性之外。

您现在可以通过设置 transformer-factory-class 属性指定转换器工厂类名称。请参阅 XsltPayloadTransformer。