Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,187 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;A.&#160;Exceptions - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 
0-9-1</a></li><li>Appendix&#160;A.&#160;Exceptions</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;A.&#160;Exceptions</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Prev</a>&#160;</td><th 
align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-Maven.html">Next</a></td></tr></table><hr 
/></div><div class="appendix"><div class="titlepage"><div><div><h1 
class="title"><a 
id="JMS-Client-0-8-Appendix-Exceptions"></a>Appendix&#160;A.&#160;Exceptions</h1></div></div></div><p>The
 methods of Qpid JMS Client throw <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/JMSException.html"; 
target="_top">JMSExceptions</a> in response to error
+    conditions. Typically the exception's message (#getMessage()) summarises 
the error condition,
+    with contextual information being provided by the messages of linked 
exception(s). To understand
+    the problem, it is important to read the messages associated with <span 
class="emphasis"><em>all</em></span> the
+    linked exceptions.</p><p>The following table describes some of the more 
common exceptions linked to JMSException
+    thrown by JMS methods whilst using the client:</p><div class="table"><a 
id="idm140185669434624"></a><p 
class="title"><strong>Table&#160;A.1.&#160;Exceptions linked to JMSExceptions 
thrown by JMS methods</strong></p><div class="table-contents"><table border="1" 
summary="Exceptions linked to JMSExceptions thrown by JMS methods" 
width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Linked 
Exception</th><th>Message</th><th>Explanation/Common 
Causes</th></tr></thead><tbody><tr><td>AMQUnresolvedAddressException</td><td><span
 class="emphasis"><em>message varies</em></span></td><td><p>Indicates that the 
hostname included in the Connection URL's <a class="link" 
href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>,
 could not be resolved, . This could mean that the hostname is
+              mispelt, or there is name resolution 
problem.</p></td></tr><tr><td>AMQConnectionFailure</td><td>Connection 
refused</td><td><p>Indicates that the host included in the Connection URL's <a 
class="link" 
href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>,
 actively refused the connection. This could mean that the
+              hostname and/or port number is incorrect, or the Broker may not 
be
+            running.</p></td></tr><tr><td>AMQConnectionFailure</td><td>connect 
timed out</td><td><p>Indicates that the host included in the Connection URL's 
<a class="link" 
href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>,
 could not be contacted within the <a class="link" 
href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectTimeout">connecttimeout</a>.
 This could mean that the host is shutdown, or a networking
+              routing problem means the host is 
unreachable.</p></td></tr><tr><td>AMQConnectionFailure</td><td>General SSL 
Problem; PKIX path building failed; unable to find valid certification
+            path to requested target</td><td><p>Indicates that the CA that 
signed the Broker's certificate is not trusted by
+              the JVM of the client. If the Broker is using a private-CA (or a 
self signed
+              certificate) check that the client has been properly configured 
with a truststore. See
+                <a class="xref" 
href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-SSL"
 title="5.3.3.&#160;SSL">Section&#160;5.3.3, 
&#8220;SSL&#8221;</a></p></td></tr><tr><td>AMQConnectionFailure / 
AMQAuthenticationException</td><td>not allowed</td><td><p>Indicates that the 
user cannot be authenticated by the Broker. Check the
+              username and/or password elements within the <a class="link" 
href="JMS-Client-0-8-Connection-URL.html" 
title="Chapter&#160;7.&#160;Connection URLs">Connection 
URL</a>.</p></td></tr><tr><td>AMQConnectionFailure / 
AMQSecurityException</td><td>Permission denied: <span 
class="emphasis"><em>virtualhost name</em></span>; access 
refused</td><td><p>Indicates that the user is not authorised to connect to the 
given
+              virtualhost. The user is recognised by the Broker and is using 
the correct password
+              but does not have permission. This exception normally indicates 
that the user (or
+              group) has not been permissioned within the Broker's <a 
class="ulink" href="../../java-broker/book/Java-Broker-Security-ACLs.html" 
target="_top">Access Control List
+                
(ACL)</a>.</p></td></tr><tr><td>AMQTimeoutException</td><td>Server did not 
respond in a timely fashion; Request Timeout</td><td><p>Indicates that the 
broker did not respond to a request sent by the client in
+              a reasonable length of time. The timeout is governed by <a 
class="link" 
href="JMS-Client-0-8-System-Properties.html#JMS-Client-0-8-System-Properties-SyncOpTimeout"><code
 class="literal">qpid.sync_op_timeout</code></a>.</p><p>This can be a symptom
