注: 单层通配符和多层通配符只能用于订阅(subscribe)消息而不能用于发布(publish)消息,层级分隔符两种情况下均可使用。
订阅也许会包含特殊字符,允许一次订阅多个主题。
使用顶层分隔符意在主题中引入结构概念,因此能够为达到该目标,在主题内指定。多层通配符与单层通配符可用于订阅但是不能用于消息发布方的主题内。
顶层分隔符
前向/用于分隔主题树内不同层次,为主题空间提供层次化的结构。当订阅者指定主题遇到两个通配符时,使用顶层分隔符是十分重要的。
多层通配符
#号可以匹配主题内任何层次,例如,订阅finance/stock/ibm/#,可以在以下主题上接收到消息:
finance/stock/ibm
finance/stock/ibm/closingprice
finance/stock/ibm/currentprice
多层通配符可以代表零或多个层次,因此,finance/#也能够匹配单一finance,其中#代表零层次。顶层分隔符在该上下文环境中是无意义的,因为无层次进行分隔。
可以指定多层通配符仅仅自己或者在顶层分隔符之后。因此,#与finance/#都是有效的,但是finance#无效。多层通配符在主题树内必须是最后一个使用字符,例如finance/#有效,但是finance/#/closingprice无效。
单层通配符
+号仅仅匹配一个主题层次。例如,finance/stock/+匹配finance/stock/ibm与finance/stock/xyz,但是不匹配finance/stock/ibm/closingprice。因为单层次通配符仅仅匹配一个层次,finance/+不匹配finance。
单层次通配符可用于主题树内任何层次,并与多层次通配符一起使用。必须用于在顶层分隔符之后,除了当自己指定时。因此,+和finance/+ 都是有效的,但是finance+无效。单层通配符可用于主题树最后或者在主题树内,例如,finance/+与finance/+/ibm都是有效的。
主题语义与用法
搭建一个应用程序时,主题树设计应当考虑以下主题名称语法与语义原则:
主体必须至少一个字符;
主题名称大小写敏感,例如,ACCOUNTS与Accounts应当为两个不同主题;
主题名称可以包括空白字符,例如,Accounts payable为有效主题;
前导/创建一个独立主题,例如,/finance不同于finance,/finance匹配+/+和/+,但不是+;
主题内不要包括空字符(Unicode \x 0000)