mirror of
https://github.com/apache/activemq-artemis.git
synced 2025-03-04 08:19:56 +00:00
2b5d8f3b80
- Split protocols into individual chapters - Reorganize summary to flow more logically - Fill in missing parameters in configuration index - Normalize spaces for ordered and unordered lists - Re-wrap lots of text for readability - Fix incorrect XML snippets - Normalize table formatting - Improve internal links with anchors - Update content to reflect new address model - Resized architecture images to avoid excessive white-space - Update some JavaDoc - Update some schema elements - Disambiguate AIO & ASYNCIO where necessary - Use URIs instead of Objects in code examples
25 lines
949 B
Markdown
25 lines
949 B
Markdown
# Routing Messages With Wild Cards
|
|
|
|
Apache ActiveMQ Artemis allows the routing of messages via wildcard addresses.
|
|
|
|
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.
|
|
|
|
This functionality is enabled by default. To turn it off add the following to the `broker.xml` configuration.
|
|
|
|
```xml
|
|
<wildcard-addresses>
|
|
<routing-enabled>false</routing-enabled>
|
|
</wildcard-addresses>
|
|
```
|
|
|
|
For more information on the wild card syntax and how to configure it, take a look at [wildcard syntax](wildcard-syntax.md) chapter,
|
|
also see the topic hierarchy example in the [examples](examples.md).
|