+              of a heavily loaded broker that cannot respond or the Broker may 
have failed in
+              unexpected manner. Check the broker and the host on which it 
runs and performance of
+              its 
storage.</p></td></tr><tr><td>AMQSecurityException</td><td>Permission denied: 
<span class="emphasis"><em>message varies</em></span></td><td><p>Indicates that 
the user is not authorised to use the given resource or
+              perform the given operation. This exception normally indicates 
that the user (or
+              group) has not been permissioned within the Broker's <a 
class="ulink" href="../../java-broker/book/Java-Broker-Security-ACLs.html" 
target="_top">Access Control List
+                (ACL)</a>.</p></td></tr></tbody></table></div></div><br 
class="table-break" /><p>The following table describes some of the more common 
exceptions linked to JMSException sent
+    to <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jmx/ExceptionListener.html"; 
target="_top">ExceptionListener</a>
+    instances.</p><div class="table"><a id="idm140185672145408"></a><p 
class="title"><strong>Table&#160;A.2.&#160;Exceptions linked to JMSExceptions 
received by ExceptionListeners</strong></p><div class="table-contents"><table 
border="1" summary="Exceptions linked to JMSExceptions received by 
ExceptionListeners" width="100%"><colgroup><col /><col /><col 
/></colgroup><thead><tr><th>Linked 
Exception</th><th>Message</th><th>Explanation/Common 
Causes</th></tr></thead><tbody><tr><td><a 
id="JMS-Client-0-8-Appendix-Exceptions-AMQNoRouteException"></a>AMQNoRouteException</td><td>No
 Route for message [Exchange: <span class="emphasis"><em>exchange 
name</em></span>, Routing key:
+              <span class="emphasis"><em>routing key</em></span>] [error code 
312: no route]</td><td><p>Indicate that the named exchange is unable to route a 
message to at least one
+              queue.</p>
+            <p>This will occur if a queue has been improperly bound to an 
exchange. Use the
+              Broker's management interface to check the bindings. 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.&#160;Mandatory Messages">Section&#160;5.5.1, &#8220;Mandatory 
Messages&#8221;</a></p></td></tr><tr><td><a 
id="JMS-Client-0-8-Appendix-Exceptions-AMQNoConsumersException"></a>AMQNoConsumersException</td><td>Immediate
 delivery is not possible. [error code 313: no consumers]</td><td><p>Immediate 
delivery was requested by the MessageProducer, but as there are no
+              consumers on any target queue, the message has been returned to 
the publisher. 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.&#160;Immediate Messages">Section&#160;5.5.3, &#8220;Immediate 
Messages&#8221;</a>
+            </p></td></tr><tr><td>AMQDisconnectedException</td><td>Server 
closed connection and reconnection not permitted</td><td><p>Indicates that the 
connection was closed by the Broker, and as <a class="link" 
href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover"
 title="5.3.1.&#160;Failover">failover
+                options</a> are not included in the Connection URL, the client 
has been unable to
+              reestablish connection.</p>
+            <p>The Connection is now closed and any attempt to use either 
Connection object, or
+              any objects created from the Connection will receive an <a 
class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/IllegalStateException.html"; 
target="_top">IllegalStateException</a>.</p></td></tr><tr><td><a 
id="JMS-Client-0-8-Appendix-Exceptions-AMQDisconnectedException"></a>AMQDisconnectedException</td><td>Server
 closed connection and no failover was successful</td><td><p>Indicates that the 
connection was closed by the Broker. The client has tried
+              failover according to the rules of the <a class="link" 
href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover"
 title="5.3.1.&#160;Failover">failover
+                options</a>within the Connection URL, but these attempts were 
all
+              unsuccessful.</p>
+            <p>The Connection is now closed and any attempt to use either 
Connection object, or
+              any objects created from the Connection will receive an <a 
class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/IllegalStateException.html"; 
target="_top">IllegalStateException</a>.</p></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-Logging-EnablingDebugLogging.html">Prev</a>&#160;</td><td 
align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-Maven.html">Next</a></td></tr><tr><td 
align="left" valign="top" width="40%">10.2.&#160;Enabling Debug&#160;</td><td 
align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td 
align="right" valign="top" width="40%">&#160;Appendix&#160;B.&#160;Minimal 
Maven POM</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,163 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>C.2.&#160;Binding Management - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>C.2.&#160;Binding 
Management</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">C.2.&#160;Binding Management</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="JMS-Client-0-8-Appendix-JMS-Extensions.html">Prev</a>&#160;</td><th 
align="center" width="60%">Appendix&#160;C.&#160;JMS Extensions</th><td 
align="right" width="20%">&#160;<a accesskey="n" 
href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html">Next</a></td></tr></table><hr
 /></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="JMS-Client-0-8-Appendix-JMS-Extensions-Binding"></a>C.2.&#160;Binding 
