|
此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 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和从Message跟RabbitTemplate了解更多信息。
您现在可以使用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 的类似组件。
看Jackson2JsonMessageConverter了解更多信息。
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 阻止或取消阻止时。
有关更多信息,请参阅连接和资源管理。