|
对于最新的稳定版本，请使用 Spring AMQP 3.2.0！ |
2.0 自 1.7 以来的变化
用CachingConnectionFactory
从版本 2.0.2 开始，您可以配置RabbitTemplate使用与 Listener 容器使用的连接不同的连接。
此更改可避免在生产者因任何原因被阻止时出现使用者死锁。
有关更多信息，请参阅使用单独的连接。
AMQP 客户端库
Spring AMQP 现在使用新的 5.0.x 版本的amqp-client库。
默认情况下，此客户端配置了自动恢复。
请参阅 RabbitMQ 自动连接/拓扑恢复。
从版本 4.0 开始，客户端默认启用自动恢复。
虽然与此功能兼容， Spring AMQP 有自己的恢复机制，通常不需要 Client 端恢复功能。
我们建议您禁用amqp-client自动恢复，以避免AutoRecoverConnectionNotCurrentlyOpenException代理可用但连接尚未恢复的实例。
从版本 1.7.1 开始， Spring AMQP 禁用它，除非你显式地创建自己的 RabbitMQ 连接工厂并将其提供给CachingConnectionFactory.
RabbitMQ 函数ConnectionFactory由RabbitConnectionFactoryBean默认情况下，也禁用了该选项。 |
一般更改
这ExchangeBuilder现在默认构建 Durable Exchange。
这@Exchange注解@QeueueBinding默认情况下，还会声明 Durable Exchange。
这@Queue注解@RabbitListener默认情况下，如果已命名，则声明 Durable 队列，如果匿名，则声明 Non-Durable。
有关更多信息，请参阅适用于队列和交换的 Builder API 和 注释驱动的侦听器终端节点。
已删除的类
UniquelyNameQueue不再提供。
创建具有唯一名称的持久非自动删除队列是不常见的。
此类已被删除。
如果您需要其功能，请使用new Queue(UUID.randomUUID().toString()).
新建侦听器容器
这DirectMessageListenerContainer已与现有的SimpleMessageListenerContainer.
有关选择要使用的容器以及如何配置它们的信息，请参阅选择容器和 Message Listener 容器配置。
Log4j 附加程序
由于 log4j 的生命周期结束，此 appender 不再可用。 有关可用日志附加程序的信息，请参见Logging Subsystem AMQP Appenders。
RabbitTemplate变化
以前，非事务性RabbitTemplate如果现有事务在事务侦听器容器线程上运行，则参与该事务。
这是一个严重的错误。
但是，用户可能依赖于此行为。
从版本 1.6.2 开始，您必须将channelTransactedboolean 值，以便它参与容器事务。 |
这RabbitTemplate现在使用DirectReplyToMessageListenerContainer（默认情况下），而不是为每个请求创建一个新的使用者。
有关更多信息，请参阅 RabbitMQ Direct 回复。
这AsyncRabbitTemplate现在支持 Direct Reply-To。
有关更多信息，请参阅 Async Rabbit Template 。
这RabbitTemplate和AsyncRabbitTemplate现在有receiveAndConvert和convertSendAndReceiveAsType采用ParameterizedTypeReference<T>参数，让调用方指定要将结果转换为的类型。
这对于复杂类型或当类型信息未在消息头中传达时特别有用。
它需要一个SmartMessageConverter例如Jackson2JsonMessageConverter.
请参见请求/答复消息、异步 Rabbit 模板、从Message跟RabbitTemplate和 [json-complex] 了解更多信息。
您现在可以使用RabbitTemplate在专用频道上执行多项作。
有关更多信息，请参阅 Scoped Operations 。
侦听器适配器
一个方便的FunctionalInterface可用于将 lambda 与MessageListenerAdapter.
看MessageListenerAdapter了解更多信息。
侦听器容器更改
预取默认值
prefetch 默认值以前为 1，这可能导致高效消费者的利用率不足。 默认预取值现在是 250，在大多数常见情况下，这应该会让使用者忙碌起来，并且， 因此，可以提高吞吐量。
| 在某些情况下，prefetch 值应 低 — 例如，对于大型消息，尤其是在处理速度较慢的情况下（消息可能会累积 添加到客户端进程中的大量内存），并且如果需要严格的消息排序 （在这种情况下，prefetch 值应设置回 1）。 此外，对于低容量消息收发和多个使用者（包括单个侦听器容器实例中的并发），您可能希望减少预取，以便在使用者之间更均匀地分配消息。 |
有关预取的更多背景信息，请参阅这篇关于 RabbitMQ 中的使用者利用率的博文和这篇关于排队理论的博文。
消息计数
以前MessageProperties.getMessageCount()返回0对于容器发出的消息。
此属性仅在您使用basicGet（例如，从RabbitTemplate.receive()方法），现在初始化为null对于容器消息。
事务回滚行为
事务回滚时的消息重新排队现在是一致的，无论是否配置了事务管理器。 有关更多信息，请参阅 回滚已接收消息的说明 。
关闭行为
如果容器线程在shutdownTimeout，则默认情况下会强制关闭通道。
有关更多信息，请参阅 Message Listener Container Configuration （消息侦听器容器配置）。
连接工厂更改
connection 和 channel listener 接口现在提供了一种获取有关异常信息的机制。 有关更多信息，请参阅连接和通道侦听器和发布是异步的 — 如何检测成功和失败。
新的ConnectionNameStrategy现在提供，以从AbstractConnectionFactory.
有关更多信息，请参阅连接和资源管理。
重试更改
这MissingMessageIdAdvice不再提供。
它的功能现在是内置的。
有关更多信息，请参阅同步作失败和重试选项。
匿名队列命名
默认情况下，AnonymousQueues现在使用默认的Base64UrlNamingStrategy而不是简单的UUID字符串。
看AnonymousQueue了解更多信息。
@RabbitListener变化
您现在可以在@RabbitListener附注。
有关更多信息，请参阅 Annotation-driven Listener Endpoints 。
您现在可以配置@RabbitListener注解，以便将任何异常返回给发送者。
您还可以配置RabbitListenerErrorHandler处理异常。
有关更多信息，请参阅处理异常。
现在，当您使用@QueueBinding注解。
也@QueueBinding.exchange()现在支持自定义 Exchange 类型，并默认声明 Durable Exchange。
您现在可以设置concurrency的 Listener 容器，而不必为不同的并发设置配置不同的容器工厂。
您现在可以设置autoStartupListener 容器的属性，覆盖容器工厂中的默认设置。
您现在可以设置接收之后和发送（回复）之前MessagePostProcessor实例中的RabbitListener容器工厂。
有关更多信息，请参阅 Annotation-driven Listener Endpoints 。
从版本 2.0.3 开始，@RabbitHandler类级别的注释@RabbitListener可以指定为默认值。
有关更多信息，请参阅 Multi-method Listeners 。
容器条件回滚
当使用外部事务管理器（例如 JDBC）时，当您为容器提供事务属性时，现在支持基于规则的回滚。 现在，当您使用交易通知时，它也更加灵活。 有关更多信息，请参阅条件回滚。
删除 Jackson 1.x 支持
在以前的版本中已废弃，Jackson1.x转换器和相关组件现已删除。
您可以使用基于 Jackson 2.x 的类似组件。
有关更多信息，请参阅 JSON 消息转换器。
JSON 消息转换器
当TypeId设置为Hashtable对于入站 JSON 消息，默认转换类型现在为LinkedHashMap.
以前，它是Hashtable.
要恢复到Hashtable，您可以使用setDefaultMapType在DefaultClassMapper.
XML 解析器
解析时Queue和ExchangeXML 组件，解析器不再注册nameattribute 值作为 Bean 别名，如果id属性。
看关于id和name属性了解更多信息。
阻止的连接
您现在可以将com.rabbitmq.client.BlockedListener到org.springframework.amqp.rabbit.connection.Connection对象。
此外，ConnectionBlockedEvent和ConnectionUnblockedEvent事件由ConnectionFactory当连接被 Broker 阻止或取消阻止时。
有关更多信息，请参阅连接和资源管理。