Management</h2></div></div></div><p>These extensions allow bindings to be 
created or removed.</p><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="JMS-Client-0-8-Appendix-JMS-Extensions-Binding-Creation"></a>C.2.1.&#160;Binding
 creation</h3></div></div></div><p>The following example illustrates the 
 creation of queue binding to topic exchange with
+        JMS client.</p><div class="example"><a id="idm140185673965072"></a><p 
class="title"><strong>Example&#160;C.2.&#160;Binding a queue using 
JMS</strong></p><div class="example-contents"><pre 
class="programlisting">ConnectionFactory connectionFactory = ...
+Connection connection = connectionFactory.createConnection();
+AMQSession&lt;?, ?&gt; session = 
(AMQSession&lt;?,?&gt;)connection.createSession(false, 
Session.AUTO_ACKNOWLEDGE);
+
+...
+
+AMQShortString queueName = new AMQShortString("testQueue");
+AMQShortString routingKey = new AMQShortString("testRoutingKey");
+AMQDestination destination = (AMQDestination) 
session.createQueue(queueName.asString());
+
+...
+
+// binding arguments
+Map&lt;String, Object&gt; arguments = new HashMap&lt;String, Object&gt;();
+arguments.put("x-filter-jms-selector", "application='app1'");
+
+// create binding
+session.bindQueue(queueName, routingKey, 
FieldTable.convertToFieldTable(arguments),
+    new AMQShortString("amq.topic"), destination);</pre></div></div><br 
class="example-break" /></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-Appendix-JMS-Extensions.html">Prev</a>&#160;</td><td 
align="center" width="20%"><a accesskey="u" 
href="JMS-Client-0-8-Appendix-JMS-Extensions.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html">Next</a></td></tr><tr><td
 align="left" valign="top" width="40%">Appendix&#160;C.&#160;JMS 
Extensions&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;Appendix&#160;D.&#160;PooledConnectionFactory</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,158 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;C.&#160;JMS Extensions - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Appendix&#160;C.&#160;JMS 
Extensions</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;C.&#160;JMS Extensions</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="JMS-Client-0-8-Appendix-Maven.html">Prev</a>&#160;</td><th align="center" 
width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" 
href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html">Next</a></td></tr></table><hr
 /></div><div class="appendix"><div class="titlepage"><div><div><h1 
class="title"><a 
id="JMS-Client-0-8-Appendix-JMS-Extensions"></a>Appendix&#160;C.&#160;JMS 
Extensions</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-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-C
 lient-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></div><p>This section 
illustrates using Qpid specific extentions to JMX for the managament of queues,
+  exchanges and bindings.</p><div class="important" style="margin-left: 0.5in; 
margin-right: 0.5in;"><h3 class="title">Important</h3><p>It is not recommended 
that these extensions are generally used. These interfaces are
+      subject to change and will not be supported in this form for AMQP 1.0. 
Instead, the reader is
+      directed towards the Managment interfaces of the Broker.</p></div><div 
class="section"><div class="titlepage"><div><div><h2 class="title"><a 
id="JMS-Client-0-8-Appendix-JMS-Extensions-Queue"></a>C.1.&#160;Queue 
Management</h2></div></div></div><p>These extensions allow queues to be created 
or removed.</p><div class="section"><div class="titlepage"><div><div><h3 
class="title"><a 
id="JMS-Client-0-8-Appendix-JMS-Extensions-Queue-Creation"></a>C.1.1.&#160;Queue
 creation</h3></div></div></div><p>The following example illustrates the 
