2.2 和 3.0 之间的变化

HTTP 模块现在为入站终端节点提供强大的请求映射支持。 我们将类替换为 ，它在应用程序上下文中的 bean 名称下注册。 在解析 HTTP 入站端点时，要么注册一个新的 Bean，要么重用现有的 Bean。 为了实现灵活的请求映射配置， Spring 集成提供了 的子元素 和 . 现在，两个 HTTP 入站端点都完全基于 Spring MVC 3.1 中引入的请求映射基础设施。 例如，单个入站终端节点支持多个路径。 有关更多信息，请参阅 HTTP 命名空间支持。UriPathHandlerMappingIntegrationRequestMappingHandlerMappingintegrationRequestMappingHandlerMappingIntegrationRequestMappingHandlerMapping<request-mapping/><http:inbound-channel-adapter/><http:inbound-gateway/>spring-doc.cn

我们添加了一个新的允许配置自定义实现和函数，以便在整个框架中的 SPEL 表达式中使用。 有关更多信息，请参阅 Spring 表达式语言 （SpEL）。IntegrationEvaluationContextFactoryBeanPropertyAccessorspring-doc.cn

为了使用静态函数自定义 SPEL，我们引入了该组件。 我们还添加了两个内置函数：和 . 有关更多信息，请参阅 SPEL 函数。EvaluationContextMethod<spel-function/>#jsonPath#xpathspring-doc.cn

为了使用实现自定义 SPEL，我们添加了组件。 有关详细信息，请参阅 属性访问器。EvaluationContextPropertyAccessor<spel-property-accessors/>spring-doc.cn

我们添加了一个新的基于 Redis 的 MetadataStore 实现。 您可以使用 来维护跨应用程序重启的状态。 此新实现可与适配器一起使用，例如：RedisMetadataStoreMetadataStoreMetadataStorespring-doc.cn

我们添加了新的基于队列的组件。 我们添加了 and 组件，以分别在 Redis List 上执行 'right pop' 和 'left push' 操作。<int-redis:queue-inbound-channel-adapter/><int-redis:queue-outbound-channel-adapter/>spring-doc.cn

有关更多信息，请参阅“Redis 支持”。spring-doc.cn

现在，您可以指示框架将回复通道和错误通道存储在注册表中，以便以后解决。 这对于 or 可能丢失的情况（例如，在序列化消息时）非常有用。 有关更多信息，请参阅 Header Enricher 。replyChannelerrorChannelspring-doc.cn

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

在 2.2 的基础上，Spring Integration 3.0 引入了专为接收 SYSLOG 消息而定制的入站通道适配器。 有关更多信息，请参阅 Syslog 支持。SyslogToMapTransformerUDPTCPspring-doc.cn

我们添加了文件入站通道适配器，当将行添加到文本文件的末尾时，这些适配器使用命令生成消息。 请参见 'tail'ing 文件。tailspring-doc.cn

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

现在允许使用 属性 配置自定义。IntegrationMBeanExporterObjectNamingStrategynaming-strategyspring-doc.cn

有关更多信息，请参阅 JMX 支持。spring-doc.cn

TcpConnection现在，当打开或关闭连接或发生异常时，实例会发出实例（特别是实例）。 此更改允许应用程序使用常规的 Spring 机制通知 TCP 连接的更改。ApplicationEventTcpConnectionEventApplicationListenerspring-doc.cn

我们重命名为 . 作为此类的子类的自定义连接可以使用其方法来发布事件。 同样，我们将 .AbstractTcpConnectionTcpConnectionSupportAbstractTcpConnectionInterceptorTcpConnectionInterceptorSupportspring-doc.cn

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

此外，TCP 连接工厂现在提供了一个名为 的新方法，该方法返回所有打开的连接的标识符列表。 它允许应用程序广播到所有打开的连接，以及其他用途。getOpenConnectionIds()spring-doc.cn

最后，连接工厂还提供了一个名为 的新方法，它允许应用程序使用其 ID 显式关闭连接。closeConnection(String connectionId)spring-doc.cn

有关更多信息，请参阅 TCP 连接事件。spring-doc.cn

现在支持 using 和 child 元素来创建 . 请参阅通道适配器表达式和脚本。<int:inbound-channel-adapter/><expression/><script/>MessageSourcespring-doc.cn

内容扩充器现在为子元素提供配置，以根据来自底层消息流的回复消息使用标头来扩充出站消息。 有关更多信息，请参阅 Payload Enricher。<header/>spring-doc.cn

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

现在，您可以在所有网关方法中设置通用标头，并且我们添加了更多选项，用于向消息添加有关调用了哪个方法的信息。spring-doc.cn

