You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kw...@apache.org on 2013/10/07 16:30:10 UTC
svn commit: r1529848 -
/qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml
Author: kwall
Date: Mon Oct 7 14:30:09 2013
New Revision: 1529848
URL: http://svn.apache.org/r1529848
Log:
QPID-5202: Exchange documentation - incorporate initial feedback
Feedback from Robbie Gemmell and Oleksandr Rudyy.
Modified:
qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml
Modified: qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml?rev=1529848&r1=1529847&r2=1529848&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml (original)
+++ qpid/trunk/qpid/doc/book/src/java-broker/Java-Broker-Concepts-Exchanges.xml Mon Oct 7 14:30:09 2013
@@ -26,7 +26,7 @@
messages from producers and routes them to matching <emphasis>Queue</emphasis>s within the <emphasis>Virtual Host</emphasis>.</para>
<para>The server provides a set of exchange types with each exchange type implementing a different routing algorithm. For details of how
these exchanges types work see <xref linkend="Java-Broker-Concepts-Exchanges-Types"/> below.</para>
- <para>The server predeclares a number of exchange instances with names starting with <literal>amq.</literal>. These are defined in
+ <para>The server predeclares a number of exchange instances with names starting with "<literal>amq.</literal>". These are defined in
<xref linkend="Java-Broker-Concepts-Exchanges-Predeclared"/>.</para>
<para>Applications can make use the pre-declared exchanges, or they may declare their own. The number of exchanges within a virtual host is
limited only by resource constraints.</para>
@@ -42,10 +42,11 @@
<listitem>amq.match (an instance of a headers exchange)</listitem>
</itemizedlist>
</para>
- <para>An exchange known as the default exchange is also pre-declared. This is a direct exchange but is special in that all
- queues are automatically bound to it once using their name as a binding key. It is not possible to manually add or remove
+ <para>The conceptual "<literal>default exchange</literal>" always exists, effectively a special instance of
+ direct exchange which uses the empty string as its name. All queues are automatically bound to it upon their creation
+ using the queue name as the binding key, and unbound upon their deletion. It is not possible to manually add or remove
bindings within this exchange.</para>
- <para>Applications may not declare exchanges with names beginning with <literal>amq.</literal>. Such names are reserved for system use.</para>
+ <para>Applications may not declare exchanges with names beginning with "<literal>amq.</literal>". Such names are reserved for system use.</para>
</section>
<section id="Java-Broker-Concepts-Exchanges-Types">
<title>Exchange Types</title>
@@ -76,9 +77,9 @@
</mediaobject>
</figure>
<para>The figure above illustrates the operation of direct exchange type. The yellow messages published with the routing key
- <literal>myqueue</literal> match the binding key corresponding to queue <literal>myqueue</literal> to are routes there. The red
- messages published with the routing key <literal>foo</literal> match two bindings in the table so a copy of the message is
- routed to both <literal>bar1</literal> and <literal>bar2</literal>.</para>
+ "<literal>myqueue</literal>" match the binding key corresponding to queue "<literal>myqueue</literal>" and so are routed there. The red
+ messages published with the routing key "<literal>foo</literal>" match two bindings in the table so a copy of the message is
+ routed to both the "<literal>bar1</literal>" and "<literal>bar2</literal>" queues.</para>
<para>The routing key of the blue message matches no binding keys, so the message is unroutable. It is handled as described
in <xref linkend="Java-Broker-Concepts-Exchanges-UnroutableMessage"/>.</para>
</section>
@@ -101,7 +102,7 @@
</imageobject>
</mediaobject>
</figure>
- <para>The figure above illustrates publishing messages with routing key <literal>weather</literal>. The exchange routes each
+ <para>The figure above illustrates publishing messages with routing key "<literal>weather</literal>". The exchange routes each
message to every bound queue whose binding key matches the routing key.</para>
<para>In the case illustrated, this means that each subscriber's queue receives every yellow message.</para>
<figure>
@@ -115,9 +116,9 @@
<para>The figure above illustrates publishing messages with hierarchical routing keys. As before, the exchange routes each
message to every bound queue whose binding key matches the routing key but as the binding keys contain wildcards, the
wildcard rules described above apply.</para>
- <para>In the case illustrated, <literal>sub1</literal> has received the red and green message as <literal>news.uk</literal> and <literal>news.de</literal>
- match binding key <literal>news.#</literal>. The red message has also gone to <literal>sub2</literal> and <literal>sub3</literal> as it's routing key
- is matched exactly by <literal>news.uk</literal> and by <literal>*.uk</literal>.</para>
+ <para>In the case illustrated, <literal>sub1</literal> has received the red and green message as "<literal>news.uk</literal>" and "<literal>news.de</literal>"
+ match binding key "<literal>news.#</literal>". The red message has also gone to <literal>sub2</literal> and <literal>sub3</literal> as it's routing key
+ is matched exactly by "<literal>news.uk</literal>" and by "<literal>*.uk</literal>".</para>
<para>The routing key of the yellow message matches no binding keys, so the message is unroutable. It is handled as described
in <xref linkend="Java-Broker-Concepts-Exchanges-UnroutableMessage"/>.</para>
<figure>
@@ -128,13 +129,13 @@
</imageobject>
</mediaobject>
</figure>
- <para>The figure above illustrates messages with properties published with routing key <literal>shipping</literal>.</para>
+ <para>The figure above illustrates messages with properties published with routing key "<literal>shipping</literal>".</para>
<para>As before, the exchange routes each message to every bound queue whose binding key matches the routing key but as a JMS selector
- argument has been specified, the expression is evalutated against each matching message. Only messages whose message's header values or properties
+ argument has been specified, the expression is evalutated against each matching message. Only messages whose message header values or properties
match the expression are routed to the queue.</para>
- <para>In the case illustrated, <literal>sub1</literal> has received the yellow and blue message as their property <literal>area</literal>
- cause expression <literal>area in ('Forties', 'Cromarty')</literal> to evaluate true. Similarly, the yellow message has also gone to
- <literal>gale_alert</literal> as its property <literal>speed</literal> causes expression <literal>speed > 7 and speed < 10</literal>.
+ <para>In the case illustrated, <literal>sub1</literal> has received the yellow and blue message as their property "<literal>area</literal>"
+ cause expression "<literal>area in ('Forties', 'Cromarty')</literal>" to evaluate true. Similarly, the yellow message has also gone to
+ <literal>gale_alert</literal> as its property "<literal>speed</literal>" causes expression "<literal>speed > 7 and speed < 10</literal>"
to evaluate true.</para>
<para>The properties of purple message cause expressions no evaluate true, so the message is unroutable. It is handled as described in
<xref linkend="Java-Broker-Concepts-Exchanges-UnroutableMessage"/>.</para>
@@ -154,7 +155,7 @@
<section id="Java-Broker-Concepts-Exchanges-Types-Headers">
<title>Headers</title>
<para>The headers exchange type routes messages to queues based on header properties within the AMQP message. The message is
- passed to a queue if the header properties of the message satisfy header matching arguments table with which the queue was bound.
+ passed to a queue if the header properties of the message satisfy the header matching arguments table with which the queue was bound.
</para>
</section>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org