The topic uniform resource identifier (URI) for a topic specifies the name of the topic, and, optionally, one or more properties of the topic.
The URI for a topic begins with the sequence topic://, followed by the name of the topic and, optionally, a list of name-value pairs that set the remaining topic properties. A topic name cannot be empty.
topic = session.createTopic("topic://Sport/Football/Results?multicast=7");
For more information about the properties of a topic, including the name and valid values that you can use in a URI, see Properties of Destination.
When specifying a topic URI for use in a subscription, wildcards can be used. The syntax for these wildcards depends on the connection type and broker version. The schemes are:
The wildcard scheme for WebSphere MQ queue manager with broker v1 uses the following wildcard characters:
Table 1 gives some examples of how to use this wildcard scheme.
URI | Matches |
---|---|
"topic://Sport*Results" | All topics starting with "Sport" and ending in "Results" such as "topic://SportsResults" and "topic://Sport/Hockey/National/Div3/Results" |
"topic://Sport?Results" | All topics starting with "Sport" followed by a single character, followed by "Results" such as "topic://SportsResults" and "topic://SportXResults" |
"topic://Sport/*ball*/Div?/Results/*/???" | Topics such as "topic://Sport/Football/Div1/Results/2002/Nov" and "topic://Sport/Netball/National/Div3/Results/02/Jan" |
The wildcard scheme for WebSphere MQ with, or real-time connection to, a broker v2 uses the following wildcard characters:
Table 2 gives some examples of how to use this wildcard scheme.
URI | Matches |
---|---|
"topic://Sport/+/Results" | All topics with a single hierarchical level name between Sport and Results, such as "topic://Sport/Football/Results" and "topic://Sport/Ju-Jitsu/Results" |
"topic://Sport/#/Results" | All topics starting with "Sport/" and ending in "/Results" such as "topic://Sport/Football/Results" and "topic://Sport/Hockey/National/Div3/Results" |
"topic://Sport/Football/#" | All topics starting with "Sport/Football/" such as "topic://Sport/Football/Results" and "topic://Sport/Football/TeamNews/Signings/Managerial" |
The wildcard scheme for WebSphere MQ with, or real-time connection to, a broker v2 uses the following wildcard characters:
Table 3 gives some examples of how to use this wildcard scheme.
URI | Matches |
---|---|
"topic://Sport/*ball/Results" | All topics with a single hierarchical level name ending in "ball" between Sport and Results, such as "topic://Sport/Football/Results" and "topic://Sport/Netball/Results" |
"topic://Sport//Results" | All topics starting with "Sport/" and ending in "/Results" such as "topic://Sport/Football/Results" and "topic://Sport/Hockey/National/Div3/Results" |
"topic://Sport/Football//." | All topics starting with "Sport/Football/" such as "topic://Sport/Football/Results" and "topic://Sport/Football/TeamNews/Signings/Managerial" |
"topic://Sport/*ball//Results//." | Topics such as "topic://Sport/Football/Results" and "topic://Sport/Netball/National/Div3/Results/2002/November" |