activemq-artemis/docs/user-manual/en/wildcard-routing.md
Justin Bertram 2b5d8f3b80 ARTEMIS-1912 big doc refactor
- 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
2018-06-07 11:26:36 -04:00

949 B

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.

<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 chapter, also see the topic hierarchy example in the examples.