http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding.html deleted file mode 100644 index e435fde..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding.html +++ /dev/null @@ -1,142 +0,0 @@ -<!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>Chapter 5. Understanding the Qpid JMS client - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 5. Understanding the Qpid JMS client</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 5. Understanding the Qpid JMS client</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Examples-PubSub.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.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-Client-Understanding"></a>Chapter 5. Understanding the Qpid JMS client</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-Client-Understanding.html#JMS-Client-0-8-Client-Understanding-Overview">5.1. Overview</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Client-Understa nding-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></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. Pre fetch</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#J MS-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-Understanding-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></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-Client-Understanding-Overview"></a>5.1. Overview</h2></div></div></div><p>The Qpid JMS client provides a JMS 1.1 compliant implementation. As such, the primary - source of documentation is the <a class="ulink" href="http://download.oracle.com/otndocs/jcp/7195-jms-1.1-fr-spec-oth-JSpec/" target="_top">JMS specification</a> and the - <a class="ulink" href="http://docs.oracle.com/javaee/6/api//javax/jms/package-summary.html" target="_top">JMS javadocs</a>. This - documentation assumes the reader has familiarity with these resources.</p><p>The remainder of this section describes how the Qpid JMS client behaves and the effect(s) - making JMS method calls will have on the Broker. </p><p>There areas where the Qpid JMS client provides features beyond those required for JMS - compliance. These are described in the sections that follow.</p><p>These sections are also used to bring out differences that may surprise those moving from - JMS implementations provided by other vendors.</p><div class="figure"><a id="idp3293984"></a><p class="title"><strong>Figure 5.1. Architecture of a typical JMS application</strong></p><div class="figure-contents"><div class="mediaobject"><img alt="Architecture of a typical JMS application" src="images/QpidJmsOverview.png" /></div></div></div><br class="figure-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-Examples-PubSub.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Client-Understanding-ConnectionFactory.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">4.2. Publish/subscribe example </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 5.2.  ConnectionFactory</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html deleted file mode 100644 index 2f0e4ef..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html +++ /dev/null @@ -1,208 +0,0 @@ -<!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>Chapter 7. Connection URLs - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 7. Connection URLs</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 7. Connection URLs</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Binding-URL.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-Connection-URL"></a>Chapter 7. Connection URLs</h1></div></div></div><p> In JNDI properties, a Connection URL specifies options for a connection. The format for a - Connection URL is: </p><pre class="programlisting">amqp://[<user>:<pass>@][<clientid>]<virtualhost>[?<option>='<value>'[&<option>=&'<value>']]</pre><p> For instance, the following Connection URL specifies a user name, a password, a client - ID, a virtual host ("test"), a broker list with a single broker: a TCP host with the host - name <span class="quote">“<span class="quote">localhost</span>”</span> using port 5672: </p><pre class="programlisting">amqp://username:password@clientid/test?brokerlist='tcp://localhost:5672'</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Connection option quoting</h3><p>Take care with the quoting surrounding option values. Each option value - <span class="emphasis"><em>must</em></span> be surrounded with single quotes ('). </p></div><p>The Connection URL supports the following options:</p><div class="table"><a id="JMS-Client-0-8-Connection-URL-Options"></a><p class="title"><strong>Table 7.1. Connection URL Options</strong></p><div class="table-contents"><table border="1" summary="Connection URL Options" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th> Option </th><th> Type </th><th> Description </th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist"></a> brokerlist </td><td> see below </td><td> List of one or more broker addresses. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Maxprefetch"></a> maxprefetch </td><td> integer </td><td> - <p> The maximum number of pre-fetched messages per Session. If not - specified, default value of 500 is used. </p> - <p> Note: You can also set the default per-session prefetch value on a - client-wide basis by configuring the client using <a class="link" href="JMS-Client-0-8-System-Properties.html" title="Chapter 9. System Properties">Java system - properties.</a> - </p> - </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-UseLegacyMap"></a> use_legacy_map_msg_format </td><td> Boolean </td><td> If you are using JMS Map messages and deploying a new client with any - JMS client older than 0.8 release, you must set this to true to ensure the - older clients can understand the map message encoding. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-Failover"></a> failover </td><td> {'singlebroker' | 'roundrobin' - , | 'nofailover' | - '<class>'} </td><td> - <p> This option controls failover behaviour. The method - <code class="literal">singlebroker</code> uses only the first broker in the - list, <code class="literal">roundrobin</code> will try each broker given in the - broker list until a connection is established, - <code class="literal">nofailover</code> - disables all retry and failover logic. Any other value is interpreted as - a classname which must implement the - <code class="literal">org.apache.qpid.jms.failover.FailoverMethod</code> - interface. </p> - <p> The broker list options <code class="literal">retries</code> and - <code class="literal">connectdelay</code> (described below) determine the - number of times a connection to a broker will be retried and the - length of time to wait between successive connection attempts before - moving on to the next broker in the list. The failover option - <code class="literal">cyclecount</code> controls the number of times to loop - through the list of available brokers before finally giving up. </p> - <p> Defaults to <code class="literal">roundrobin</code> if the brokerlist contains - multiple brokers, or <code class="literal">singlebroker</code> otherwise. </p> - </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-ConnectionOptions-CloseWhenNoRoute"></a> closeWhenNoRoute </td><td> boolean </td><td> - <p>See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-CloseWhenNoRoute" title="5.5.2. Close When No Route">Section 5.5.2, “Close When No Route”</a>.</p> - </td></tr><tr><td> ssl </td><td> boolean </td><td> - <p> If <code class="literal">ssl='true'</code>, use SSL for all broker connections. - Overrides any per-broker settings in the brokerlist (see below) entries. - If not specified, the brokerlist entry for each given broker is used to - determine whether SSL is used. </p> - <p> Introduced in version 0.22. </p> - </td></tr></tbody></table></div></div><br class="table-break" /><p> Broker lists are specified using a URL in this format: </p><pre class="programlisting">brokerlist=<transport>://<host>[:<;port>](?<param>='<value>')(&<param>='<value>')*</pre><p> For instance, this is a typical broker list: </p><pre class="programlisting">brokerlist='tcp://localhost:5672'</pre><p> A broker list can contain more than one broker address; if so, the connection is made to - the first broker in the list that is available. - </p><div class="example"><a id="idp236736"></a><p class="title"><strong>Example 7.1. Broker Lists</strong></p><div class="example-contents"><p>A broker list can specify properties to be used when connecting to the broker. This - broker list specifies options for configuring heartbeating</p><pre class="programlisting">amqp://guest:guest@test/test?brokerlist='tcp://ip1:5672?heartbeat='5''</pre><p>This broker list specifies some SSL options</p><pre class="programlisting">amqp://guest:guest@test/test?brokerlist='tcp://ip1:5672?ssl='true'&ssl_cert_alias='cert1''</pre><p> This broker list specifies two brokers using the connectdelay and retries broker - options. It also illustrates the failover connection URL property. </p><pre class="programlisting">amqp://guest:guest@/test?failover='roundrobin?cyclecount='2'' - &brokerlist='tcp://ip1:5672?retries='5'&connectdelay='2000';tcp://ip2:5672?retries='5'&connectdelay='2000'' - </pre></div></div><br class="example-break" /><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Broker option quoting</h3><p>Take care with the quoting surrounding broker option values. Each broker option value - <span class="emphasis"><em>must</em></span> be surrounded with their own single quotes ('). This is in - addition to the quotes surround the connection option value.</p></div><p>The following broker list options are supported.</p><div class="table"><a id="idp244064"></a><p class="title"><strong>Table 7.2. Broker List Options</strong></p><div class="table-contents"><table border="1" summary="Broker List Options" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th> Option </th><th> Type </th><th> Description </th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-Heartbeat"></a> heartbeat </td><td> Long </td><td> Frequency of heartbeat messages (in seconds). A value of 0 disables - heartbeating. <p>For compatibility with old client configuration, option - <code class="varname">idle_timeout</code> (in milliseconds) is also - supported.</p> - </td></tr><tr><td> ssl </td><td> Boolean </td><td> - <p>If <code class="literal">ssl='true'</code>, the JMS client will encrypt the - connection to this broker using SSL.</p> - <p>This can also be set/overridden for all brokers using the Connection - URL option <code class="literal">ssl</code>.</p> - </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TrustStore"></a> trust_store </td><td> String </td><td> Path to trust store. Used when using SSL and the Broker's certificate is - signed by a private-CA (or a self-signed certificate),</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TrustStorePassword"></a> trust_store_password </td><td> String </td><td> Trust store password. Password used to open the trust store. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-KeyStore"></a> key_store </td><td> String </td><td> Path to key store . Used when using SSL and the client must authenticate - using client-auth. If the store contains more than one certificate, - <code class="literal">ssl_cert_alias</code> must be used to identify the - certificate that the client must present to the Broker.</td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-KeyStorePassword"></a> key_store_password </td><td> String </td><td> Key store password. Password used to open the key store. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-SslCertAlias"></a> ssl_cert_alias </td><td> String </td><td> If multiple certificates are present in the keystore, the alias will be - used to extract the correct certificate. </td></tr><tr><td> ssl_verify_hostname </td><td> Boolean </td><td> When using SSL you can enable hostname verification by using - <code class="literal">ssl_verify_hostname='true'</code> in the broker URL. - </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-Retries"></a> retries </td><td> Integer </td><td> The number of times to retry connection to each broker in the broker - list. Defaults to 1. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectDelay"></a> connectdelay </td><td> integer </td><td> Length of time (in milliseconds) to wait before attempting to reconnect. - Defaults to 0. </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectTimeout"></a> connecttimeout </td><td> integer </td><td> Length of time (in milliseconds) to wait for the socket connection to - succeed. A value of 0 represents an infinite timeout, i.e. the connection - attempt will block until established or an error occurs. Defaults to 30000. - </td></tr><tr><td><a id="JMS-Client-0-8-Connection-URL-BrokerOptions-TcpNoDelay"></a> tcp_nodelay </td><td> Boolean </td><td> If <code class="literal">tcp_nodelay='true'</code>, TCP packet batching is - disabled. Defaults to true since Qpid 0.14. </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-JNDI-Properties-Format-Destination.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Binding-URL.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.4. Destination </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 8. Binding URL</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html deleted file mode 100644 index eef4e76..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Document-Scope-And-Intended-Audience.html +++ /dev/null @@ -1,151 +0,0 @@ -<!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>Chapter 2. Document Scope And Intended Audience - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 2. Document Scope And Intended Audience</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 2. Document Scope And Intended Audience</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Introduction.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.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-Document-Scope-And-Intended-Audience"></a>Chapter 2. Document Scope And Intended Audience</h1></div></div></div><p> The intended audience of this document is Java developers who are familiar with the JMS - specification. Readers are not required to know all the details of AMQP protocols. However, some - knowledge of AMQP basic concepts would be advantageous for reading of this document. </p><p> This document only covers the usage of 0-8, 0-9 and 0-9-1 AMQP protocols with Qpid JMS - client. The specifications for these protocols are available from the <a class="ulink" href="http://www.amqp.org" target="_top">AMQP web site</a>. </p><p> The document covers some specific implementation details of JMS connections, sessions, - consumers and producers in <a class="xref" href="JMS-Client-0-8-Client-Understanding.html" title="Chapter 5. Understanding the Qpid JMS client">Chapter 5, <em>Understanding the Qpid JMS client</em></a>. It also - demonstrates how to write a simple point to point and simple publish/subscribe application using - Qpid JMS Client in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter 4. Examples">Chapter 4, <em>Examples</em></a>. </p><p>The Qpid JMS Client supports various configuration options which can be set via JVM system - properties, connection URLs and JNDI configuration file. The setting of system properties is - described in <a class="xref" href="JMS-Client-0-8-System-Properties.html" title="Chapter 9. System Properties">Chapter 9, <em>System Properties</em></a>. The details of supported - options within the connection URLs are given in <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Chapter 7, <em>Connection URLs</em></a>. - The details of Qpid JMS client JNDI properties format is provided in <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format.html" title="Chapter 6. JNDI Properties Format">Chapter 6, <em>JNDI Properties Format</em></a>. The Qpid destination URL format is covered - in <a class="xref" href="JMS-Client-0-8-Binding-URL.html" title="Chapter 8. Binding URL">Chapter 8, <em>Binding URL</em></a>. </p><p>The Qpid JMS Client can be used for writing of JMS vendor neutral messaging applications. - However, in some cases it might be required to use specific AMQP features. Thus, the Qpid client - provides the extended operation set to invoke those features. </p><p> - <a class="xref" href="JMS-Client-0-8-Logging.html" title="Chapter 10. Logging">Chapter 10, <em>Logging</em></a> provides the details about turning on client logging - which can help in debugging of various issues while developing the messaging applications. </p><p>The details about Qpid JMS Client Exceptions are provided in <a class="xref" href="JMS-Client-0-8-Appendix-Exceptions.html" title="Appendix A. Exceptions">Appendix A, <em>Exceptions</em></a></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-Introduction.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 1. Introduction </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 3. Getting the Client And Dependencies</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html deleted file mode 100644 index 5521d52..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html +++ /dev/null @@ -1,208 +0,0 @@ -<!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>4.2. Publish/subscribe example - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>4.2. Publish/subscribe example</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">4.2. Publish/subscribe example</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Examples.html">Prev</a> </td><th align="center" width="60%">Chapter 4. Examples</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Client-Understanding.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-Examples-PubSub"></a>4.2. Publish/subscribe example</h2></div></div></div><p>In this second example, we illustrate publish/subscribe messaging. Again, we create a - JNDI context using a properties file, use the context to lookup a connection factory, - create and start a connection, create a session, and lookup a destination (a topic) from - the JNDI context. Then we create a producer and two durable subscribers , send a message - with the producer. Both subscribers receive the same message.</p><div class="example"><a id="JMS-Client-0-8-Examples-PubSub-Java"></a><p class="title"><strong>Example 4.3. JMS Example - Publish/subscribe Messaging</strong></p><div class="example-contents"><pre class="programlisting"> -import javax.jms.*; -import javax.naming.Context; -import javax.naming.InitialContext; - -import java.util.Properties; - -public class StocksExample { - - public StocksExample() { - } - - public static void main(String[] args) throws Exception { - StocksExample stocks = new StocksExample(); - stocks.runTest(); - } - - private void runTest() throws Exception { - Properties properties = new Properties(); - properties.load(this.getClass().getResourceAsStream("stocks.properties")); - Context context = new InitialContext(properties); - - ConnectionFactory connectionFactory - = (ConnectionFactory) context.lookup("qpidConnectionFactory"); - Connection connection = connectionFactory.createConnection(); - connection.start(); - - Session session = connection.createSession(true, Session.SESSION_TRANSACTED); - Topic priceTopic = (Topic) context.lookup("myprices"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-destination" id="pubsub-java-destination">(1)</a> - - MessageConsumer subscriber1 = session.createDurableSubscriber(priceTopic, "sub1"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-subscribers" id="pubsub-java-subscribers">(2)</a> - MessageConsumer subscriber2 = session.createDurableSubscriber(priceTopic, "sub2" /*, "price > 150", false*/ ); - MessageProducer messageProducer = session.createProducer(priceTopic); - - Message message = session.createMessage(); - message.setStringProperty("instrument", "IBM"); - message.setIntProperty("price", 100); - messageProducer.send(message); - session.commit(); - - message = subscriber1.receive(1000); - session.commit(); - System.out.println("Subscriber 1 received : " + message); - - message = subscriber2.receive(1000); - session.commit(); - System.out.println("Subscriber 2 received : " + message); - - session.unsubscribe("sub1"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-unsubscribe" id="pubsub-java-unsubscribe">(3)</a> - session.unsubscribe("sub2"); - connection.close(); - context.close(); - } -} - </pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-destination"></a><a href="#pubsub-java-destination">(1)</a> </p></td><td align="left" valign="top"><p>Looks up a destination for the topic with JNDI name myprices.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-subscribers"></a><a href="#pubsub-java-subscribers">(2)</a> </p></td><td align="left" valign="top"><p>Creates two durable subscribers, <code class="literal">sub1</code> and - <code class="literal">sub2</code>. Durable subscriptions retain messages for the - client even when the client is disconnected, until the subscription is - unsubscribed. Subscription 2 has a (commented out) message selector argument so - you can conveniently experiement with the effect of those. <a class="footnote" href="#ftn.idp5872992" id="idp5872992"><sup class="footnote">[2]</sup></a></p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-unsubscribe"></a><a href="#pubsub-java-unsubscribe">(3)</a> </p></td><td align="left" valign="top"><p>Unsubscribes the two durable subscribers, permanently removing the knowledge - of the subscriptions from the system. An application would normally - <span class="emphasis"><em>NOT</em></span> do this. The typical use-case for durable - subsciption is one where the subscription exists over an extended period of - time.</p></td></tr></table></div><p>The contents of the <code class="literal">stocks.properties</code> file are shown below.</p><div class="example"><a id="JMS-Client-0-8-Examples-PubSub-PropertiesFile"></a><p class="title"><strong>Example 4.4. JMS Example - Publish/subscribe Messaging - JNDI Properties</strong></p><div class="example-contents"><pre class="programlisting"> -java.naming.factory.initial = org.apache.qpid.jndi.PropertiesFileInitialContextFactory -connectionfactory.qpidConnectionFactory = amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672' -topic.myprices = prices <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-properties-destination" id="pubsub-properties-destination">(1)</a> - </pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-pubsub-properties-destination"></a><a href="#pubsub-properties-destination">(1)</a> </p></td><td align="left" valign="top"><p>Defines a topic for which MessageProducers and/or MessageConsumers send and - receive messages. The format of this entry is described in <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html" title="6.3. Topic">Section 6.3, “Topic”</a>.</p></td></tr></table></div><div class="footnotes"><br /><hr align="left" width="100" /><div class="footnote" id="ftn.idp5872992"><p><a class="para" href="#idp5872992"><sup class="para">[2] </sup></a>Each durable subscription is implemented as a queue on the Broker. See - <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-TopicSubscriptions" title="5.6.2. Topic Subscriptions">Section 5.6.2, “Topic Subscriptions”</a> for details.</p></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-Examples.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Examples.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Client-Understanding.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 4. Examples </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 5. Understanding the Qpid JMS client</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples.html deleted file mode 100644 index 37a693b..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Examples.html +++ /dev/null @@ -1,210 +0,0 @@ -<!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>Chapter 4. Examples - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 4. Examples</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 4. Examples</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Examples-PubSub.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-Examples"></a>Chapter 4. Examples</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-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></div><p>The fol lowing programs shows how to send and receive messages using the Qpid JMS client. - The first program illustrates a <span class="emphasis"><em>point to point</em></span> example, the second, a - pubish/subscribe example. </p><p>Both examples show the use JNDI to obtain connection factory and destination objects which - the application needs. In this way the configuration is kept separate from the application - code itself.</p><p>The example code will be straightforward for anyone familiar with Java JMS. Readers in - need of an introduction are directed towards <a class="ulink" href="http://docs.oracle.com/javaee/6/tutorial/doc/bncdq.html" target="_top">Oracle's JMS - tutorial</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-Examples-PTP"></a>4.1. Point to point example</h2></div></div></div><p>In this example, we illustrate point to point messaging. We create a JNDI context - using a properties file, use the context to lookup a connection factory, create and - start a connection, create a session, and lookup a destination (a queue) from the JNDI - context. Then we create a producer and a consumer, send a message with the producer and - receive it with the consumer.</p><div class="example"><a id="JMS-Client-0-8-Examples-PTP-Java"></a><p class="title"><strong>Example 4.1. JMS Example - Point to Point Messaging</strong></p><div class="example-contents"><pre class="programlisting"> -import javax.jms.*; -import javax.naming.Context; -import javax.naming.InitialContext; -import java.util.Properties; - -public class Hello { - - public Hello() { - } - - public static void main(String[] args) throws Exception { - Hello hello = new Hello(); - hello.runTest(); - } - - private void runTest() throws Exception { - Properties properties = new Properties(); - properties.load(this.getClass().getResourceAsStream("helloworld.properties")); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties" id="ptp-java-properties">(1)</a> - Context context = new InitialContext(properties); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-context" id="ptp-java-context">(2)</a> - - ConnectionFactory connectionFactory - = (ConnectionFactory) context.lookup("qpidConnectionFactory"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection-factory" id="ptp-java-connection-factory">(3)</a> - Connection connection = connectionFactory.createConnection(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection" id="ptp-java-connection">(4)</a> - connection.start(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-start" id="ptp-java-start">(5)</a> - - Session session = connection.createSession(true, Session.SESSION_TRANSACTED); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-session" id="ptp-java-session">(6)</a> - Queue queue = (Queue) context.lookup("myqueue"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-destination" id="ptp-java-destination">(7)</a> - - MessageConsumer messageConsumer = session.createConsumer(queue); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-consumer" id="ptp-java-consumer">(8)</a> - MessageProducer messageProducer = session.createProducer(queue); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-producer" id="ptp-java-producer">(9)</a> - - TextMessage message = session.createTextMessage("Hello world!"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-send" id="ptp-java-send">(10)</a> - messageProducer.send(message); - session.commit(); - - message = (TextMessage)messageConsumer.receive(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-receive" id="ptp-java-receive">(11)</a> - session.commit(); - System.out.println(message.getText()); - - connection.close(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-close" id="ptp-java-close">(12)</a> - context.close(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-jndi-close" id="ptp-java-jndi-close">(13)</a> - } -} - </pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties"></a><a href="#ptp-java-properties">(1)</a> </p></td><td align="left" valign="top"><p>Loads the JNDI properties file, which specifies the connection factory, queues - and topics. See <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format.html" title="Chapter 6. JNDI Properties Format">Chapter 6, <em>JNDI Properties Format</em></a> for - details.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-context"></a><a href="#ptp-java-context">(2)</a> </p></td><td align="left" valign="top"><p>Creates the JNDI initial context.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-connection-factory"></a><a href="#ptp-java-connection-factory">(3)</a> </p></td><td align="left" valign="top"><p>Looks up a JMS connection factory for Qpid.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-connection"></a><a href="#ptp-java-connection">(4)</a> </p></td><td align="left" valign="top"><p>Creates a JMS connection. Creating the JMS connections establishes the - connection to the Broker.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-start"></a><a href="#ptp-java-start">(5)</a> </p></td><td align="left" valign="top"><p>Starts the connection, required for the consumption of messages.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-session"></a><a href="#ptp-java-session">(6)</a> </p></td><td align="left" valign="top"><p>Creates a transactional session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-destination"></a><a href="#ptp-java-destination">(7)</a> </p></td><td align="left" valign="top"><p>Looks up a destination for the queue with JNDI name <span class="emphasis"><em>myqueue</em></span>.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-consumer"></a><a href="#ptp-java-consumer">(8)</a> </p></td><td align="left" valign="top"><p>Creates a consumer that reads messages from the queue<a class="footnote" href= "#ftn.idp25408" id="idp25408"><sup class="footnote">[1]</sup></a>.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-producer"></a><a href="#ptp-java-producer">(9)</a> </p></td><td align="left" valign="top"><p>Creates a producer that sends messages to the queue.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-send"></a><a href="#ptp-java-send">(10)</a> </p></td><td align="left" valign="top"><p>Creates a new message of type <span class="emphasis"><em>javax.jms.TextMessage</em></span>, publishes the message and commits the - session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-receive"></a><a href="#ptp-java-receive">(11)</a> </p></td><td align="left" valign="top"><p>Reads the next available message (awaiting indefinitely if necessary) and - commits the session.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-close"></a><a href="#ptp-java-close">(12)</a> </p></td><td align="left" valign="top"><p>Closes the Connection. All sessions owned by the Connection along with their - MessageConsumers and MessageProducers are automatically closed. The connection - to the Broker is closed as this point.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-jndi-close"></a><a href="#ptp-java-jndi-close">(13)</a> </p></td><td align="left" valign="top"><p>Closes the JNDI context.</p></td></tr></table></div><p>The contents of the <code class="literal">helloworld.properties</code> file are shown - below.</p><div class="example"><a id="JMS-Client-0-8-Examples-PTP-PropertiesFile"></a><p class="title"><strong>Example 4.2. JMS Example - Point to Point Messaging - JNDI Properties</strong></p><div class="example-contents"><pre class="programlisting"> -java.naming.factory.initial = org.apache.qpid.jndi.PropertiesFileInitialContextFactory -connectionfactory.qpidConnectionFactory = amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672' <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties-connectionfactory" id="ptp-properties-connectionfactory">(1)</a> -queue.myqueue = queue1 <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties-destination" id="ptp-properties-destination">(2)</a> - </pre></div></div><br class="example-break" /><div class="calloutlist"><table border="0" summary="Callout list"><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties-connectionfactory"></a><a href="#ptp-properties-connectionfactory">(1)</a> </p></td><td align="left" valign="top"><p>Defines a connection factory from which Connections can be created. The syntax - of a ConnectionURL is given in <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Chapter 7, <em>Connection URLs</em></a>.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-properties-destination"></a><a href="#ptp-properties-destination">(2)</a> </p></td><td align="left" valign="top"><p>Defines a queue for which MessageProducers and/or MessageConsumers send and - receive messages. The format of these entries is described in <a class="xref" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html" title="6.2. Queue">Section 6.2, “Queue”</a>.</p></td></tr></table></div></div><div class="footnotes"><br /><hr align="left" width="100" /><div class="footnote" id="ftn.idp25408"><p><a class="para" href="#idp25408"><sup class="para">[1] </sup></a>Creating consumer will automatically create the queue on the Broker - and bind it to an exchange. Specifically, in this case as the - <code class="literal">queue.</code> form is used in the JNDI properties the - effect will be to create a queue called <code class="literal">queue1</code> on the - Broker, and create a binding between the <code class="literal">amq.direct</code> - exchange and this queue using the queue's name. This process is - described in detail in <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageConsumer.html#JMS-Client-0-8-Client-Understanding-MessageConsumer-ConsumerSideEffect" title="5.6.1. Consumers have Exchange/Queue Declaration and Binding Side Effect">Section 5.6.1, “Consumers have Exchange/Queue Declaration and Binding Side Effect”</a></p></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-JMS-Getting-And-Dependencies-Dependencies.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Examples-PubSub.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">3.2. Dependencies </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 4.2. Publish/subscribe example</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Introduction.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Introduction.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Introduction.html deleted file mode 100644 index 036a2c5..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Introduction.html +++ /dev/null @@ -1,145 +0,0 @@ -<!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>Chapter 1. Introduction - Apache Qpid™</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]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </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> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 1. Introduction</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 1. Introduction</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="index.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.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-Introduction"></a>Chapter 1. Introduction</h1></div></div></div><p>Qpid JMS client is an implementation of <a class="ulink" href="http://download.oracle.com/otndocs/jcp/7195-jms-1.1-fr-spec-oth-JSpec/" target="_top">JMS specification - 1.1</a>. It utilises an <a class="ulink" href="http://www.amqp.org" target="_top">AMQP</a> transport layer for the performing of messaging operations. - The client is intended to be used for the writing of JMS compatible messaging applications. Such - applications can send and receive messages via any AMQP-compatible brokers like RabbitMQ, Qpid - Java Broker which support the AMQP protocols 0-8, 0-9, or 0-9-1.</p><p>The Qpid JMS client hides the details of AMQP transport implementation behind the JMS API. - Thus, the developers need only to be familiar with JMS API in order to use the client. However, - the knowledge of the basic concepts of AMQP protocols can help developers in writing reliable - and high-performant messaging application. </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Using the Qpid JMS client with 0-10</h3><p>This book documents the behaviour of the Qpid JMS client when used with the AMQP - protocols <span class="emphasis"><em>0-8, 0-9, and 0-9-1</em></span> only. For behaviour when using the client - with AMQP 0-10 protocol, please refer to <a class="ulink" href="/releases/qpid-0.26/programming/book/index.html" target="_top">Programming in Apache Qpid</a>.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="index.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1 </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 2. Document Scope And Intended Audience</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="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - 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> - </body> -</html> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org