This version is still in development and is not considered stable yet. For the latest stable version, please use Spring AMQP 3.2.0!spring-doc.cn

Changes in 3.0 Since 2.4

Java 17, Spring Framework 6.0

This version requires Spring Framework 6.0 and Java 17spring-doc.cn

Remoting

The remoting feature (using RMI) is no longer supported.spring-doc.cn

Observation

Enabling observation for timers and tracing using Micrometer is now supported. See Micrometer Observation for more information.spring-doc.cn

Native Images

Support for creating native images is provided. See Native Images for more information.spring-doc.cn

AsyncRabbitTemplate

The AsyncRabbitTemplate now returns CompletableFuture s instead of ListenableFuture s. See Async Rabbit Template for more information.

Stream Support Changes

RabbitStreamOperations and RabbitStreamTemplate methods now return CompletableFuture instead of ListenableFuture.

Super streams and single active consumers thereon are now supported.spring-doc.cn

@RabbitListener Changes

Batch listeners can now consume Collection<?> as well as List<?>. The batch messaging adapter now ensures that the method is suitable for consuming batches. When setting the container factory consumerBatchEnabled to true, the batchListener property is also set to true. See @RabbitListener with Batching for more information.spring-doc.cn

MessageConverter s can now return Optional.empty() for a null value; this is currently implemented by the Jackson2JsonMessageConverter. See Converting from a Message for more informationspring-doc.cn

You can now configure a ReplyPostProcessor via the container factory rather than via a property on @RabbitListener. See Reply Management for more information.spring-doc.cn

The @RabbitListener (and @RabbitHandler) methods can now be declared as Kotlin suspend functions. See Asynchronous @RabbitListener Return Types for more information.spring-doc.cn

Starting with version 3.0.5, listeners with async return types (including Kotlin suspend functions) invoke the RabbitListenerErrorHandler (if configured) after a failure. Previously, the error handler was only invoked with synchronous invocations.spring-doc.cn

Connection Factory Changes

The default addressShuffleMode in AbstractConnectionFactory is now RANDOM. This results in connecting to a random host when multiple addresses are provided. See Connecting to a Cluster for more information.spring-doc.cn

The LocalizedQueueConnectionFactory no longer uses the RabbitMQ http-client library to determine which node is the leader for a queue. See Queue Affinity and the LocalizedQueueConnectionFactory for more information.spring-doc.cn