14.4. 端点选项


Azure ServiceBus 端点使用 URI 语法进行配置:

azure-servicebus:topicOrQueueName
Copy to Clipboard Toggle word wrap

使用以下路径和查询参数:

14.4.1. 路径参数(1 参数)

Expand
Name描述默认值类型

topicOrQueueName (common)

根据 serviceBusType 配置,所选主题名称或队列名称。例如,如果 serviceBusType=queue,这将是队列名称,如果 serviceBusType=topic,这将是主题名称。

 

字符串

14.4.2. 查询参数(25 参数)

Expand
Name描述默认值类型

amqpRetryOptions (common)

设置服务总线客户端的重试选项。如果没有指定,则使用默认重试选项。

 

AmqpRetryOptions

amqpTransportType (common)

设置所有与 Azure 服务总线通信的传输类型。默认值为 AmqpTransportType#AMQP。

Enum 值:

  • Amqp
  • AmqpWebSockets

AMQP

AmqpTransportType

clientOptions (common)

将 ClientOptions 设置为从此构建器构建的客户端发送,支持自定义某些属性,并支持添加自定义标头信息。如需更多信息,请参阅 ClientOptions 文档。

 

ClientOptions

proxyOptions (common)

设置用于 ServiceBusSenderAsyncClient 的代理配置。配置代理时,必须使用 AmqpTransportType"AMQP_WEB_SOCKETS 用于传输类型。

 

ProxyOptions

serviceBusType (common)

需要执行 的服务总线类型的连接。queue 用于典型的队列选项,以及用于基于订阅的模型的主题。

Enum 值:

  • queue
  • topic

queue

ServiceBusType

consumerOperation (consumer)

设置消费者中使用的所需操作。

Enum 值:

  • receiveMessages
  • peekMessages

receiveMessages

ServiceBusConsumerOperationDefinition

disableAutoComplete (consumer)

禁用已接收消息的自动完成和自动带。默认情况下,成功处理的消息为 \\{link ServiceBusReceiverAsyncClient Serialcomplete (ServiceBusReceivedMessage) completed}。如果在处理消息时出现错误,它是 \\{link ServiceBusReceiverAsyncClient Serialabandon (ServiceBusReceivedMessage) abandoned}。

false

布尔值

maxAutoLockRenewDuration (consumer)

设置自动续订锁定的时间长度。设置 Duration"ZERO 或 null 可禁用自动续订。对于 \\{link ServiceBusReceiveMode"RECEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,自动续订功能被禁用。

5m

Duration

peekNumMaxMessages (consumer)

在 peek 操作过程中,将最大消息数设置为 peeked。

 

整数

prefetchCount (consumer)

设置接收方的预抓取计数。对于 \\{link ServiceBusReceiveMode#PEEK_LOCK PEEK_LOCK} 和 \\{link ServiceBusReceiveMode#RECEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,默认值为 1。prefetch 通过一个信息来加快消息流,当应用程序请求使用 ServiceBusReceiverAsyncClient SerialreceiveMessages ()时,这个信息会被用于本地检索。设置非零值将预先获取该消息的数量。将值设为零可关闭预抓取。

 

int

receiverAsyncClient (consumer)

Autowired 设置 receiverAsyncClient,以便消费消息。

 

ServiceBusReceiverAsyncClient

serviceBusReceiveMode (consumer)

设置接收方的接收模式。

Enum 值:

  • PEEK_LOCK
  • RECEIVE_AND_DELETE

PEEK_LOCK

ServiceBusReceiveMode

subQueue (consumer)

设置要连接的 SubQueue 的类型。

Enum 值:

  • NONE
  • DEAD_LETTER_QUEUE
  • TRANSFER_DEAD_LETTER_QUEUE
 

SubQueue

subscriptionName (consumer)

将主题中的订阅名称设置为 listen to. topicOrQueueName 和 serviceBusType=topic。如果 serviceBusType=topic 和 consumer 正在使用,则需要此属性。

 

字符串

bridgeErrorHandler (consumer (advanced))

允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。

false

布尔值

exceptionHandler (consumer (advanced))

要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。

 

ExceptionHandler

exchangePattern (consumer (advanced))

在消费者创建交换时设置交换模式。

Enum 值:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

producerOperation (producer)

设置生成者中使用的所需操作。

Enum 值:

  • sendMessages
  • scheduleMessages

sendMessages

ServiceBusProducerOperationDefinition

scheduledEnqueueTime (producer)

设置 OffsetDateTime,其中消息应当出现在服务总线队列或主题中。

 

OffsetDateTime

senderAsyncClient (producer)

Autowired 设置要在生成者中使用的 SenderAsyncClient。

 

ServiceBusSenderAsyncClient

serviceBusTransactionContext (producer)

表示服务中的事务。此对象仅包含事务 ID。

 

ServiceBusTransactionContext

lazyStartProducer (producer (advanced))

生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。

false

布尔值

connectionString (security)

设置服务总线命名空间或特定服务总线资源的连接字符串。

 

字符串

fullyQualifiedNamespace (security)

服务总线的全限定命名空间。

 

字符串

tokenCredential (security)

用于 Azure AD 身份验证的 TokenCredential,在 com.azure.identity 中实施。

 

TokenCredential

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部