From 6b2a04898d7b50ecdfbde94b585deb4eb9f23fdd Mon Sep 17 00:00:00 2001 From: Jonathan Robie Date: Thu, 22 Apr 2010 18:38:45 +0000 Subject: Integrated feedback from Rafi. git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@937002 13f79535-47bb-0310-9956-ffa450edef68 --- doc/book/src/High-Level-API.xml | 89 ++++++++++++++++++++++++++--------------- 1 file changed, 57 insertions(+), 32 deletions(-) (limited to 'doc/book/src/High-Level-API.xml') diff --git a/doc/book/src/High-Level-API.xml b/doc/book/src/High-Level-API.xml index 3acaf3fd76..8bbf2fc908 100644 --- a/doc/book/src/High-Level-API.xml +++ b/doc/book/src/High-Level-API.xml @@ -257,9 +257,19 @@ finally: language. These programs can use any address string as a source or a destination, and have many command line options to configure behavior—use the -h option - for documentation on these options. The examples in this - tutorial also use the qpid-config utility to - configure AMQP 0-10 queues and exchanges on a Qpid broker. + for documentation on these options. + + Currently, the Python and C++ + implementations of drain and + spout have slightly different + options. This tutorial uses the C++ implementation. The + options will be reconciled in the near + future. + + + The examples in this tutorial also use the + qpid-config utility to configure AMQP 0-10 + queues and exchanges on a Qpid broker. @@ -323,7 +333,7 @@ $ Now let's run drain first, using the -t option to specify a timeout in seconds. While drain is waiting for messages, - run drain in another window. + run spout in another window. First Window: @@ -383,27 +393,38 @@ options ::= { : , ... }
Subjects - - Subjects are used to classify messages. - If a sender's address contains a subject, it is used as the - default subject for any messages that it sends. + Every message has a property called + subject, which is analogous to the + subject on an email message. If no subject is specified, the + message's subject is null. For convenience, address strings + also allow a subject. If a sender's address contains a + subject, it is used as the default subject for the messages + it sends. + + If a receiver's address contains a subject, it is used to + select only messages that match the subject—the matching + algorithm depends on the message source. + - If a receiver's address contains a subject, it is used to - select only messages that match the subject—the - matching algorithm depends on the message source; this is discussed in + + In AMQP 0-10, each exchange type has its own matching + algorithm, and queues do not provide filtering. This is + discussed in . - - At present, receivers will ignore the subject in the the - source address if that address resolves to a queue. Implicit - filtering by subject is only supported for topics and varies - depending on the type of exchange used to represent the - topic. - + + Currently, a receiver bound to a queue ignores subjects, + receiving messages from the queue without filtering. + + In the future, if a receiver is bound to a queue, and its + address contains a subject, the subject will be used as a + selector to filter messages. + + Using subjects @@ -1025,7 +1046,7 @@ Message(properties={spout-id:ea75d64d-ea37-47f9-96a9-d38e01c97925:0}, content='t N - Minimum number of seconds between reconnection attempts. The first reconnection attempt is made immediately; if that fails, the first reconnection delay is set to the value of reconnect_interval_min; if that attempt fails, the reconnection interval increases exponentially until a reconnection attempt succeeds or reconnect_interval_max is reached. + Minimum number of seconds between reconnection attempts. The first reconnection attempt is made immediately; if that fails, the first reconnection delay is set to the value of reconnect_interval_min; if that attempt fails, the reconnect interval increases exponentially until a reconnection attempt succeeds or reconnect_interval_max is reached. @@ -1036,12 +1057,12 @@ Message(properties={spout-id:ea75d64d-ea37-47f9-96a9-d38e01c97925:0}, content='t N - Maximum reconnection interval. + Maximum reconnect interval. - reconnection_interval + reconnect_interval N @@ -1296,7 +1317,7 @@ options := map Python API C++ API - AMQP 0-10 Property + AMQP 0-10 PropertyIn these entries, mp> refers to an AMQP message property, and dp refers to an AMQP delivery property. @@ -1438,19 +1459,16 @@ public class Hello { JNDI Properties File - java.naming.factory.initial + + = amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672' +# destination.[jndiname] = [address_string] +destination.topicExchange = amq.topic +]]> The following sections describe the JNDI properties that Qpid uses. @@ -1511,7 +1529,14 @@ destination.directQueue - Can be used for defining all amq destinations, queues, topics and header matching, using an address string. + Can be used for defining all amq destinations, + queues, topics and header matching, using an + address string. + + Binding URLs, which were used in + earlier versions of the Qpid Java JMS client, can + still be used instead of address + strings. -- cgit v1.2.1