creation of the a LVQ queue from a
+        javax.jms.Session object. Note that this utilises a Qpid specific 
extension to JMS and
+        involves casting the session object back to its Qpid 
base-class.</p><div class="example"><a id="idm140185674616528"></a><p 
class="title"><strong>Example&#160;C.1.&#160;Creation of an LVQ using the Qpid 
extension to JMS</strong></p><div class="example-contents"><pre 
class="programlisting">Map&lt;String,Object&gt; arguments = new 
HashMap&lt;String, Object&gt;();
+arguments.put("qpid.last_value_queue_key","ISIN");
+AMQDestination amqQueue = (AMQDestination) context.lookup("myqueue");
+((AMQSession&lt;?,?&gt;) session).createQueue(
+        AMQShortString.valueOf(amqQueue.getQueueName()),
+        amqQueue.isAutoDelete(),
+        amqQueue.isDurable(),
+        amqQueue.isExclusive(),
+        arguments);
+</pre></div></div><br class="example-break" /></div></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-Appendix-Maven.html">Prev</a>&#160;</td><td align="center" 
width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" 
href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html">Next</a></td></tr><tr><td
 align="left" valign="top" width="40%">Appendix&#160;B.&#160;Minimal Maven 
POM&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;C.2.&#160;Binding Management</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,175 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;B.&#160;Minimal Maven POM - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Appendix&#160;B.&#160;Minimal 
Maven POM</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;B.&#160;Minimal Maven POM</th></tr><tr><td 
align="left" width="20%"><a accesskey="p" 
href="JMS-Client-0-8-Appendix-Exceptions.html">Prev</a>&#160;</td><th 
align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-JMS-Extensions.html">Next</a></td></tr></table><hr
 /></div><div class="appendix"><div class="titlepage"><div><div><h1 
class="title"><a 
id="JMS-Client-0-8-Appendix-Maven"></a>Appendix&#160;B.&#160;Minimal Maven 
POM</h1></div></div></div><p> The following is a minimal Maven POM required to 
use the Qpid Client. It is suitable for
+    use with the <a class="link" href="JMS-Client-0-8-Examples.html" 
title="Chapter&#160;4.&#160;Examples">examples</a> included in this
+    book.</p><div class="example"><a id="idm140185670152352"></a><p 
class="title"><strong>Example&#160;B.1.&#160;Minimal Maven POM 
</strong></p><div class="example-contents"><pre class="programlisting">
+    
+&lt;project xmlns="http://maven.apache.org/POM/4.0.0"; 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;
+  &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+  &lt;groupId&gt;test&lt;/groupId&gt;
+  &lt;artifactId&gt;test&lt;/artifactId&gt;
+  &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+  &lt;dependencies&gt;
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.qpid&lt;/groupId&gt;
+      &lt;artifactId&gt;qpid-client&lt;/artifactId&gt;
+      &lt;version&gt;6.0.0&lt;/version&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
+      &lt;artifactId&gt;slf4j-log4j12&lt;/artifactId&gt;
+      &lt;version&gt;1.6.4&lt;/version&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.geronimo.specs&lt;/groupId&gt;
+      &lt;artifactId&gt;geronimo-jms_1.1_spec&lt;/artifactId&gt;
+      &lt;version&gt;1.1.1&lt;/version&gt;
+    &lt;/dependency&gt;
+  &lt;/dependencies&gt;
+&lt;/project&gt;
+    
+  </pre></div></div><br class="example-break" /><p>Note: We use the SLF4J 
Binding for Log4J12 here, but any SLF4J Binding could be used
+    instead. Similarly, Geronimo JMS Spec is used, but any dependency that 
provides the JMS 1.1
+    specification could be subsituted.</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-Appendix-Exceptions.html">Prev</a>&#160;</td><td 
align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-JMS-Extensions.html">Next</a></td></tr><tr><td 
align="left" valign="top" 
width="40%">Appendix&#160;A.&#160;Exceptions&#160;</td><td align="center" 
width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" 
valign="top" width="40%">&#160;Appendix&#160;C.&#160;JMS 
Extensions</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-PooledConnecytionFactory.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-PooledConnecytionFactory.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-PooledConnecytionFactory.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-PooledConnecytionFactory.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,195 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;D.&#160;PooledConnectionFactory - Apache 
Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 
0-9-1</a></li><li>Appendix&#160;D.&#160;PooledConnectionFactory</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;D.&#160;PooledConnectionFactory</th></tr><tr><td 
align="left" width="20%"><a accesskey="p" 
href="JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html">Prev</a>&#160;</td><th
 align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html">Next</a></td></tr></table><hr
 /></div><div class="appendix"><div class="titlepage"><div><div><h1 
class="title"><a 
id="JMS-Client-0-8-Appendix-PooledConnecytionFactory"></a>Appendix&#160;D.&#160;PooledConnectionFactory</h1></div></div></div><p>Qpid
 client provides <code class="literal">PooledConnectionFactory</code> which is 