现在，您可以完全自定义网关方法调用映射到消息的方式。spring-doc.cn

现在是 public 类。 它允许您以编程方式配置 from Java.GatewayMethodMetadataGatewayProxyFactoryBeanspring-doc.cn

有关更多信息，请参阅 Messaging Gateway。spring-doc.cn

有关更多信息，请参阅 HTTP 支持。spring-doc.cn

有关详细信息，请参阅 Transformer 中的“JSON 转换器”。spring-doc.cn

以前，a 中元素的属性被忽略，在某些情况下是不允许的。 现在，该属性允许用于 . 链元素的 bean 名称是周围链和元素本身的 的组合。 例如：'myChain$child.myTransformer.handler'。 有关更多信息，请参阅消息处理程序链。id<chain>id<chain>ididspring-doc.cn

它提供了一个新属性，该属性称为允许空组过期按比过期的部分组更长的计划运行。 空组不会从 中删除，直到它们至少在此毫秒数内未被修改。 有关更多信息，请参阅使用 XML 配置聚合器。AbstractCorrelatingMessageHandlerempty-group-min-timeoutMessageStorespring-doc.cn

使用持久化的新实现现已推出。 您可以使用这些来防止在系统重新启动后出现重复文件。 有关更多信息，请参阅读取文件、FTP 入站通道适配器和 SFTP 入站通道适配器。FileListFilterMetadataStorespring-doc.cn

我们为脚本组件引入了一个新属性。 此外，现在允许内联脚本使用变量绑定。 有关更多信息，请参阅 Groovy 支持和脚本支持。variablesspring-doc.cn

以前，在通道的子元素上进行配置时，唯一可用的选项是使用预定义的值枚举，该枚举不允许开发人员设置自定义实现。 现在，您可以使用 来提供对 . 有关更多信息，请参阅 DirectChannel。LoadBalancingStrategydispatcherLoadBalancingStrategyload-balancer-refLoadBalancingStrategyspring-doc.cn

以前，发送到没有订阅者的 <publish-subscribe-channel/> 会返回结果。 如果与 a 结合使用，则会导致引发异常。 现在，它有一个名为 （default： ） 的属性。 如果消息至少发送给最小数量的订阅者，则 send 操作被视为成功（即使该数字为零）。 如果应用程序希望在这些情况下收到异常，请将最小订户数设置为至少 1。falseMessagingTemplatePublishSubscribeChannelminSubscribers0spring-doc.cn

默认情况下，FTP、SFTP 和 FTPS 终端节点不再缓存会话。spring-doc.cn

我们从所有端点中删除了 deprecated 属性。 以前，由此属性的值控制的嵌入式缓存机制不提供限制缓存大小的方法，缓存大小可以无限增长。 版本 2.1 引入了 ，它成为缓存会话的首选（现在是唯一的）方法。cached-sessionsCachingConnectionFactoryspring-doc.cn

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

现在，（与 一起）支持通过单个 SSH 连接（仅限 SFTP）进行多路复用通道。DefaultSftpSessionFactoryCachingSessionFactoryspring-doc.cn

所有出站网关（例如 or ）都是为“请求-回复”场景设计的。 响应应来自外部服务，并发布到 或 消息标头。 但是，在某些情况下，外部系统可能并不总是返回结果（例如， a 当 SELECT 以空或单向 Web 服务结尾时）。 因此，开发人员需要一个选项来配置是否需要回复。 为此，我们引入了出站网关组件的属性。 在大多数情况下，的默认值为 。 如果没有结果，则抛出 a。 将该值更改为意味着，如果外部服务未返回任何内容，则消息流将在该点结束，类似于出站通道适配器。<jdbc:outbound-gateway/><jms:outbound-gateway/>reply-channelreplyChannel<jdbc:outbound-gateway/>ResultSetrequires-replyrequires-replytrueReplyRequiredExceptionfalsespring-doc.cn

请注意，该属性以前存在，但在 中设置为 ，并且无法使用 XML 命名空间在出站网关上配置它。requiresReplyfalseAbstractReplyProducingMessageHandlerspring-doc.cn

以前，<int-amqp：outbound-gateway/> 在调用消息转换器之前映射了标头，并且转换器可以覆盖诸如 . 出站适配器在转换后映射 headers，这意味着使用来自 outbound （如果存在） 的 headers。content-typecontent-typeMessagespring-doc.cn

