43 lines
2.8 KiB
XML
43 lines
2.8 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
<!-- ============================================================================= -->
|
|
<!-- Licensed to the Apache Software Foundation (ASF) under one or more -->
|
|
<!-- contributor license agreements. See the NOTICE file distributed with -->
|
|
<!-- this work for additional information regarding copyright ownership. -->
|
|
<!-- The ASF licenses this file to You under the Apache License, Version 2.0 -->
|
|
<!-- (the "License"); you may not use this file except in compliance with -->
|
|
<!-- the License. You may obtain a copy of the License at -->
|
|
<!-- -->
|
|
<!-- http://www.apache.org/licenses/LICENSE-2.0 -->
|
|
<!-- -->
|
|
<!-- Unless required by applicable law or agreed to in writing, software -->
|
|
<!-- distributed under the License is distributed on an "AS IS" BASIS, -->
|
|
<!-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -->
|
|
<!-- See the License for the specific language governing permissions and -->
|
|
<!-- limitations under the License. -->
|
|
<!-- ============================================================================= -->
|
|
|
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % BOOK_ENTITIES SYSTEM "ActiveMQ_User_Manual.ent">
|
|
%BOOK_ENTITIES;
|
|
]>
|
|
|
|
<chapter id="wildcard-routing">
|
|
<title>Routing Messages With Wild Cards</title>
|
|
<para>ActiveMQ allows the routing of messages via wildcard addresses.</para>
|
|
<para>If a queue is created with an address of say <literal>queue.news.#</literal> then it
|
|
will receive any messages sent to addresses that match this, for instance <literal
|
|
>queue.news.europe</literal> or <literal>queue.news.usa</literal> or <literal
|
|
>queue.news.usa.sport</literal>. If you create a consumer on this queue, this allows a consumer to consume messages which are
|
|
sent to a <emphasis>hierarchy</emphasis> of addresses.</para>
|
|
<note>
|
|
<para>In JMS terminology this allows "topic hierarchies" to be created.</para>
|
|
</note>
|
|
<para>To enable this functionality set the property <literal>wild-card-routing-enabled</literal>
|
|
in the <literal>activemq-configuration.xml</literal> file to <literal>true</literal>. This is
|
|
<literal>true</literal> by default.</para>
|
|
<para>For more information on the wild card syntax take a look at <xref
|
|
linkend="wildcard-syntax" /> chapter, also see <xref
|
|
linkend="topic-hierarchy-example" />.</para>
|
|
</chapter>
|