Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,2 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.2. Queue</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Queue"></a>6.2. Queue</h2></div></div></div><p><code class="literal">queue.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html"; target="_top">Queue</a> with the given JNDI name. The + value is simple queue name. This is the name of the queue as known by the Broker.</p><p>The <code class="literal">queue.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=direct://amq.direct//<queue name>?routingkey=’<queue name>’&durable=’true’</pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 6. JNDI Properties Format </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign=" top" width="40%"> 6.3. Topic</td></tr></table></div></div> \ No newline at end of file
Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,4 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.3. Topic</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Topic"></a>6.3. Topic</h2></div></div></div><p><code class="literal">topic.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html"; target="_top">Topic</a> with the given JNDI name. The + value is topic name. This topic name is used on the Broker as a binding key between the + <code class="literal">amq.topic</code> exchange and the queue corresponding to the topic + subscriber.</p><p>The <code class="literal">topic.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=topic://amq.topic/<topic name>/?routingkey=<topic name></pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.2. Queue </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 6.4. Destination</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,14 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 6. JNDI Properties Format</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-JNDI-Properties-Format"></a>Chapter 6. JNDI Properties Format</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format.html#JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory">6.1. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properti es-Format-Queue.html">6.2. Queue</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">6.3. Topic</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">6.4. Destination</a></span></dt></dl></div><p>The Qpid JMS Client comes with own JNDI context factory + <code class="literal">org.apache.qpid.jndi.PropertiesFileInitialContextFactory</code> which utilises a + Java properties file for declaring the JMS administered objects: connection factories, queues, + topics and destinations. It uses the following syntax:</p><p> + </p><pre class="screen"> +connectionfactory.<jndi name>=<connection url> +queue.<jndi name>=<queue name> +topic.<jndi name>=<topic name> +destination.<jndi name>=<binding url> +</pre><p>An arbitrary number of connection factories, queues, topics, queues or destinations or can + be declared in the JNDI properties file. Each JNDI name must be unique.</p><p>The application looks up the objects via an InitialContext. This lookup and an example JNDI + properties file is provided in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter 4. Examples">Chapter 4, <em>Examples</em></a></p><p>We now consider each JMS administered object type in turn.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory"></a>6.1. ConnectionFactory</h2></div></div></div><p><code class="literal">connectionfactory.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html"; target="_top">ConnectionFactory</a> with the + given JNDI name. The value must be a legal Connection URL.</p><p>See <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Chapter 7, <em>Connection URLs</em></a> for format of the URL and its + permitted options.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">5.7. Destinations </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 6.2. Queue</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,8 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">10.2. Enabling Debug</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><th align="center" width="60%">Chapter 10. Logging</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-EnablingDebugLogging"></a>10.2. Enabling Debug</h2></div></div></div><p>If you are experiencing a problem, it can be informative to enable debug logging to allow + the behaviour of the Qpid JMS client to be understood at a deeper level.</p><p>To do this, set the <code class="literal">org.apache.qpid</code> logger to + <code class="literal">DEBUG</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding (or + changing) the following line:</p><pre class="screen"> + log4j.logger.org.apache.qpid=DEBUG + </pre><p>If you are using another logging framework, or you are using Log4j but configuring in + another manner, refer to the documentation accompanying the logging framework for details of + how to proceed.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Logging.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 10. Logging </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix A. Exceptions</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-Logging.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,12 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 10. Logging</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Logging"></a>Chapter 10. Logging</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">10.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">10.2. Enabling Debug</a></span> </dt></dl></div><p>The Qpid JMS client uses the <a class="link" href="http://www.slf4j.org"; target="_top">Apache SLF4J</a> logging + framework. All logging activity created by the client is directed through the SLF4J API. SLF4J + is a is a façade for other common logging frameworks. This makes it easy for application authors + to use their prefered logging framework in their application stack, and have the Qpid JMS Client + use it too. </p><p>SLF4J suppplies bindings for many common logging frameworks (<a class="link" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"; target="_top">JUL</a>, <a class="link" href="http://logging.apache.org/log4j/1.2/"; target="_top">Apache Log4J</a>, <a class="link" href="http://logback.qos.ch"; target="_top">Logback</a>.</p><p>Include the SLF4J binding corresponding to the logging framework of your choosen logging + framework on classpath. For full details, see the SLF4J <a class="link" href="http://www.slf4j.org"; target="_top">documentation</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel"></a>10.1. Recommended Production Logging Level</h2></div></div></div><p>In production, it is recommended that you configure your logging framework is configured + with logger <code class="literal">org.apache.qpid</code> set to <code class="literal">WARN</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding the + following line:</p><pre class="screen"> + org.apache.qpid=WARN + </pre><p>If you are using another logging framework, or you are using Log4j but configuring in + another manner, refer to the documentation accompanying the logging framework for details of + how to proceed.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 9. System Properties </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 10.2. Enabling Debug</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-System-Properties.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-System-Properties.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-System-Properties.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-0-8-System-Properties.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,100 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 9. System Properties</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Binding-URL.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Logging.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-System-Properties"></a>Chapter 9. System Properties</h1></div></div></div><p>The following system properties affect the behaviour of the Qpid JMS client. System + properties are global in nature so affect all Qpid interactions made from within the same + JVM. For many options, there are equivalent <a class="link" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Connection URL</a> options allowing the option to be controlled at the level of the + Connection.</p><div class="table"><a id="d0e1820"></a><p class="title"><strong>Table 9.1. System Properties Affecting Connection Behaviour</strong></p><div class="table-contents"><table border="1" summary="System Properties Affecting Connection Behaviour" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td>qpid.amqp.version</td><td>string</td><td>0-10</td><td><p>Sets the AMQP version to be used - currently supports one of + {0-8,0-9,0-91,0-10}.</p><p>The client will begin negotiation at + the specified version and only negotiate downwards if the Broker does + not support the specified version.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-Heartbeat"></a>qpid.heartbeat</td><td>int</td><td><p>Defaults to the heartbeat value suggested by the Broker, if + any.</p></td><td>Frequency of heartbeat messages (in seconds). A value of 0 disables + heartbeating. <p>Two consecutive missed heartbeats will result in the + connection timing out.</p><p>This can also be set per connection + using the <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-BrokerOptions-Heartbeat">Connection URL</a> options.</p><p>For compatibility with + old client configuration, the synonym + <code class="varname">amqj.heartbeat.delay</code> is supported.</p></td></tr><tr><td>ignore_setclientID</td><td>boolean</td><td>false</td><td>If a client ID is specified in the connection URL it's used or else an ID + is generated. If an ID is specified after it's been set Qpid will throw an + exception. <p>Setting this property to 'true' will disable that check and + allow you to set a client ID of your choice later on.</p></td></tr><tr><td>qpid.connection_ssl_verify_hostname</td><td>boolean</td><td>true</td><td>This property is used to turn on/off broker host name verification on SSL negotiation + if SSL transport is used. It is set to 'true' by default. + <p>Setting this property to 'false' will disable that check and + allow you to ignore host name errors.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-ConnectionCompressMessages"></a>qpid.connection_compress_messages</td><td>Boolean</td><td>false</td><td><p>Controls whether the client will compress messages before they they are sent.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-MessageCompressionThresholdSize"></a>qpid.message_compression_threshold_size</td><td>Integer</td><td>102400</td><td><p>The payload size beyond which the client will start to compress message payloads.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e1911"></a><p class="title"><strong>Table 9.2. Config Options For Session Behaviour</strong></p><div class="table-contents"><table border="1" summary="Config Options For Session Behaviour" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th ><th>Description</th></tr></thead><tbody><tr><td><a >id="JMS-Client-0-8-System-Properties-DestSyntax"></a>qpid.dest_syntax</td><td>String</td><td>ADDR</td><td><p>Addressing > syntax: ADDR (Address format) or BURL (Binding URL)</p></td></tr><tr><td><a >id="JMS-Client-0-8-System-Properties-Maxprefetch"></a>max_prefetch</td><td>int</td><td>500</td><td><p>Maximum > number of pre-fetched messages per Session. This can also + be defaulted for sessions created on a particular connection using the + <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Maxprefetch">Connection URL</a> options.</p></td></tr><tr><td>qpid.use_legacy_map_message</td><td>boolean</td><td>false</td><td><p>If set will use the old map message encoding. By default the Map + messages are encoded using the 0-10 map encoding.</p><p>This can + also be set per connection using the <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-UseLegacyMap">Connection URL</a> options.</p></td></tr><tr><td>qpid.jms.daemon.dispatcher</td><td>boolean</td><td>false</td><td><p>Controls whether the Session dispatcher thread is a daemon thread + or not. If this system property is set to true then the Session + dispatcher threads will be created as daemon threads. This setting is + introduced in version 0.16.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e1976"></a><p class="title"><strong>Table 9.3. Config Options For Consumer Behaviour</strong></p><div class="table-contents"><table border="1" summary="Config Options For Consumer Behaviour" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-System-Properties-DeclareExchanges"></a>qpid.declare_exchanges</td><td>Boolean</td><td>true</td><td><p>If true, creating a consumer will also declare the exchange on the + Broker (specified within the Binding URL associated with the + Destination), creating it if is does not already exist. + </p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-DeclareQueues"></a>qpid.declare_queues</td><td>Boolean</td><td>true</td><td><p>If true, creating a consumer will also declare the queue on the + Broker (specified within the Binding URL associated with the + Destination), creating it if is does not already + exist.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-BindQueues"></a>qpid.bind_queues</td><td>Boolean</td><td>true</td><td><p>If true, creating a consumer will also bind the queue to the + to the exchange using the routing key as a binding key. The + exchange name, queue name and routing key are taken from + the Binding URL associated with the Destination.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-RejectBehaviour"></a>qpid.reject.behaviour</td><td>String</td><td>NORMAL</td><td><p>Used with the maximum delivery count feature. See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-MaximumDeliveryCount" title="5.6.3. Maximum Delivery Count">Section 5.6.3, “Maximum Delivery Count”</a> for details.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e2035"></a><p class="title"><strong>Table 9.4. Config Options For Producer Behaviour</strong></p><div class="table-contents"><table border="1" summary="Config Options For Producer Behaviour" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-System-Properties-DefaultMandatory"></a>qpid.default_mandatory</td><td>Boolean</td><td>True</td><td><p>If true, messages sent to Queue destinations for which cannot be + routed to at least one queue on the Broker, will be returned to the + application. See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-MandatoryMessage" title="5.5.1. Mandatory Messages">Section 5.5.1, “Mandatory Messages”</a> for more details.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-DefaultMandatoryTopic"></a>qpid.default_mandatory_topic</td><td>Boolean</td><td>False</td><td><p>If true, messages sent to Topic destinations for which cannot be + routed to at least one queue on the Broker, will be returned to the + application. See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-MandatoryMessage" title="5.5.1. Mandatory Messages">Section 5.5.1, “Mandatory Messages”</a> for more details..</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-DefaultImmediate"></a>qpid.default_immediate</td><td>Boolean</td><td>False</td><td><p>If true, the message will be returned to the application unless the + Broker is able to route the message to at least one queue with a + consumer attached. See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-ImmediateMessage" title="5.5.3. Immediate Messages">Section 5.5.3, “Immediate Messages”</a> for more details.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-FlowControlWaitFailure"></a>qpid.flow_control_wait_failure</td><td>Long</td><td>60000</td><td><p>Used with <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-FlowControl" title="5.5.4. Flow Control">Section 5.5.4, “Flow Control”</a>. The amount of time (in milliseconds) to wait before timing + out.</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-FlowControlWaitNotifyPeriod"></a>qpid.flow_control_wait_notify_period</td><td>Long</td><td>5000</td><td><p>Used with <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-FlowControl" title="5.5.4. Flow Control">Section 5.5.4, “Flow Control”</a>. The frequency at which the log message informing that the producer + is flow controlled .</p></td></tr><tr><td><a id="JMS-Client-0-8-System-Properties-SyncPublish"></a>sync_publish</td><td>string</td><td>"" (disabled)</td><td> + <p>If 'all' is set then messages will be sent synchronously.</p> + <p>This can also be set per connection using the + <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-SyncPublish"> + Connection URL + </a> + options. + </p> + </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e2128"></a><p class="title"><strong>Table 9.5. Config Options For Threading</strong></p><div class="table-contents"><table border="1" summary="Config Options For Threading" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td>qpid.thread_factory</td><td>string</td><td>org.apache.qpid.thread.DefaultThreadFactory</td><td><p>Specifies the thread factory to use.</p><p>If using a real + time JVM, you need to set the above property to + <code class="varname">org.apache.qpid.thread.RealtimeThreadFactory</code>.</p></td></tr><tr><td>qpid.rt_thread_priority</td><td>int</td><td>20</td><td><p>Specifies the priority (1-99) for Real time threads created by the + real time thread factory.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e2168"></a><p class="title"><strong>Table 9.6. Config Options For I/O</strong></p><div class="table-contents"><table border="1" summary="Config Options For I/O" width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-System-Properties-SyncOpTimeout"></a>qpid.sync_op_timeout</td><td>long</td><td>60000</td><td><p>The length of time (in milliseconds) to wait for a synchronous + operation to complete.</p><p>For compatibility with older clients, + the synonym <code class="varname">amqj.default_syncwrite_timeout</code> is + supported.</p></td></tr><tr><td>qpid.tcp_nodelay</td><td>boolean</td><td>true</td><td> + <p>Sets the TCP_NODELAY property of the underlying socket. The default + was changed to true as of Qpid 0.14.</p> + <p>This can also be set per connection using the Connection URL broker + option<a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-BrokerOptions-TcpNoDelay"><code class="literal">tcp_nodelay</code>.</a> options.</p> + <p>For compatibility with older clients, the synonym + <code class="varname">amqj.tcp_nodelay</code> is supported.</p> + </td></tr><tr><td>qpid.send_buffer_size</td><td>integer</td><td>65535</td><td> + <p>Sets the SO_SNDBUF property of the underlying socket. Added in Qpid + 0.16.</p> + <p>For compatibility with older clients, the synonym + <code class="varname">amqj.sendBufferSize</code> is supported.</p> + </td></tr><tr><td>qpid.receive_buffer_size</td><td>integer</td><td>65535</td><td> + <p>Sets the SO_RCVBUF property of the underlying socket. Added in Qpid + 0.16.</p> + <p>For compatibility with older clients, the synonym + <code class="varname">amqj.receiveBufferSize</code> is supported.</p> + </td></tr><tr><td>qpid.failover_method_timeout</td><td>long</td><td>60000</td><td> + <p>During failover, this is the timeout for each attempt to try to + re-establish the connection. If a reconnection attempt exceeds the + timeout, the entire failover process is aborted.</p> + <p>It is only applicable for AMQP 0-8/0-9/0-9-1 clients.</p> + </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e2276"></a><p class="title"><strong>Table 9.7. Config Options For Security - Using SSL for securing connections or using EXTERNAL as + the SASL mechanism.</strong></p><div class="table-contents"><table border="1" summary="Config Options For Security - Using SSL for securing connections or using EXTERNAL as the SASL mechanism." width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td>qpid.ssl_timeout</td><td>long</td><td>60000</td><td><p>Timeout value used by the Java SSL engine when waiting on + operations.</p></td></tr><tr><td>qpid.ssl.KeyManagerFactory.algorithm</td><td>string</td><td>-</td><td> + <p>The key manager factory algorithm name. If not set, defaults to the + value returned from the Java runtime call + <code class="literal">KeyManagerFactory.getDefaultAlgorithm()</code></p> + <p>For compatibility with older clients, the synonym + <code class="varname">qpid.ssl.keyStoreCertType</code> is supported.</p> + </td></tr><tr><td>qpid.ssl.TrustManagerFactory.algorithm</td><td>string</td><td>-</td><td> + <p>The trust manager factory algorithm name. If not set, defaults to the + value returned from the Java runtime call + <code class="literal">TrustManagerFactory.getDefaultAlgorithm()</code></p> + <p>For compatibility with older clients, the synonym + <code class="varname">qpid.ssl.trustStoreCertType</code> is supported.</p> + </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="d0e2341"></a><p class="title"><strong>Table 9.8. Config Options For Security - Standard JVM properties needed when Using SSL for + securing connections or using EXTERNAL as the SASL mechanism.<a class="footnote" href="#ftn.d0e2344" id="d0e2344"><sup class="footnote">[a]</sup></a></strong></p><div class="table-contents"><table border="1" summary="Config Options For Security - Standard JVM properties needed when Using SSL for securing connections or using EXTERNAL as the SASL mechanism.Qpid allows you to have per connection key and trust stores if required. If specified per connection, the JVM arguments are ignored." width="100%"><colgroup><col /><col /><col /><col /></colgroup><thead><tr><th>Property Name</th><th>Type</th><th>Default Value</th><th>Description</th></tr></thead><tbody><tr><td>javax.net.ssl.keyStore</td><td>string</td><td>jvm default</td><td><p>Specifies the key store path.</p><p>This can also be set per + connection using the <a class="link" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Connection URL</a> options.</p></td></tr><tr><td>javax.net.ssl.keyStorePassword</td><td>string</td><td>jvm default</td><td><p>Specifies the key store password.</p><p>This can also be set + per connection using the <a class="link" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Connection URL</a> options.</p></td></tr><tr><td>javax.net.ssl.trustStore</td><td>string</td><td>jvm default</td><td><p>Specifies the trust store path.</p><p>This can also be set + per connection using the <a class="link" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Connection URL</a> options.</p></td></tr><tr><td>javax.net.ssl.trustStorePassword</td><td>string</td><td>jvm default</td><td><p>Specifies the trust store password.</p><p>This can also be + set per connection using the <a class="link" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Connection URL</a> + options.</p></td></tr></tbody><tbody class="footnotes"><tr><td colspan="4"><div class="footnote" id="ftn.d0e2344"><p><a class="para" href="#d0e2344"><sup class="para">[a] </sup></a>Qpid allows you to have per connection key and trust stores if required. If + specified per connection, the JVM arguments are ignored.</p></div></td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Binding-URL.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Logging.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 8. Binding URL </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 10. Logging</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-Book.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-Book.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-Book.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/JMS-Client-Book.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,6 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</th></tr><tr><td align="left" width="20%"> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Introduction.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="d0e2"></a>Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</h1></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="JMS-Client-0-8-Introduction.html">1. Introduction</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">2. Document Scope And Intended Audience</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">3. Getting the Client And Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html#JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting">3.1. Getting the Client</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">3.2. Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Examples.html">4. Examples</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP">4.1. Point to point example</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Examples-PubSub.html">4.2. Publish/subscribe example</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Client-Understanding.html">5. Understanding the Qpid JMS client</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding.html#JMS-Client-0-8-Client-Understanding-Overview">5.1. Overv iew</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.html">5.2. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html">5.3. Connection</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover">5.3.1. Failover</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Heartbeating">5.3.2. Heartbeating</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-SSL">5.3.3. SSL</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-MessageCompression">5.3.4. Message Compression</a></span></dt ></dl></dd><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html">5.4. >Session</a></span></dt><dd><dl><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-Prefecth">5.4.1. > Prefetch</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-TemporaryQueues">5.4.2. > TemporaryQueues</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-CreateQueue">5.4.3. > CreateQueue</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-CreateTopic">5.4.4. > CreateTopic</a></span></dt></dl></dd><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-MessageProducer.html">5.5. >MessageProducer</a></span></dt><dd><dl><dt><span class= "section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-MandatoryMessage">5.5.1. Mandatory Messages</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-CloseWhenNoRoute">5.5.2. Close When No Route</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-ImmediateMessage">5.5.3. Immediate Messages</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-FlowControl">5.5.4. Flow Control</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html">5.6. MessageConsumer</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Underst anding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-ConsumerSideEffect">5.6.1. Consumers have Exchange/Queue Declaration and Binding Side Effect</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-TopicSubscriptions">5.6.2. Topic Subscriptions</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-MaximumDeliveryCount">5.6.3. Maximum Delivery Count</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Destinations.html">5.7. Destinations</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-JNDI-Properties-Format.html">6. JNDI Properties Format</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format.html#JMS-Client-0-8-JNDI-Properties-Format-Conne ctionFactory">6.1. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">6.2. Queue</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">6.3. Topic</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">6.4. Destination</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Connection-URL.html">7. Connection URLs</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Binding-URL.html">8. Binding URL</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Examples">8.1. Binding URL Examples</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-JMS-Queues">8.1.1. Binding URLs for declaring of JMS Queues</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding -URL.html#JMS-Client-0-8-Binding-URL-JMS-Topics">8.1.2. Binding URLs for declaring of JMS Topics</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Topics-Wildcards">8.1.3. Wildcard characters in routing keys for topic destinations</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Extra-Examples">8.1.4. More Examples</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-System-Properties.html">9. System Properties</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Logging.html">10. Logging</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">10.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">10.2. Enabling Debug</a></span></dt></dl></dd><dt><sp an class="appendix"><a href="JMS-Client-0-8-Appendix-Exceptions.html">A. Exceptions</a></span></dt><dt><span class="appendix"><a href="JMS-Client-0-8-Appendix-Maven.html">B. Minimal Maven POM</a></span></dt><dt><span class="appendix"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html">C. JMS Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#JMS-Client-0-8-Appendix-JMS-Extensions-Queue">C.1. Queue Management</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#JMS-Client-0-8-Appendix-JMS-Extensions-Queue-Creation">C.1.1. Queue creation</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html">C.2. Binding Management</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html#JMS-Client-0-8-Appendix-JMS-Extensions-Binding-Creation">C.2.1. Binding creation</a></span></dt ></dl></dd></dl></dd><dt><span class="appendix"><a >href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html">D. >PooledConnectionFactory</a></span></dt><dt><span class="appendix"><a >href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html">E. How to bind >Qpid destinations and connection factories into Tomcat >JNDI</a></span></dt></dl></div><div class="list-of-figures"><p><strong>List >of Figures</strong></p><dl><dt>5.1. <a >href="JMS-Client-0-8-Client-Understanding.html#d0e327">Architecture of a >typical JMS application</a></dt><dt>5.2. <a >href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.html#d0e369">JNDI >overview</a></dt></dl></div><div class="list-of-tables"><p><strong>List of >Tables</strong></p><dl><dt>7.1. <a >href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-Options">Connection > URL Options</a></dt><dt>7.2. <a >href="JMS-Client-0-8-Connection-URL.html#d0e1354">Broker List >Options</a></dt><dt>8.1. <a href="JMS-Client-0-8-Binding-URL.html#d0e1607">Bin ding URL options </a></dt><dt>8.2. <a href="JMS-Client-0-8-Binding-URL.html#d0e1786">Binding URL examples</a></dt><dt>9.1. <a href="JMS-Client-0-8-System-Properties.html#d0e1820">System Properties Affecting Connection Behaviour</a></dt><dt>9.2. <a href="JMS-Client-0-8-System-Properties.html#d0e1911">Config Options For Session Behaviour</a></dt><dt>9.3. <a href="JMS-Client-0-8-System-Properties.html#d0e1976">Config Options For Consumer Behaviour</a></dt><dt>9.4. <a href="JMS-Client-0-8-System-Properties.html#d0e2035">Config Options For Producer Behaviour</a></dt><dt>9.5. <a href="JMS-Client-0-8-System-Properties.html#d0e2128">Config Options For Threading</a></dt><dt>9.6. <a href="JMS-Client-0-8-System-Properties.html#d0e2168">Config Options For I/O</a></dt><dt>9.7. <a href="JMS-Client-0-8-System-Properties.html#d0e2276">Config Options For Security - Using SSL for securing connections or using EXTERNAL as + the SASL mechanism.</a></dt><dt>9.8. <a href="JMS-Client-0-8-System-Properties.html#d0e2341">Config Options For Security - Standard JVM properties needed when Using SSL for + securing connections or using EXTERNAL as the SASL mechanism.</a></dt><dt>A.1. <a href="JMS-Client-0-8-Appendix-Exceptions.html#d0e2495">Exceptions linked to JMSExceptions thrown by JMS methods</a></dt><dt>A.2. <a href="JMS-Client-0-8-Appendix-Exceptions.html#d0e2611">Exceptions linked to JMSExceptions received by ExceptionListeners</a></dt></dl></div><div class="list-of-examples"><p><strong>List of Examples</strong></p><dl><dt>4.1. <a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP-Java">JMS Example - Point to Point Messaging</a></dt><dt>4.2. <a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP-PropertiesFile">JMS Example - Point to Point Messaging - JNDI Properties</a></dt><dt>4.3. <a href="JMS-Client-0-8-Examples-PubSub.html#JMS-Client-0-8-Examples-PubSub-Java">JMS Example - Publish/subscribe Messaging</a></dt><dt>4.4. <a href="JMS-Client-0-8-Examples-PubSub.html#JMS-Client-0-8-Examples-PubSub-PropertiesFile">JMS Example - Publish/subscribe Messagin g - JNDI Properties</a></dt><dt>5.1. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e439">Connection URL configured for failover</a></dt><dt>5.2. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e453">Connection URL configured with nofailover</a></dt><dt>5.3. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e489">Connection URL configured for heartbeating</a></dt><dt>5.4. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e505">Connection URL configured for SSL - CA trusted by JVM</a></dt><dt>5.5. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e521">Connection URL configured for SSL - CA not trusted by JVM</a></dt><dt>5.6. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e537">Connection URL configured for SSL - SSL client-auth</a></dt><dt>5.7. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e552">Connection URL configured for SSL - SSL client-auth (2)</a></dt><dt>7.1. <a href="JMS-C lient-0-8-Connection-URL.html#d0e1329">Broker Lists</a></dt><dt>8.1. <a href="JMS-Client-0-8-Binding-URL.html#d0e1743">Binding URL examples for JMS queues</a></dt><dt>8.2. <a href="JMS-Client-0-8-Binding-URL.html#d0e1761">Binding URL examples for JMS topics</a></dt><dt>B.1. <a href="JMS-Client-0-8-Appendix-Maven.html#d0e2696">Minimal Maven POM </a></dt><dt>C.1. <a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#d0e2723">Creation of an LVQ using the Qpid extension to JMS</a></dt><dt>C.2. <a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html#d0e2738">Binding a queue using JMS</a></dt><dt>D.1. <a href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html#d0e2807">Example of configuring <span class="emphasis"><em>PooledConnectionFactory</em></span> in spring xml + configuration.</a></dt><dt>D.2. <a href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html#d0e2830">Examples of configuring <span class="emphasis"><em>PooledConnectionFactory</em></span> with + <span class="emphasis"><em>DefaultMessageListenerContainer</em></span> and + <span class="emphasis"><em>JmsTemplate</em></span>.</a></dt><dt>E.1. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3045">An example of Tomcat context.xml declaring Qpid JNDI resources</a></dt><dt>E.2. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3069">An example of JNDI lookup for Qpid resources registered in Tomcat JNDI</a></dt><dt>E.3. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3092">An example of Tomcat context.xml declaring Qpid JNDI resources using deprecated <code class="literal">ObjectFactory</code> and deprecated addresses</a></dt></dl></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Introduction.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%"> </td><td align="center" width="20%"> 0;</td><td align="right" valign="top" width="40%"> Chapter 1. Introduction</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/css/style.css URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/css/style.css?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/css/style.css (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/css/style.css Tue Apr 19 11:16:16 2016 @@ -0,0 +1,131 @@ +/* + * + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + * + */ +ul { + list-style-type:square; +} + +th { + font-weight: bold; +} + +.navfooter td { + font-size:10pt; +} + +.navheader td { + font-size:10pt; +} + +body { + margin:0; + background:#FFFFFF; + font-family:"Verdana", sans-serif; + font-size:10pt; +} + +.container { + width:950px; + margin:0 auto; +} + +body a { + color:#000000; +} + + +div.book { + margin-left:10pt; + margin-right:10pt; +} + +div.preface { + margin-left:10pt; + margin-right:10pt; +} + +div.chapter { + margin-left:10pt; + margin-right:10pt; +} + +div.section { + margin-left:10pt; + margin-right:10pt; +} + +div.titlepage { + margin-left:-10pt; + margin-right:-10pt; +} + +.calloutlist td { + font-size:10pt; +} + +.table-contents table { + border-spacing: 0px; +} + +.table-contents td { + font-size:10pt; + padding-left:6px; + padding-right:6px; +} + +.chapter h2.title { + font-size:20pt; + color:#0c3b82; +} + +.chapter .section h2.title { + font-size:18pt; + color:#0c3b82; +} + +.section h2.title { + font-size:16pt; + color:#0c3b82; +} + +.section h3.title { + font-size:14pt; + color:#0c3b82; +} + +.section h4.title { + font-size:12pt; + color:#0c3b82; +} + +.section h5.title { + font-size:12pt; + color:#0c3b82; +} + +.section h6.title { + font-size:12pt; + color:#0c3b82; +} + +.toc a { + font-size:9pt; +} + Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.png URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.png?rev=1739899&view=auto ============================================================================== Binary file - no diff available. Propchange: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.png ------------------------------------------------------------------------------ svn:mime-type = image/png Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.svg URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.svg?rev=1739899&view=auto ============================================================================== Binary file - no diff available. Propchange: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/JndiOverview.svg ------------------------------------------------------------------------------ svn:mime-type = image/svg+xml Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.png URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.png?rev=1739899&view=auto ============================================================================== Binary file - no diff available. Propchange: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.png ------------------------------------------------------------------------------ svn:mime-type = image/png Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.svg URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.svg?rev=1739899&view=auto ============================================================================== Binary file - no diff available. Propchange: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/images/QpidJmsOverview.svg ------------------------------------------------------------------------------ svn:mime-type = image/svg+xml Added: qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/index.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/index.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/index.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/jms-client-0-8/book/index.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,6 @@ +<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</th></tr><tr><td align="left" width="20%"> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Introduction.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="d0e2"></a>Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</h1></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="JMS-Client-0-8-Introduction.html">1. Introduction</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">2. Document Scope And Intended Audience</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">3. Getting the Client And Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html#JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting">3.1. Getting the Client</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">3.2. Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Examples.html">4. Examples</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP">4.1. Point to point example</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Examples-PubSub.html">4.2. Publish/subscribe example</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Client-Understanding.html">5. Understanding the Qpid JMS client</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding.html#JMS-Client-0-8-Client-Understanding-Overview">5.1. Overv iew</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.html">5.2. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html">5.3. Connection</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover">5.3.1. Failover</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Heartbeating">5.3.2. Heartbeating</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-SSL">5.3.3. SSL</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-MessageCompression">5.3.4. Message Compression</a></span></dt ></dl></dd><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html">5.4. >Session</a></span></dt><dd><dl><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-Prefecth">5.4.1. > Prefetch</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-TemporaryQueues">5.4.2. > TemporaryQueues</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-CreateQueue">5.4.3. > CreateQueue</a></span></dt><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-Session.html#JMS-Client-0-8-Client-Understanding-Session-CreateTopic">5.4.4. > CreateTopic</a></span></dt></dl></dd><dt><span class="section"><a >href="JMS-Client-0-8-Client-Understanding-MessageProducer.html">5.5. >MessageProducer</a></span></dt><dd><dl><dt><span class= "section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-MandatoryMessage">5.5.1. Mandatory Messages</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-CloseWhenNoRoute">5.5.2. Close When No Route</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-ImmediateMessage">5.5.3. Immediate Messages</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-FlowControl">5.5.4. Flow Control</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html">5.6. MessageConsumer</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Client-Underst anding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-ConsumerSideEffect">5.6.1. Consumers have Exchange/Queue Declaration and Binding Side Effect</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-TopicSubscriptions">5.6.2. Topic Subscriptions</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-MaximumDeliveryCount">5.6.3. Maximum Delivery Count</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Client-Understanding-Destinations.html">5.7. Destinations</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-JNDI-Properties-Format.html">6. JNDI Properties Format</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format.html#JMS-Client-0-8-JNDI-Properties-Format-Conne ctionFactory">6.1. ConnectionFactory</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">6.2. Queue</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">6.3. Topic</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">6.4. Destination</a></span></dt></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-Connection-URL.html">7. Connection URLs</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Binding-URL.html">8. Binding URL</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Examples">8.1. Binding URL Examples</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-JMS-Queues">8.1.1. Binding URLs for declaring of JMS Queues</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding -URL.html#JMS-Client-0-8-Binding-URL-JMS-Topics">8.1.2. Binding URLs for declaring of JMS Topics</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Topics-Wildcards">8.1.3. Wildcard characters in routing keys for topic destinations</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Extra-Examples">8.1.4. More Examples</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="JMS-Client-0-8-System-Properties.html">9. System Properties</a></span></dt><dt><span class="chapter"><a href="JMS-Client-0-8-Logging.html">10. Logging</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">10.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">10.2. Enabling Debug</a></span></dt></dl></dd><dt><sp an class="appendix"><a href="JMS-Client-0-8-Appendix-Exceptions.html">A. Exceptions</a></span></dt><dt><span class="appendix"><a href="JMS-Client-0-8-Appendix-Maven.html">B. Minimal Maven POM</a></span></dt><dt><span class="appendix"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html">C. JMS Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#JMS-Client-0-8-Appendix-JMS-Extensions-Queue">C.1. Queue Management</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#JMS-Client-0-8-Appendix-JMS-Extensions-Queue-Creation">C.1.1. Queue creation</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html">C.2. Binding Management</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html#JMS-Client-0-8-Appendix-JMS-Extensions-Binding-Creation">C.2.1. Binding creation</a></span></dt ></dl></dd></dl></dd><dt><span class="appendix"><a >href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html">D. >PooledConnectionFactory</a></span></dt><dt><span class="appendix"><a >href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html">E. How to bind >Qpid destinations and connection factories into Tomcat >JNDI</a></span></dt></dl></div><div class="list-of-figures"><p><strong>List >of Figures</strong></p><dl><dt>5.1. <a >href="JMS-Client-0-8-Client-Understanding.html#d0e327">Architecture of a >typical JMS application</a></dt><dt>5.2. <a >href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.html#d0e369">JNDI >overview</a></dt></dl></div><div class="list-of-tables"><p><strong>List of >Tables</strong></p><dl><dt>7.1. <a >href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-Options">Connection > URL Options</a></dt><dt>7.2. <a >href="JMS-Client-0-8-Connection-URL.html#d0e1354">Broker List >Options</a></dt><dt>8.1. <a href="JMS-Client-0-8-Binding-URL.html#d0e1607">Bin ding URL options </a></dt><dt>8.2. <a href="JMS-Client-0-8-Binding-URL.html#d0e1786">Binding URL examples</a></dt><dt>9.1. <a href="JMS-Client-0-8-System-Properties.html#d0e1820">System Properties Affecting Connection Behaviour</a></dt><dt>9.2. <a href="JMS-Client-0-8-System-Properties.html#d0e1911">Config Options For Session Behaviour</a></dt><dt>9.3. <a href="JMS-Client-0-8-System-Properties.html#d0e1976">Config Options For Consumer Behaviour</a></dt><dt>9.4. <a href="JMS-Client-0-8-System-Properties.html#d0e2035">Config Options For Producer Behaviour</a></dt><dt>9.5. <a href="JMS-Client-0-8-System-Properties.html#d0e2128">Config Options For Threading</a></dt><dt>9.6. <a href="JMS-Client-0-8-System-Properties.html#d0e2168">Config Options For I/O</a></dt><dt>9.7. <a href="JMS-Client-0-8-System-Properties.html#d0e2276">Config Options For Security - Using SSL for securing connections or using EXTERNAL as + the SASL mechanism.</a></dt><dt>9.8. <a href="JMS-Client-0-8-System-Properties.html#d0e2341">Config Options For Security - Standard JVM properties needed when Using SSL for + securing connections or using EXTERNAL as the SASL mechanism.</a></dt><dt>A.1. <a href="JMS-Client-0-8-Appendix-Exceptions.html#d0e2495">Exceptions linked to JMSExceptions thrown by JMS methods</a></dt><dt>A.2. <a href="JMS-Client-0-8-Appendix-Exceptions.html#d0e2611">Exceptions linked to JMSExceptions received by ExceptionListeners</a></dt></dl></div><div class="list-of-examples"><p><strong>List of Examples</strong></p><dl><dt>4.1. <a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP-Java">JMS Example - Point to Point Messaging</a></dt><dt>4.2. <a href="JMS-Client-0-8-Examples.html#JMS-Client-0-8-Examples-PTP-PropertiesFile">JMS Example - Point to Point Messaging - JNDI Properties</a></dt><dt>4.3. <a href="JMS-Client-0-8-Examples-PubSub.html#JMS-Client-0-8-Examples-PubSub-Java">JMS Example - Publish/subscribe Messaging</a></dt><dt>4.4. <a href="JMS-Client-0-8-Examples-PubSub.html#JMS-Client-0-8-Examples-PubSub-PropertiesFile">JMS Example - Publish/subscribe Messagin g - JNDI Properties</a></dt><dt>5.1. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e439">Connection URL configured for failover</a></dt><dt>5.2. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e453">Connection URL configured with nofailover</a></dt><dt>5.3. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e489">Connection URL configured for heartbeating</a></dt><dt>5.4. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e505">Connection URL configured for SSL - CA trusted by JVM</a></dt><dt>5.5. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e521">Connection URL configured for SSL - CA not trusted by JVM</a></dt><dt>5.6. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e537">Connection URL configured for SSL - SSL client-auth</a></dt><dt>5.7. <a href="JMS-Client-0-8-Client-Understanding-Connection.html#d0e552">Connection URL configured for SSL - SSL client-auth (2)</a></dt><dt>7.1. <a href="JMS-C lient-0-8-Connection-URL.html#d0e1329">Broker Lists</a></dt><dt>8.1. <a href="JMS-Client-0-8-Binding-URL.html#d0e1743">Binding URL examples for JMS queues</a></dt><dt>8.2. <a href="JMS-Client-0-8-Binding-URL.html#d0e1761">Binding URL examples for JMS topics</a></dt><dt>B.1. <a href="JMS-Client-0-8-Appendix-Maven.html#d0e2696">Minimal Maven POM </a></dt><dt>C.1. <a href="JMS-Client-0-8-Appendix-JMS-Extensions.html#d0e2723">Creation of an LVQ using the Qpid extension to JMS</a></dt><dt>C.2. <a href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html#d0e2738">Binding a queue using JMS</a></dt><dt>D.1. <a href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html#d0e2807">Example of configuring <span class="emphasis"><em>PooledConnectionFactory</em></span> in spring xml + configuration.</a></dt><dt>D.2. <a href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html#d0e2830">Examples of configuring <span class="emphasis"><em>PooledConnectionFactory</em></span> with + <span class="emphasis"><em>DefaultMessageListenerContainer</em></span> and + <span class="emphasis"><em>JmsTemplate</em></span>.</a></dt><dt>E.1. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3045">An example of Tomcat context.xml declaring Qpid JNDI resources</a></dt><dt>E.2. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3069">An example of JNDI lookup for Qpid resources registered in Tomcat JNDI</a></dt><dt>E.3. <a href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html#d0e3092">An example of Tomcat context.xml declaring Qpid JNDI resources using deprecated <code class="literal">ObjectFactory</code> and deprecated addresses</a></dt></dl></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Introduction.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%"> </td><td align="center" width="20%"> 0;</td><td align="right" valign="top" width="40%"> Chapter 1. Introduction</td></tr></table></div></div> \ No newline at end of file Added: qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java (added) +++ qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java Tue Apr 19 11:16:16 2016 @@ -0,0 +1,103 @@ +/* + * + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + * + */ +package org.apache.qpid.example; + +import javax.jms.Connection; +import javax.jms.Destination; +import javax.jms.Message; +import javax.jms.MessageConsumer; +import javax.jms.Session; + +import org.apache.qpid.client.AMQAnyDestination; + +public class Drain extends OptionParser +{ + + static final Option FOREVER = new Option("f", + "forever", + "ignore timeout and wait forever", + null, + null, + Boolean.class); + + static final Option COUNT = new Option ("c", + "count", + "read c messages, then exit", + "COUNT", + "0", + Integer.class); + + + static + { + addOption(BROKER); + addOption(HELP); + addOption(TIMEOUT); + addOption(FOREVER); + addOption(COUNT); + addOption(CON_OPTIONS); + addOption(BROKER_OPTIONS); + } + + public Drain(String[] args, String usage, String desc) throws Exception + { + super(args, usage, desc); + + Connection con = createConnection(); + con.start(); + Session ssn = con.createSession(false,Session.AUTO_ACKNOWLEDGE); + Destination dest = new AMQAnyDestination(getAddress()); + MessageConsumer consumer = ssn.createConsumer(dest); + Message msg; + + long timeout = -1; + int count = 0; + int i = 0; + + if (containsOp(TIMEOUT)) { timeout = Integer.parseInt(getOp(TIMEOUT))*1000; } + if (containsOp(FOREVER)) { timeout = 0; } + if (containsOp(COUNT)) { count = Integer.parseInt(getOp(COUNT)); } + + while ((msg = consumer.receive(timeout)) != null) + { + System.out.println("\n------------- Msg -------------"); + System.out.println(msg); + System.out.println("-------------------------------\n"); + + if (count > 0) { + if (++i == count) { + break; + } + } + } + consumer.close(); + ssn.close(); + con.close(); + } + + public static void main(String[] args) throws Exception + { + String u = "Usage: drain [OPTIONS] 'ADDRESS'"; + String d = "Drains messages from the specified address."; + + new Drain(args,u,d); + } +} Added: qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java.html.in URL: http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java.html.in?rev=1739899&view=auto ============================================================================== --- qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java.html.in (added) +++ qpid/site/input/releases/qpid-java-6.0.2/qpid-jms/examples/Drain.java.html.in Tue Apr 19 11:16:16 2016 @@ -0,0 +1,88 @@ + +<h1>Drain.java</h1> +<div class="highlight"><pre><span></span><span class="kn">package</span> <span class="nn">org.apache.qpid.example</span><span class="o">;</span> + +<span class="kn">import</span> <span class="nn">javax.jms.Connection</span><span class="o">;</span> +<span class="kn">import</span> <span class="nn">javax.jms.Destination</span><span class="o">;</span> +<span class="kn">import</span> <span class="nn">javax.jms.Message</span><span class="o">;</span> +<span class="kn">import</span> <span class="nn">javax.jms.MessageConsumer</span><span class="o">;</span> +<span class="kn">import</span> <span class="nn">javax.jms.Session</span><span class="o">;</span> + +<span class="kn">import</span> <span class="nn">org.apache.qpid.client.AMQAnyDestination</span><span class="o">;</span> + +<span class="kd">public</span> <span class="kd">class</span> <span class="nc">Drain</span> <span class="kd">extends</span> <span class="n">OptionParser</span> +<span class="o">{</span> + + <span class="kd">static</span> <span class="kd">final</span> <span class="n">Option</span> <span class="n">FOREVER</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Option</span><span class="o">(</span><span class="s">"f"</span><span class="o">,</span> + <span class="s">"forever"</span><span class="o">,</span> + <span class="s">"ignore timeout and wait forever"</span><span class="o">,</span> + <span class="kc">null</span><span class="o">,</span> + <span class="kc">null</span><span class="o">,</span> + <span class="n">Boolean</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> + + <span class="kd">static</span> <span class="kd">final</span> <span class="n">Option</span> <span class="n">COUNT</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Option</span> <span class="o">(</span><span class="s">"c"</span><span class="o">,</span> + <span class="s">"count"</span><span class="o">,</span> + <span class="s">"read c messages, then exit"</span><span class="o">,</span> + <span class="s">"COUNT"</span><span class="o">,</span> + <span class="s">"0"</span><span class="o">,</span> + <span class="n">Integer</span><span class="o">.</span><span class="na">class</span><span class="o">);</span> + + + <span class="kd">static</span> + <span class="o">{</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">BROKER</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">HELP</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">TIMEOUT</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">FOREVER</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">COUNT</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">CON_OPTIONS</span><span class="o">);</span> + <span class="n">addOption</span><span class="o">(</span><span class="n">BROKER_OPTIONS</span><span class="o">);</span> + <span class="o">}</span> + + <span class="kd">public</span> <span class="nf">Drain</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">,</span> <span class="n">String</span> <span class="n">usage</span><span class="o">,</span> <span class="n">String</span> <span class="n">desc</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> + <span class="o">{</span> + <span class="kd">super</span><span class="o">(</span><span class="n">args</span><span class="o">,</span> <span class="n">usage</span><span class="o">,</span> <span class="n">desc</span><span class="o">);</span> + + <span class="n">Connection</span> <span class="n">con</span> <span class="o">=</span> <span class="n">createConnection</span><span class="o">();</span> + <span class="n">con</span><span class="o">.</span><span class="na">start</span><span class="o">();</span> + <span class="n">Session</span> <span class="n">ssn</span> <span class="o">=</span> <span class="n">con</span><span class="o">.</span><span class="na">createSession</span><span class="o">(</span><span class="kc">false</span><span class="o">,</span><span class="n">Session</span><span class="o">.</span><span class="na">AUTO_ACKNOWLEDGE</span><span class="o">);</span> + <span class="n">Destination</span> <span class="n">dest</span> <span class="o">=</span> <span class="k">new</span> <span class="n">AMQAnyDestination</span><span class="o">(</span><span class="n">getAddress</span><span class="o">());</span> + <span class="n">MessageConsumer</span> <span class="n">consumer</span> <span class="o">=</span> <span class="n">ssn</span><span class="o">.</span><span class="na">createConsumer</span><span class="o">(</span><span class="n">dest</span><span class="o">);</span> + <span class="n">Message</span> <span class="n">msg</span><span class="o">;</span> + + <span class="kt">long</span> <span class="n">timeout</span> <span class="o">=</span> <span class="o">-</span><span class="mi">1</span><span class="o">;</span> + <span class="kt">int</span> <span class="n">count</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span> + <span class="kt">int</span> <span class="n">i</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span> + + <span class="k">if</span> <span class="o">(</span><span class="n">containsOp</span><span class="o">(</span><span class="n">TIMEOUT</span><span class="o">))</span> <span class="o">{</span> <span class="n">timeout</span> <span class="o">=</span> <span class="n">Integer</span><span class="o">.</span><span class="na">parseInt</span><span class="o">(</span><span class="n">getOp</span><span class="o">(</span><span class="n">TIMEOUT</span><span class="o">))*</span><span class="mi">1000</span><span class="o">;</span> <span class="o">}</span> + <span class="k">if</span> <span class="o">(</span><span class="n">containsOp</span><span class="o">(</span><span class="n">FOREVER</span><span class="o">))</span> <span class="o">{</span> <span class="n">timeout</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span> <span class="o">}</span> + <span class="k">if</span> <span class="o">(</span><span class="n">containsOp</span><span class="o">(</span><span class="n">COUNT</span><span class="o">))</span> <span class="o">{</span> <span class="n">count</span> <span class="o">=</span> <span class="n">Integer</span><span class="o">.</span><span class="na">parseInt</span><span class="o">(</span><span class="n">getOp</span><span class="o">(</span><span class="n">COUNT</span><span class="o">));</span> <span class="o">}</span> + + <span class="k">while</span> <span class="o">((</span><span class="n">msg</span> <span class="o">=</span> <span class="n">consumer</span><span class="o">.</span><span class="na">receive</span><span class="o">(</span><span class="n">timeout</span><span class="o">))</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">)</span> + <span class="o">{</span> + <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"\n------------- Msg -------------"</span><span class="o">);</span> + <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="n">msg</span><span class="o">);</span> + <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"-------------------------------\n"</span><span class="o">);</span> + + <span class="k">if</span> <span class="o">(</span><span class="n">count</span> <span class="o">></span> <span class="mi">0</span><span class="o">)</span> <span class="o">{</span> + <span class="k">if</span> <span class="o">(++</span><span class="n">i</span> <span class="o">==</span> <span class="n">count</span><span class="o">)</span> <span class="o">{</span> + <span class="k">break</span><span class="o">;</span> + <span class="o">}</span> + <span class="o">}</span> + <span class="o">}</span> + <span class="n">consumer</span><span class="o">.</span><span class="na">close</span><span class="o">();</span> + <span class="n">ssn</span><span class="o">.</span><span class="na">close</span><span class="o">();</span> + <span class="n">con</span><span class="o">.</span><span class="na">close</span><span class="o">();</span> + <span class="o">}</span> + + <span class="kd">public</span> <span class="kd">static</span> <span class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> + <span class="o">{</span> + <span class="n">String</span> <span class="n">u</span> <span class="o">=</span> <span class="s">"Usage: drain [OPTIONS] 'ADDRESS'"</span><span class="o">;</span> + <span class="n">String</span> <span class="n">d</span> <span class="o">=</span> <span class="s">"Drains messages from the specified address."</span><span class="o">;</span> + + <span class="k">new</span> <span class="n">Drain</span><span class="o">(</span><span class="n">args</span><span class="o">,</span><span class="n">u</span><span class="o">,</span><span class="n">d</span><span class="o">);</span> + <span class="o">}</span> +<span class="o">}</span> +</pre></div> + +<p><a href="Drain.java">Download this file</a></p> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
