diff options
| author | Gordon Sim <gsim@apache.org> | 2014-01-22 09:50:34 +0000 |
|---|---|---|
| committer | Gordon Sim <gsim@apache.org> | 2014-01-22 09:50:34 +0000 |
| commit | d5ffa452e824b9a8e18e48e527ae52b30fa901a1 (patch) | |
| tree | d97f73866f0a33ab473f897dbfad82b917e0e36c /qpid/cpp | |
| parent | e7fe4dc7234247051826d3c007aab90feb1b8b6e (diff) | |
| download | qpid-python-d5ffa452e824b9a8e18e48e527ae52b30fa901a1.tar.gz | |
NO-JIRA: Added some information about 'topic' type
git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk@1560298 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'qpid/cpp')
| -rw-r--r-- | qpid/cpp/AMQP_1.0 | 26 |
1 files changed, 25 insertions, 1 deletions
diff --git a/qpid/cpp/AMQP_1.0 b/qpid/cpp/AMQP_1.0 index 2129a015c4..ef478c7a15 100644 --- a/qpid/cpp/AMQP_1.0 +++ b/qpid/cpp/AMQP_1.0 @@ -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' will be added. If it 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 |