Mailing-List: contact commits-help@qpid.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@qpid.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1560298 - /qpid/trunk/qpid/cpp/AMQP_1.0
Date: Wed, 22 Jan 2014 09:50:34 -0000
To: commits@qpid.apache.org
From: gsim@apache.org
Message-Id: <20140122095034.D3402238889B@eris.apache.org>

Author: gsim
Date: Wed Jan 22 09:50:34 2014
New Revision: 1560298

URL: http://svn.apache.org/r1560298
Log:
NO-JIRA: Added some information about 'topic' type

Modified:
    qpid/trunk/qpid/cpp/AMQP_1.0

Modified: qpid/trunk/qpid/cpp/AMQP_1.0
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/cpp/AMQP_1.0?rev=1560298&r1=1560297&r2=1560298&view=diff
==============================================================================
--- qpid/trunk/qpid/cpp/AMQP_1.0 (original)
+++ qpid/trunk/qpid/cpp/AMQP_1.0 Wed Jan 22 09:50:34 2014
@@ -163,7 +163,8 @@ warning is logged.
 
 If the node is an exchange, then an outgoing link (i.e. messages to
 travel out from broker) will cause a temporary, link-scoped queue to
-be created on the broker and bound to the exchange.
+be created on the broker and bound to the exchange. [See section on
+'Topics' below]
 
 Outgoing links may have a filter set on their source. The filters
 currently supported by the broker are 'legacy-amqp-direct-binding',
@@ -282,4 +283,27 @@ exchange the 'legacy-amqp-direct-binding
 references a queue or a topic exchange, 'legacy-amqp-topic-binding'
 will be added.
 
+* Topics: a mechanism for controlling subscription queues
+
+As there is no standard or obvious mechanism through which to
+configure subscription queues in AMQP 1.0, a new broker entity of type
+'topic' has been added.
+
+A topic references an existing exchange and additionally specifies the
+queue options to use when creating the subscription queue for any
+receiver link attached to that topic. There can be topics with
+different names all referencing the same exchange where different
+policies should be applied to queues.
+
+Topics can be created and deleted using the qpid-config tool, e.g.
+
+  qpid-config add topic my-topic --argument exchange=amq.topic\
+      --argument qpid.max_count=500 --argument qpid.policy_type=self-destruct
+
+If a receiver is established for address 'my-topic/my-key' over 1.0
+now, it will result in a subscription queue being created with a limit
+of 500 messages, that deletes itself (thus ending the subscription) if
+that limit is exceeded and is bound to 'amq.topic' with the key
+'my-key'.
+
 [1] https://issues.apache.org/jira/browse/QPID-4710


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org