a special
+    implementation of <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html"; 
target="_top">ConnectionFactory</a> supporting <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/Connection.html"; 
target="_top">Connection</a> pooling. </p><p> The <code 
class="literal">PooledConnectionFactory</code> caches a predefined number of 
connections
+    thus saving an application which connects frequently time. The <code 
class="literal">Connection</code>
+    instance is taken from the pool whenever method
+      <code class="literal">PooledConnectionFactory#createConnection()</code> 
is invoked and returned into the
+    pool when method <code class="literal">Connection#close()</code> is 
called.</p><p>A user can configure a maximum allowed number of connections to 
remain in pool (10 by
+    default) by calling <code 
class="literal">PooledConnectionFactory#setMaxPoolSize(int)</code>. When number
+    of connections exceeds the value set for maximum pool size,
+      <code class="literal">PooledConnectionFactory</code> starts to work as a 
normal <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html"; 
target="_top">ConnectionFactory</a> and creates
+    a new connection every time method <code 
class="literal">PooledConnectionFactory#createConnection()</code>
+    is invoked.</p><p>The <a class="link" 
href="JMS-Client-0-8-Connection-URL.html" 
title="Chapter&#160;7.&#160;Connection URLs">Connection URL</a> is set by 
invoking
+    method <code 
class="literal">PooledConnectionFactory#setConnectionURLString(String)</code>.</p><p>A
 user can specify the maximum time a connection may remain idle in pool by 
calling
+      <code 
class="literal">PooledConnectionFactory#setConnectionTimeout(long)</code> 
passing a value in
+    milliseconds. If connection is not used within the specified interval it 
is closed
+    automatically. </p><p>This implementation can be useful in <span 
class="emphasis"><em>Spring JMS</em></span> based applications. An
+    example below demonstrates how to configure <code 
class="literal">PooledConnectionFactory</code> in the
+    Spring xml configuration. </p><div class="example"><a 
id="idm140185673840496"></a><p 
class="title"><strong>Example&#160;D.1.&#160;Example of configuring <span 
class="emphasis"><em>PooledConnectionFactory</em></span> in spring xml
+        configuration.</strong></p><div class="example-contents"><pre 
class="programlisting">
+&lt;bean id="pooledConnectionFactory" 
class="org.apache.qpid.client.PooledConnectionFactory"&gt;
+  &lt;!-- set maximum number of pool connections to 20--&gt;
+  &lt;property name="maxPoolSize" value="20"&gt;&lt;/property&gt;
+  &lt;!-- set the timeout for connection to remain open in pool without being 
used --&gt;
+  &lt;property name="connectionTimeout" value="60000"&gt;&lt;/property&gt;
+  &lt;!-- set connection URL as String --&gt;
+  &lt;property name="connectionURLString" 
value="amqp://guest:guest@clientid/default?brokerlist='tcp://localhost:5672?retries='300'&amp;amp;failover='nofailover''&amp;amp;maxprefetch='0'"&gt;&lt;/property&gt;
+&lt;/bean&gt;</pre></div></div><p><br class="example-break" />
+  </p><p>
+    <span class="emphasis"><em>PooledConnectionFactory</em></span> spring bean 
can be configured with such
+      <span class="emphasis"><em>spring-jms</em></span> beans like
+      <span class="emphasis"><em>DefaultMessageListenerContainer</em></span> 
and <span class="emphasis"><em>JmsTemplate</em></span>. The
+    example below demonstrates how to do that </p><div class="example"><a 
id="idm140185672199200"></a><p 
class="title"><strong>Example&#160;D.2.&#160;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>.</strong></p><div 
class="example-contents"><pre class="programlisting">
+&lt;bean id="jmsProducerTemplate" 
class="org.springframework.jms.core.JmsTemplate"&gt;
+    &lt;!-- set reference to pooledConnectionFactory bean --&gt;
+    &lt;property name="connectionFactory" 
ref="pooledConnectionFactory"&gt;&lt;/property&gt;
+    &lt;property name="defaultDestination" ref="destination" /&gt;
+&lt;/bean&gt;
+
+&lt;bean id="jmsContainer" 
class="org.springframework.jms.listener.DefaultMessageListenerContainer"&gt;
+    &lt;!-- set reference to pooledConnectionFactory bean --&gt;
+    &lt;property name="connectionFactory" ref="pooledConnectionFactory"/&gt;
+    &lt;property name="destination" ref="destination"/&gt;
+    &lt;property name="messageListener" ref="messageListener" /&gt;
+&lt;/bean&gt;</pre></div></div><p><br class="example-break" />
+  </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 
class="title">Note</h3><p>If using <code 
class="literal">DefaultMessageListenerContainer</code> with
+        <code class="literal">cacheLevel</code> set to <code 
class="literal">NONE</code> it is important that
+        <code class="literal">maxConcurrentConsumer</code> does not exceed the 
value of maximum pool size set
+      on <code class="literal">PooledConnectionFactory</code> bean. If this is 
not the case, once the number
+      of in-use connections reaches the the <span 
class="emphasis"><em>PooledConnectionFactory#maxPoolSize</em></span>
+      a new connection will be opened for each and every message receipt i.e. 
a connection per
+      message anti-pattern.</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-Appendix-JMS-Extensions-Binding.html">Prev</a>&#160;</td><td
 align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a 
