2014-12-11 07:17:29 -05:00
|
|
|
# Routing Messages With Wild Cards
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis allows the routing of messages via wildcard addresses.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
|
|
|
|
If a queue is created with an address of say `queue.news.#` then it will
|
|
|
|
|
receive any messages sent to addresses that match this, for instance
|
|
|
|
|
`queue.news.europe` or `queue.news.usa` or `queue.news.usa.sport`. If
|
|
|
|
|
you create a consumer on this queue, this allows a consumer to consume
|
|
|
|
|
messages which are sent to a *hierarchy* of addresses.
|
|
|
|
|
|
2018-03-09 10:07:38 -05:00
|
|
|
> **Note:**
|
2014-12-04 10:25:29 -05:00
|
|
|
>
|
|
|
|
|
> In JMS terminology this allows "topic hierarchies" to be created.
|
|
|
|
|
|
2016-12-23 06:02:30 -05:00
|
|
|
This functionality is enabled by default. To turn it off add the following to the `broker.xml` configuration.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
```xml
|
|
|
|
|
<wildcard-addresses>
|
|
|
|
|
<routing-enabled>false</routing-enabled>
|
|
|
|
|
</wildcard-addresses>
|
|
|
|
|
```
|
2016-12-23 06:02:30 -05:00
|
|
|
|
|
|
|
|
For more information on the wild card syntax and how to configure it, take a look at [wildcard syntax](wildcard-syntax.md) chapter,
|
2015-03-24 07:50:58 -04:00
|
|
|
also see the topic hierarchy example in the [examples](examples.md).
|
