4.2. 将地址设置应用到一组地址
在 AMQ Broker 中,您可以使用通配符表达式来将 address-setting
元素中指定的配置应用到 一组 地址,来表示匹配的地址名称。
以下小节介绍了如何使用通配符表达式。
4.2.1. AMQ Broker 通配符语法
AMQ Broker 使用特定语法在地址设置中代表通配符。通配符也可以在安全设置中使用,也可在创建消费者时使用。
-
通配符表达式包含以句点分隔的词语(
.
)。 数字符号 (
#
) 和星号 (*
) 字符还有特殊的用处,可以替代一个词,例如:- 数字符号字符表示"匹配任何 0 个或更多连续的词"。在表达式的末尾使用此内容。
- 星号字符表示"匹配单个单词"。在您的表达式内使用此内容。
匹配不是按照字符进行的,而是根据分割的字符段进行的。例如,一个 address-setting
项被配置为匹配名称中带有 my
的队列将不匹配名为 myqueue
的队列。
当多个 address-setting
元素与地址匹配时,代理覆盖配置使用最低特定匹配项的配置作为基准。表达式中的字面字符比通配符更具体,星号 (*
) 比数字符号更具体 (#
)。例如,my.destination
和 my.*
都会匹配地址 my.destination
。在这种情况下,代理首先应用 my
memcached 下找到的配置,因为通配符表达式比字面更具体。接下来,代理覆盖 my.destination
address 设置元素的配置,该配置会覆盖与 my constraint 共享的任何配置
。例如,如果进行了以下配置,与 my.destination
关联的队列将 max-delivery-attempts
设置为 3
,并将 last-value-queue
设置为 false
。
<address-setting match="my.*"> <max-delivery-attempts>3</max-delivery-attempts> <last-value-queue>true</last-value-queue> </address-setting> <address-setting match="my.destination"> <last-value-queue>false</last-value-queue> </address-setting>
下表中的示例说明了如何使用通配符匹配一组地址。
示例 | 描述 |
---|---|
|
|
|
匹配 |
|
匹配 |
|
匹配 |
4.2.2. 配置字面匹配
在字面匹配中,通配符字符被视为字面字符,以匹配包含通配符的地址。例如,字面匹配中的 hash (#)字符可以匹配一个 订购地址。
8." 没有匹配的地址,如 orders.retail
或 orders.wholesale
。
流程
-
打开 &
lt;broker_instance_dir> /etc/broker.xml
配置文件。 在配置字面匹配前,请使用
literal-match-markers
参数来定义限制字面匹配的字符。在以下示例中,括号用于限制字面匹配。<core> ... <literal-match-markers>()</literal-match-markers> ... </core>
在定义了限制字面匹配的标记后,在
address 设置 match 参数指定匹配项
(包括标记)。以下示例为名为orders.
的地址配置字面匹配,以启用该特定地址的指标。<address-settings> <address-setting match="(orders.#)"> <enable-metrics>true</enable-metrics> </address-setting> </address-settings>
4.2.3. 配置代理通配符语法
以下流程演示了如何自定义用于通配符地址的语法。
流程
-
打开 &
lt;broker_instance_dir> /etc/broker.xml
配置文件。 在配置中添加 <
wildcard-addresses
> 部分,如下例所示。<configuration> <core> ... <wildcard-addresses> // <enabled>true</enabled> // <delimiter>,</delimiter> // <any-words>@</any-words> // <single-word>$</single-word> </wildcard-addresses> ... </core> </configuration>
enabled
-
当设置为
true
时,指示代理使用您的自定义设置。 delimiter
-
提供自定义字符作为
分隔符
替代默认字符(.
)。 any-words
-
作为
any-words
的值提供的字符代表“匹配 0 个或更多个序列”,并将替换默认的#
。在表达式的末尾使用此字符。 single-word
-
作为
single-word
的值提供的字符代表“匹配一个词”,并将替换默认的*
。在您的表达式内使用此字符。