accesskey="n" 
href="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html">Next</a></td></tr><tr><td
 align="left" valign="top" width="40%">C.2.&#160;Binding 
Management&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;Appendix&#160;E.&#160;How to bind Qpid destinations and 
connection factories into Tomcat JNDI</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/jms-client-0-8/book/JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,266 @@
+<!DOCTYPE html>
+<!--
+ -
+ - 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.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;E.&#160;How to bind Qpid destinations and connection 
factories into Tomcat JNDI - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/jms-client-0-8/book/index.html">Qpid JMS Client 
for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Appendix&#160;E.&#160;How to 
bind Qpid destinations and connection factories into Tomcat JNDI</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;E.&#160;How to bind Qpid destinations and connection 
factories into Tomcat JNDI</th></tr><tr><td align="left" width="20%"><a 
accesskey="p" 
href="JMS-Client-0-8-Appendix-PooledConnecytionFactory.html">Prev</a>&#160;</td><th
 align="center" width="60%">&#160;</th><td align="right" 
width="20%">&#160;</td></tr></table><hr /></div><div class="appendix"><div 
class="titlepage"><div><div><h1 class="title"><a 
id="JMS-Client-0-8-Appendix-Tomcat-JNDI-Integration"></a>Appendix&#160;E.&#160;How
 to bind Qpid destinations and connection factories into Tomcat 
JNDI</h1></div></div></div><p>
+      Qpid client destinations and connection factories can be registered in 
external JNDI containers, for example, Tomcat JNDI implementation.
+  </p><p>
+    <code class="literal">org.apache.qpid.jndi.ObjectFactory</code> implements
+    <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/spi/ObjectFactory.html";
 target="_top">javax.naming.spi.ObjectFactory</a>
