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.
|
|
|
|
|
|
|
|
|
|
> **Note**
|
|
|
|
|
>
|
|
|
|
|
> In JMS terminology this allows "topic hierarchies" to be created.
|
|
|
|
|
|
|
|
|
|
To enable this functionality set the property
|
2015-04-29 05:30:31 -04:00
|
|
|
`wild-card-routing-enabled` in the `broker.xml` file to
|
2014-12-04 10:25:29 -05:00
|
|
|
`true`. This is `true` by default.
|
|
|
|
|
|
2015-03-24 07:50:58 -04:00
|
|
|
For more information on the wild card syntax take a look at [wildcard syntax](wildcard-syntax.md) chapter,
|
|
|
|
|
also see the topic hierarchy example in the [examples](examples.md).
|
