diff --git a/README.adoc b/README.adoc index cfda8826a..99feaabe6 100644 --- a/README.adoc +++ b/README.adoc @@ -134,10 +134,15 @@ Default: none (Spring AMQP default). === RabbitMQ Consumer Properties -NOTE: To avoid repetition, Spring Cloud Stream supports setting values for all channels, in the format of `spring.cloud.stream.default.=`. - The following properties are available for Rabbit consumers only and must be prefixed with `spring.cloud.stream.rabbit.bindings..consumer.`. +However if the same set of properties needs to be applied to most bindings, to +avoid repetition, Spring Cloud Stream supports setting values for all channels, +in the format of `spring.cloud.stream.rabbit.default.=`. + +Also, keep in mind that binding specific property will override its equivalent in the default. + + acknowledgeMode:: The acknowledge mode. + @@ -392,13 +397,23 @@ To set listener container properties that are not exposed as binder or binding p The binder and binding properties will be set and then the customizer will be called. The customizer (`configure()` method) is provided with the queue name as well as the consumer group as arguments. +[[rabbit-receiving-batch]] +=== Receiving Batched Messages + +Normally, if a producer binding has `batch-enabled=true` (see <>), or a message is created by a `BatchingRabbitTemplate`, elements of the batch are returned as individual calls to the listener method. +Starting with version 3.0, any such batch can be presented as a `List` to the listener method if `spring.cloud.stream.binding..consumer.batch-mode` is set to `true`. + +[[rabbit-prod-props]] === Rabbit Producer Properties -NOTE: To avoid repetition, Spring Cloud Stream supports setting values for all channels, in the format of `spring.cloud.stream.default.=`. +The following properties are available for Rabbit producers only and must be prefixed with `spring.cloud.stream.rabbit.bindings..producer.`. +However if the same set of properties needs to be applied to most bindings, to +avoid repetition, Spring Cloud Stream supports setting values for all channels, +in the format of `spring.cloud.stream.rabbit.default.=`. + +Also, keep in mind that binding specific property will override its equivalent in the default. -The following properties are available for Rabbit producers only and -must be prefixed with `spring.cloud.stream.rabbit.bindings..producer.`. autoBindDlq:: Whether to automatically declare the DLQ and bind it to the binder DLX. @@ -408,6 +423,7 @@ batchingEnabled:: Whether to enable message batching by producers. Messages are batched into one message according to the following properties (described in the next three entries in this list): 'batchSize', `batchBufferLimit`, and `batchTimeout`. See https://docs.spring.io/spring-amqp//reference/html/_reference.html#template-batching[Batching] for more information. +Also see <>. + Default: `false`. batchSize::