+    allowing it to create instances of <code 
class="literal">AMQConnectionFactory</code>, <code 
class="literal">PooledConnectionFactory</code>,
+    <code class="literal">AMQConnection</code>, <code 
class="literal">AMQQueue</code> and <code class="literal">AMQTopic</code> in 
external JNDI container from
+    <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/Reference.html"; 
target="_top">javax.naming.Reference</a>s.
+  </p><p>Additionally,
+    <code class="literal">AMQConnectionFactory</code>, <code 
class="literal">PooledConnectionFactory</code> and <code 
class="literal">AMQDestination</code> (parent of
+    <code class="literal">AMQQueue</code> and <code 
class="literal">AMQTopic</code>) implement
+    <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/Referenceable.html"; 
target="_top">javax.naming.Referenceable</a>
+    allowing creation of <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/Reference.html"; 
target="_top">javax.naming.Reference</a> objects
+    for binding in external JNDI implementations.
+  </p><p>
+    <code class="literal">org.apache.qpid.jndi.ObjectFactory</code> allows the 
creation of:
+    </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li 
class="listitem"><p>
+          an instance of <code class="literal">ConnectionFactory</code> from a 
<code class="literal">Reference</code> containing reference
+          address (<a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/RefAddr.html"; 
target="_top">javax.naming.RefAddr</a>)
+          <code class="literal">connectionURL</code> with content set to a
+          <a class="link" href="JMS-Client-0-8-Connection-URL.html" 
title="Chapter&#160;7.&#160;Connection URLs">Connection URL</a>.
+        </p></li><li class="listitem"><p>
+          an instance of <code class="literal">PooledConnectionFactory</code> 
from a <code class="literal">Reference</code> containing reference
+          address (<a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/RefAddr.html"; 
target="_top">javax.naming.RefAddr</a>)
+          <code class="literal">connectionURL</code> with content set to a
+          <a class="link" href="JMS-Client-0-8-Connection-URL.html" 
title="Chapter&#160;7.&#160;Connection URLs">Connection URL</a>.
+        </p></li><li class="listitem"><p>
+          an instance of <code class="literal">AMQConnection</code> from a 
<code class="literal">Reference</code> containing reference
+          address (<a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/RefAddr.html"; 
target="_top">javax.naming.RefAddr</a>)
+          <code class="literal">connectionURL</code> with content set to a
+          <a class="link" href="JMS-Client-0-8-Connection-URL.html" 
title="Chapter&#160;7.&#160;Connection URLs">Connection URL</a>.
+        </p></li><li class="listitem"><p>
+          an instance of <code class="literal">AMQQueue</code> from a <code 
class="literal">Reference</code> containing reference
+          address (<a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/RefAddr.html"; 
target="_top">javax.naming.RefAddr</a>)
+          <code class="literal">address</code> with content set to either <a 
class="ulink" href="../../../qpid-0.32/programming/book/" 
target="_top">Address</a> or
+          <a class="link" href="JMS-Client-0-8-Binding-URL.html" 
title="Chapter&#160;8.&#160;Binding URL">Binding URL</a>.
+        </p></li><li class="listitem"><p>
+          an instance of <code class="literal">AMQTopic</code> from a <code 
class="literal">Reference</code> containing reference
+          address (<a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/RefAddr.html"; 
target="_top">javax.naming.RefAddr</a>)
+          <code class="literal">address</code> with content set to either <a 
class="ulink" href="../../../qpid-0.32/programming/book/" 
target="_top">Address</a> or
+          <a class="link" href="JMS-Client-0-8-Binding-URL.html" 
title="Chapter&#160;8.&#160;Binding URL">Binding URL</a>.
+        </p></li></ul></div><p>
+    </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 
class="title">Note</h3><p>
+        For  <code class="literal">AMQQueue</code> and <code 
class="literal">AMQTopic</code> prefix <code class="literal">BURL:</code> need
+        to be specified for <a class="link" 
href="JMS-Client-0-8-Binding-URL.html" title="Chapter&#160;8.&#160;Binding 
URL">Binding URL</a>. Otherwise, client will try
+        to parse content using <a class="ulink" 
href="../../../qpid-0.32/programming/book/" target="_top">Address</a> format.
+      </p></div><p>
+  </p><p>An example below demonstrates how to create JNDI resources in the 
Tomcat container using Resource declarations in context.xml
+    (A Tomcat specific web application configuration file usually added into 
war under /META-INF/context.xml).
+  </p><div class="example"><a id="idm140185672304432"></a><p 
class="title"><strong>Example&#160;E.1.&#160;An example of Tomcat context.xml 
declaring Qpid JNDI resources</strong></p><div class="example-contents"><pre 
class="programlisting">
+&lt;?xml version='1.0' encoding='utf-8'?&gt;
+&lt;!DOCTYPE xml&gt;
+&lt;Context&gt;
+
+  &lt;Resource name="jms/connectionFactory" auth="Container"
+            type="org.apache.qpid.client.AMQConnectionFactory"
+            factory="org.apache.qpid.jndi.ObjectFactory"
+            
connectionURL="amqp://guest:guest@clientid/?brokerlist='localhost:5672'"/&gt;
+
+  &lt;Resource name="jms/pooledConnectionFactory" auth="Container"
+            type="org.apache.qpid.client.PooledConnectionFactory"
+            factory="org.apache.qpid.jndi.ObjectFactory"
+            
connectionURL="amqp://guest:guest@clientid/?brokerlist='localhost:5672'"
+            maxPoolSize="20" connectionTimeout="60000"/&gt;
+
+  &lt;Resource name="jms/queue" auth="Container"
+            type="org.apache.qpid.client.AMQQueue"
+            factory="org.apache.qpid.jndi.ObjectFactory"
+            address="BURL:direct://amq.direct//myQueue?durable='true'"/&gt;
+
+  &lt;Resource name="jms/topic" auth="Container"
+            type="org.apache.qpid.client.AMQTopic"
+            factory="org.apache.qpid.client.AMQConnectionFactory"
+            address="BURL:topic://amq.topic//myTopic?routingkey='myTopic'"/&gt;
+
+&lt;/Context&gt;</pre></div></div><br class="example-break" /><p>In the 
example above <code class="literal">AMQConnectionFactory</code> would be 
registered under JNDI name "jms/connectionFactory",
+    <code class="literal">PooledConnectionFactory</code> would be registered 
under JNDI name "jms/pooledConnectionFactory",
+    <code class="literal">Queue</code> "myQueue" would be registered under 
JNDI name "jms/queue" and JMS <code class="literal">Topic</code>
+   destination "myTopic" would be registered under JNDI name "jms/topic". (All 
resources will be bound under "java:comp/env").
+    On declaration of <code class="literal">PooledConnectionFactory</code> 
optional maxPoolSize and connectionTimeout are set to
+    20 and 60000 milliseconds accordingly.
+  </p><p>
+    The client application can find the resources declared in Tomcat 
context.xml using the code below:
+  </p><div class="example"><a id="idm140185669425696"></a><p 
class="title"><strong>Example&#160;E.2.&#160;An example of JNDI lookup for Qpid 
resources registered in Tomcat JNDI</strong></p><div 
class="example-contents"><pre class="programlisting">
+    Context context = new InitialContext();
+    Context environmentContext = (Context)context.lookup("java:comp/env");
+    ...
+    ConnectionFactory connectionFactory = (ConnectionFactory) 
environmentContext.lookup("jms/connectionFactory");
+    ...
+    Queue queue = (Queue)environmentContext.lookup("jms/queue");
+    ...
+    Topic topic = (Topic)environmentContext.lookup("jms/topic");
+    ...</pre></div></div><br class="example-break" /><div class="note" 
style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
+      In order to support backward compatibility <code 
class="literal">AMQConnectionFactory</code> continues to implement
+      <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/spi/ObjectFactory.html";
 target="_top">javax.naming.spi.ObjectFactory</a>
