diff options
| author | Jonathan Robie <jonathan@apache.org> | 2010-05-07 22:37:31 +0000 |
|---|---|---|
| committer | Jonathan Robie <jonathan@apache.org> | 2010-05-07 22:37:31 +0000 |
| commit | a8ad8568a39ef83ba8bcf1308c5a5a92d97cdf7a (patch) | |
| tree | 4865e6cc5733978e2732c254a61e53951f93f3c2 | |
| parent | 1e7d080a3fbf36f032c78041c55fe0ecbca6b62b (diff) | |
| download | qpid-python-a8ad8568a39ef83ba8bcf1308c5a5a92d97cdf7a.tar.gz | |
Added sizing the replay buffer.
git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@942258 13f79535-47bb-0310-9956-ffa450edef68
| -rw-r--r-- | doc/book/src/Programming-In-Apache-Qpid.xml | 41 |
1 files changed, 32 insertions, 9 deletions
diff --git a/doc/book/src/Programming-In-Apache-Qpid.xml b/doc/book/src/Programming-In-Apache-Qpid.xml index 42d69ba015..5fd47e68b4 100644 --- a/doc/book/src/Programming-In-Apache-Qpid.xml +++ b/doc/book/src/Programming-In-Apache-Qpid.xml @@ -1589,7 +1589,7 @@ 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. + 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. </para> <section> <title>Batching Acknowledgements</title> @@ -1625,8 +1625,34 @@ Message message = receiver.fetch(); </example> </section> + <section> + <title>Sizing the Replay Buffer</title> + + <para>In order to guarantee delivery, a sender automatically + keeps messages in a replay buffer until the messaging broker + acknowledges that they have been received. The replay buffer + is held in memory, and is never paged to disk. For most + applications, the default size of the replay buffer works + well. A large replay buffer requires more memory, a small + buffer can slow down the client because it can not send new + messages if the replay buffer is full, and must wait for + existing sends to be acknowledged.</para> + + <example> + <title>Sizing the Replay Buffer</title> + <para>C++</para> + + <programlisting> +Sender sender = session.createSender(address); +sender.setCapacity(100); + </programlisting> + </example> + + </section> + </section> + <section> <title>Reliability</title> @@ -1655,27 +1681,24 @@ message.setDurable(1); sender.send(Message("Hello world!")); ]]></programlisting> - </example> <!-- <para>Python:</para> --> -<!-- </example> + </example> <section> - <title>Cluster Failover </title> + <title>Cluster Failover #### </title> </section> ---> </section> </section> -<!-- <section> - <title>Security</title> -########## + <title>Security ####</title> + </section> ---> + <section> <title>Transactions</title> |