RabbitMQ 生产者属性

以下属性仅适用于 Rabbit 生产者,并且必须以 spring.cloud.stream.rabbit.bindings.<channelName>.producer. 为前缀。

然而,如果大多数绑定需要应用相同的属性集,为了避免重复,Spring Cloud Stream 支持为所有通道设置值,格式为 spring.cloud.stream.rabbit.default.<property>=<value>

另外,请记住,绑定特定的属性将覆盖其在默认设置中的等效属性。

altermateExchange.binding.queue

如果交换机尚不存在,并且提供了 name,则将此队列绑定到备用交换机。提供一个没有参数的简单持久队列;如果需要更复杂的配置,您必须自己配置并绑定队列。

默认值:null alternateExchange.binding.routingKey 如果交换机尚不存在,并且提供了 namequeue,则使用此路由键将队列绑定到备用交换机。 默认值:#(对于默认的 topic 备用交换机)

alternateExchange.exists

备用交换机是否存在,或者是否需要进行配置。

默认值:false

alternateExchange.type

如果备用交换机尚不存在,则配置的交换机类型。

默认值:topic

alternateExchange.name

在目标交换机上配置备用交换机。

默认值:null

autoBindDlq

是否自动声明 DLQ 并将其绑定到绑定器 DLX。

默认值:false

batchingEnabled

是否启用生产者消息批处理。消息根据以下属性(本列表后三项所述)进行批处理:batchSizebatchBufferLimitbatchTimeout。有关更多信息,请参阅 批处理。另请参阅 接收批处理消息

默认值:false

batchSize

启用批处理时要缓冲的消息数量。

默认值:100

batchBufferLimit

启用批处理时最大缓冲区大小。

默认值:10000

batchTimeout

启用批处理时的批处理超时。

默认值:5000

bindingRoutingKey

用于将队列绑定到交换机的路由键(如果 bindQueuetrue)。可以是多个键 - 请参阅 bindingRoutingKeyDelimiter。对于分区目的地,-n 会附加到每个键。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:#

bindingRoutingKeyDelimiter

当此值不为 null 时,bindingRoutingKey 被视为由该值分隔的键列表;通常使用逗号。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:null

bindQueue

是否声明队列并将其绑定到目标交换机。如果您已设置自己的基础设施并已预先创建并绑定队列,请将其设置为 false。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:true

compress

发送时是否应压缩数据。

默认值:false

confirmAckChannel

errorChannelEnabled 为 true 时,用于发送肯定交付确认(即发布者确认)的通道。如果通道不存在,则会注册一个名为此名称的 DirectChannel。连接工厂必须配置为启用发布者确认。与 useConfirmHeader 互斥。

默认值:nullChannel(确认被丢弃)。

deadLetterQueueName

DLQ 的名称 仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:prefix+destination.dlq

deadLetterExchange

分配给队列的 DLX。仅当 autoBindDlqtrue 时相关。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:prefix+DLX

deadLetterExchangeType

分配给队列的 DLX 类型。仅当 autoBindDlqtrue 时相关。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:direct

deadLetterRoutingKey

分配给队列的死信路由键。仅当 autoBindDlqtrue 时相关。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:destination

declareDlx

是否为目的地声明死信交换机。仅当 autoBindDlqtrue 时相关。如果您有一个预配置的 DLX,请将其设置为 false。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:true

declareExchange

是否为目的地声明交换机。

默认值:true

delayExpression

一个 SpEL 表达式,用于评估要应用于消息的延迟(x-delay 头部)。如果交换机不是延迟消息交换机,则无效。

默认值:未设置 x-delay 头部。

delayedExchange

是否将交换机声明为 Delayed Message Exchange。需要在代理上安装延迟消息交换机插件。x-delayed-type 参数设置为 exchangeType

默认值:false

deliveryMode

投递模式。

默认值:PERSISTENT

dlqBindingArguments

绑定 dlq 到死信交换机时应用的参数;与 headers deadLetterExchangeType 结合使用,以指定要匹配的头部。例如 …​dlqBindingArguments.x-match=any…​dlqBindingArguments.someHeader=someValue。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:空

dlqDeadLetterExchange

当声明 DLQ 时,分配给该队列的 DLX。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:none

dlqDeadLetterRoutingKey

当声明 DLQ 时,分配给该队列的死信路由键。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:none

dlqExpires