+      and can be used to instantiate JNDI resources from
+      <a class="ulink" 
href="http://docs.oracle.com/javase/7/docs/api/javax/naming/Reference.html"; 
target="_top">javax.naming.Reference</a>s.
+      However, its method <code class="literal">getObjectInstance</code> is 
marked as <code class="literal">Deprecated</code> and will be
+      removed in future version of client. For backward compatibility, Qpid 
JNDI resources can be declared using fully
+      qualified class names as addresses. That will became unsupported in 
future version as well.
+      An example of Tomcat context.xml with declarations of JNDI resources 
using deprecated factory and addresses is provided below.
+  </p><div class="example"><a id="idm140185669419056"></a><p 
class="title"><strong>Example&#160;E.3.&#160;An example of Tomcat context.xml 
declaring Qpid JNDI resources using deprecated <code 
class="literal">ObjectFactory</code> and deprecated addresses</strong></p><div 
class="example-contents"><pre class="programlisting">
+&lt;?xml version='1.0' encoding='utf-8'?&gt;
+&lt;!DOCTYPE xml&gt;
+&lt;Context&gt;
+
+  &lt;Resource name="jms/queue" auth="Container"
+            type="org.apache.qpid.client.AMQQueue"
+            factory="org.apache.qpid.client.AMQConnectionFactory"
+            
org.apache.qpid.client.AMQQueue="direct://amq.direct//myDurableQueue?durable='true'"/&gt;
+
+  &lt;Resource name="jms/topic" auth="Container"
+            type="org.apache.qpid.client.AMQTopic"
+            factory="org.apache.qpid.client.AMQConnectionFactory"
+            
org.apache.qpid.client.AMQTopic="topic://amq.topic//myTopic?routingkey='myTopic'"/&gt;
+
+  &lt;Resource name="jms/connectionFactory" auth="Container"
+            type="org.apache.qpid.client.AMQConnectionFactory"
+            factory="org.apache.qpid.client.AMQConnectionFactory"
+            
org.apache.qpid.client.AMQConnectionFactory="amqp://guest:guest@clientid/?brokerlist='localhost:5672'"/&gt;
+
+&lt;/Context&gt;</pre></div></div><p><br class="example-break" />
+    </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-Appendix-PooledConnecytionFactory.html">Prev</a>&#160;</td><td
 align="center" width="20%">&#160;</td><td align="right" 
width="40%">&#160;</td></tr><tr><td align="left" valign="top" 
width="40%">Appendix&#160;D.&#160;PooledConnectionFactory&#160;</td><td 
align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td 
align="right" valign="top" width="40%">&#160;</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to