从此版本开始，网关现在在消息转换后映射标头，与适配器一致。 如果您的应用程序依赖于以前的行为（其中转换器的 Headers 覆盖了映射的 Headers），则需要筛选这些 Headers（在消息到达网关之前）或适当地设置它们。 受 are 和 影响的标头。 自定义消息转换器可以设置其他标头。SimpleMessageConvertercontent-typecontent-encodingspring-doc.cn

对于标准方法不支持的更复杂的数据库特定类型，我们使用 OUT-direction 为元素引入了两个新的附加属性：CallableStatement.getObject<sql-parameter-definition/>spring-doc.cn

存储过程入站通道适配器子元素的属性现在支持对 Bean 定义的引用。 以前，它仅包含类名（仍受支持）。row-mapper<returning-resultset/>RowMapperspring-doc.cn

有关详细信息，请参阅存储过程。spring-doc.cn

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

Redis 入站通道适配器现在可以使用属性的值，原始数据是消息负载。nullserializerspring-doc.cn

Redis 出站通道适配器现在具有用于确定运行时的 Redis 主题的属性。topic-expressionMessagespring-doc.cn

Redis 入站通道适配器除了 existing 属性外，现在还具有该属性。topicstopic-patternsspring-doc.cn

有关更多信息，请参阅 Redis 支持。spring-doc.cn

以前，当 a 具有 时，丢弃操作全部在通知链的范围内执行（包括 上的任何下游流）。 filter 元素现在具有一个名为 （default： ） 的属性，以允许在通知链完成后执行 discard 操作。 请参阅 Advice Filters。<filter/><request-handler-advice-chain/>discard-channeldiscard-within-advicetruespring-doc.cn

现在可以使用 annotation 配置请求处理程序通知链。 请参阅使用注释通知终端节点。spring-doc.cn

此转换器现在可以正确地转换和有效负载。 有关更多信息，请参阅 Transformer。byte[]char[]Stringspring-doc.cn

要保留或合并的有效负载现在可以是 类型。java.lang.Iterablespring-doc.cn

在这种情况下，返回的每个对象都被视为一个实体，并使用基础 . 迭代器返回的 Null 值将被忽略。IterableEntityManagerspring-doc.cn

JPA 适配器现在具有其他属性，可以在执行持久性操作后选择性地从关联的持久性上下文中刷新和清除实体。spring-doc.cn

检索网关没有指定要检索的第一条记录的机制，这是一种常见的使用案例。 检索网关现在支持通过向网关定义添加 and 属性来指定此参数。 有关更多信息，请参阅检索出站网关。first-resultfirst-result-expressionspring-doc.cn

JPA 检索网关和入站适配器现在具有一个属性，用于以表达式的形式指定结果集中的最大结果数。 此外，我们还引入了 replace 属性，该属性已弃用。 和 用于提供最大结果数，或用于分别计算结果集中的最大结果数的表达式。max-resultsmax-number-of-resultsmax-resultsmax-results-expressionspring-doc.cn

有关更多信息，请参阅 JPA 支持。spring-doc.cn

以前，它提供了一个属性来确定运行时的延迟值。 在复杂情况下，the 前面必须有 . Spring Integration 3.0 引入了用于动态延迟确定的属性和子元素。 该属性现已弃用，因为您可以在 . 此外，我们还引入了 来控制表达式计算失败时的行为。 有关更多信息，请参阅延迟器。<delayer>delay-header-name<delayer><header-enricher>expressionexpressiondelay-header-nameexpressionignore-expression-failuresspring-doc.cn

Spring 集成 3.0 为 MySQL 版本 5.6.4 及更高版本添加了一组新的 DDL 脚本。 现在 MySQL 支持小数秒，因此在从基于 MySQL 的消息存储轮询时改进了 FIFO 排序。 有关更多信息，请参阅通用 JDBC 消息存储。spring-doc.cn

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

TCP 连接工厂现在支持配置灵活的机制，以通过 TCP 传输选定的标头（以及有效负载）。 new 启用标头的选择，您需要配置适当的序列化程序或反序列化程序以将结果写入 TCP 流。 我们添加了一个方便的机制，用于通过 TCP 传输标头和有效负载。 有关更多信息，请参阅传输标头。TcpMessageMapperMapMapJsonSerializerspring-doc.cn

以前，在配置 时，如果您希望使用特定的 ，则必须声明一个容器 Bean 并通过设置属性将其提供给适配器。 我们添加了 ，让它直接在适配器上设置。 这是对其他几个已可用的容器属性的补充。<message-driven-channel-adapter/>TaskExecutorcontainertask-executorspring-doc.cn

现在，您可以通过设置属性来指定 transformer 工厂类名称。 看。transformer-factory-classXsltPayloadTransformerspring-doc.cn