qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From g...@apache.org
Subject svn commit: r961672 - /qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
Date Thu, 08 Jul 2010 09:31:45 GMT
Author: gsim
Date: Thu Jul  8 09:31:45 2010
New Revision: 961672

URL: http://svn.apache.org/viewvc?rev=961672&view=rev
Log:
Added brief section on asynchronous send/acknowledge.

Modified:
    qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml

Modified: qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml?rev=961672&r1=961671&r2=961672&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml (original)
+++ qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml Thu Jul  8 09:31:45 2010
@@ -1786,8 +1786,37 @@ sender.send(message, true);
         <section>
       <title>Performance</title>
       <para>
-         Clients can often be made significantly faster by batching acknowledgements and
setting the capacity of receivers to allow prefetch. The size of a sender's replay buffer
can also affect performance.
+         Clients can often be made significantly faster by using asynchronous operations,
batching acknowledgements and setting the capacity of receivers to allow prefetch. The size
of a sender's replay buffer can also affect performance.
       </para>
+
+      <section>
+	<title>Asynchronous Operations</title>
+
+	<para>The send method on a sender takes an optional second
+	argument that controls whether the call is synchronous or
+	not
+
+        <footnote><para>In C++ the send() is asynchronous by default. In python
however it is synchronous by default.</para></footnote>  
+
+        . A synchronous send will block until the broker confirms
+	receipt of the message. Higher throughput is achieved if the
+	call returns before this point, allowing further send calls to
+	be made. The sender can be queried to find out how many
+	unsettled messages there are. Unsettled messages are those
+	that have been sent but not yet acknowledged by the broker. An
+	unsettled count of zero means that receipt of all messages
+	sent using that sender have been confirmed as received by the
+	broker.
+        </para>
+
+        <para>The acknowledge call on a session may also be
+        synchronous or asynchronous. The session can be queried for
+        the unsettled acknowledgements also, i.e. the number of
+        messages received on the session that have been acknowledged
+        by the application but for which the acknowledgements have not
+        been confirmed by the broker.</para>
+      </section>
+
       <section>
 	<title>Batching Acknowledgements</title>
 



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org


Mime
View raw message