未使用的死信队列在多长时间(以毫秒为单位)后被删除。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no expiration

dlqLazy

使用 x-queue-mode=lazy 参数声明死信队列。请参阅 “Lazy Queues”。考虑使用策略而不是此设置,因为使用策略允许在不删除队列的情况下更改设置。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

dlqMaxLength

死信队列中的最大消息数量。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

dlqMaxLengthBytes

死信队列中所有消息的最大总字节数。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

dlqMaxPriority

死信队列中消息的最大优先级(0-255) 仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:none

dlqQuorum.deliveryLimit

quorum.enabled=true 时,设置一个交付限制,在此限制之后消息将被丢弃或死信。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:无 - 将应用代理默认值。

dlqQuorum.enabled

当为 true 时,创建仲裁死信队列而不是经典队列。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false

dlqQuorum.initialGroupSize

quorum.enabled=true 时,设置初始仲裁大小。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:无 - 将应用代理默认值。

dlqSingleActiveConsumer

设置为 true 以将 x-single-active-consumer 队列属性设置为 true。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false

dlqTtl

声明死信队列时要应用于死信队列的默认存活时间(以毫秒为单位)。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

exchangeAutoDelete

如果 declareExchangetrue,交换机是否应自动删除(在最后一个队列被删除后被移除)。

默认值:true

exchangeDurable

如果 declareExchangetrue,交换机是否应持久(在代理重启后仍然存在)。

默认值:true

exchangeType

交换机类型:directfanoutheaderstopic 用于非分区目的地;directheaderstopic 用于分区目的地。

默认值:topic

expires

未使用的队列在多长时间(以毫秒为单位)后被删除。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no expiration

headerPatterns

要映射到出站消息的头部模式。

默认值:['*'](所有头部)。

lazy

使用 x-queue-mode=lazy 参数声明队列。请参阅 “Lazy Queues”。考虑使用策略而不是此设置,因为使用策略允许在不删除队列的情况下更改设置。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false

maxLength

队列中的最大消息数量。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

maxLengthBytes

队列中所有消息的最大总字节数。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

maxPriority

队列中消息的最大优先级(0-255)。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:none

prefix

要添加到 destination 交换机名称的前缀。

默认值:""。

producerType

生产者类型。

  • AMQP 用于经典和仲裁队列的 AMQP 客户端

  • STREAM_SYNC RabbitMQ Streams 插件客户端,阻塞直到收到确认

  • STREAM_ASYNC RabbitMQ Streams 插件客户端,不阻塞默认值:""。

queueBindingArguments

绑定队列到交换机时应用的参数;与 headers exchangeType 结合使用,以指定要匹配的头部。例如 …​queueBindingArguments.x-match=any…​queueBindingArguments.someHeader=someValue。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:空

queueNameGroupOnly

当为 true 时,从名称等于 group 的队列中消费。否则,队列名称为 destination.group。这对于例如使用 Spring Cloud Stream 从现有 RabbitMQ 队列消费非常有用。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false。

quorum.deliveryLimit

quorum.enabled=true 时,设置一个交付限制,在此限制之后消息将被丢弃或死信。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:无 - 将应用代理默认值。

quorum.enabled

当为 true 时,创建仲裁队列而不是经典队列。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false

quorum.initialGroupSize

quorum.enabled=true 时,设置初始仲裁大小。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:无 - 将应用代理默认值。

routingKeyExpression

一个 SpEL 表达式,用于确定发布消息时使用的路由键。对于固定路由键,请使用 routingKey

默认值:destinationdestination-<partition> 用于分区目的地。

routingKey

一个字符串,定义发布消息时使用的固定路由键。

默认值:请参阅 routingKeyExpression

singleActiveConsumer

设置为 true 以将 x-single-active-consumer 队列属性设置为 true。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:false

transacted

是否使用事务通道。

默认值:false

ttl

声明队列时要应用于队列的默认存活时间(以毫秒为单位)。仅当提供了 requiredGroups 时才适用,并且仅适用于这些组。

默认值:no limit

useConfirmHeader

请参阅 发布者确认。与 confirmAckChannel 互斥。

在 RabbitMQ 的情况下,内容类型头部可以由外部应用程序设置。Spring Cloud Stream 支持它们作为扩展内部协议的一部分,该协议用于任何类型的传输——包括那些不原生支持头部的传输,例如 Kafka(0.11 之前)。