Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html Sat Jan 2 23:59:48 2016 @@ -114,7 +114,7 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/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 id="-middle-content"> - <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 + <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" style="clear: both"><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 @@ -146,9 +146,9 @@ public class StocksExample { 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> + Topic priceTopic = (Topic) context.lookup("myprices"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-destination" id="pubsub-java-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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 subscriber1 = session.createDurableSubscriber(priceTopic, "sub1"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-subscribers" id="pubsub-java-subscribers"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></a> MessageConsumer subscriber2 = session.createDurableSubscriber(priceTopic, "sub2" /*, "price > 150", false*/ ); MessageProducer messageProducer = session.createProducer(priceTopic); @@ -166,27 +166,27 @@ public class StocksExample { 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("sub1"); <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-unsubscribe" id="pubsub-java-unsubscribe"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></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 + </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"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></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.idm139643152596880" id="idm139643152596880"><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 + you can conveniently experiement with the effect of those. <a class="footnote" href="#ftn.d0e277" id="d0e277"><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"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></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.idm139643152596880"><p><a class="para" href="#idm139643152596880"><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> +topic.myprices = prices <a class="co" href="JMS-Client-0-8-Examples-PubSub.html#callout-pubsub-properties-destination" id="pubsub-properties-destination"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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 style="width:100; text-align:left;margin-left: 0" /><div class="footnote" id="ftn.d0e277"><p><a class="para" href="#d0e277"><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="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 5. Understanding the Qpid JMS client</td></tr></table></div></div> <hr/>
Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples.html Sat Jan 2 23:59:48 2016 @@ -119,8 +119,8 @@ https://github.com/apache/qpid-proton/bl 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 + need of an introduction are directed towards <a class="link" 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" style="clear: both"><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 @@ -142,53 +142,53 @@ public class Hello { 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> + properties.load(this.getClass().getResourceAsStream("helloworld.properties")); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties" id="ptp-java-properties"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> + Context context = new InitialContext(properties); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-context" id="ptp-java-context"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></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> + = (ConnectionFactory) context.lookup("qpidConnectionFactory"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection-factory" id="ptp-java-connection-factory"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></a> + Connection connection = connectionFactory.createConnection(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-connection" id="ptp-java-connection"><span><img alt="4" border="0" src="images/callouts/4.png" /></span></a> + connection.start(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-start" id="ptp-java-start"><span><img alt="5" border="0" src="images/callouts/5.png" /></span></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> + 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"><span><img alt="6" border="0" src="images/callouts/6.png" /></span></a> + Queue queue = (Queue) context.lookup("myqueue"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-destination" id="ptp-java-destination"><span><img alt="7" border="0" src="images/callouts/7.png" /></span></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> + MessageConsumer messageConsumer = session.createConsumer(queue); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-consumer" id="ptp-java-consumer"><span><img alt="8" border="0" src="images/callouts/8.png" /></span></a> + MessageProducer messageProducer = session.createProducer(queue); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-producer" id="ptp-java-producer"><span><img alt="9" border="0" src="images/callouts/9.png" /></span></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> + TextMessage message = session.createTextMessage("Hello world!"); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-send" id="ptp-java-send"><span><img alt="10" border="0" src="images/callouts/10.png" /></span></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> + message = (TextMessage)messageConsumer.receive(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-receive" id="ptp-java-receive"><span><img alt="11" border="0" src="images/callouts/11.png" /></span></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> + connection.close(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-close" id="ptp-java-close"><span><img alt="12" border="0" src="images/callouts/12.png" /></span></a> + context.close(); <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-jndi-close" id="ptp-java-jndi-close"><span><img alt="13" border="0" src="images/callouts/13.png" /></span></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 + </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"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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.idm139643150752656" id="idm139643150752656"><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 + details.</p></td></tr><tr><td align="left" valign="top" width="5%"><p><a id="callout-ptp-context"></a><a href="#ptp-java-context"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></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"><span><img alt="3" border="0" src="images/callouts/3.png" /></span></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"><span><img alt="4" border="0" src="images/callouts/4.png" /></span></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"><span><img alt="5" border="0" src="images/callouts/5.png" /></span></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"><span><img alt="6" border="0" src="images/callouts/6.png" /></span></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"><span><img alt="7" border="0" src="images/callouts/7.png" /></span></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"><span><img alt="8" border="0" src="images/callouts/8.png" /></span></a> </p></td><td align="left" valign="top"><p>Creates a consumer that reads messages from the queue<a class="footnote" href="#ftn.d0e191" id="d0e191"><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"><span><img alt="9" border="0" src="images/callouts/9.png" /></span></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"><span><img alt="10" border="0" src="images/callouts/10.png" /></span></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"><span><img alt="11" border="0" src="images/callouts/11.png" /></span></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"><span><img alt="12" border="0" src="images/callouts/12.png" /></span></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 + 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"><span><img alt="13" border="0" src="images/callouts/13.png" /></span></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.idm139643150752656"><p><a class="para" href="#idm139643150752656"><sup class="para">[1] </sup></a>Creating consumer will automatically create the queue on the Broker +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"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></a> +queue.myqueue = queue1 <a class="co" href="JMS-Client-0-8-Examples.html#callout-ptp-properties-destination" id="ptp-properties-destination"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></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"><span><img alt="1" border="0" src="images/callouts/1.png" /></span></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"><span><img alt="2" border="0" src="images/callouts/2.png" /></span></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 style="width:100; text-align:left;margin-left: 0" /><div class="footnote" id="ftn.d0e191"><p><a class="para" href="#d0e191"><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> + 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="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 4.2. Publish /subscribe example</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Introduction.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Introduction.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Introduction.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Introduction.html Sat Jan 2 23:59:48 2016 @@ -114,8 +114,8 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/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 id="-middle-content"> - <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. + <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="JMS-Client-Book.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="link" 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="link" 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. @@ -123,7 +123,7 @@ https://github.com/apache/qpid-proton/bl 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="../../Programming-In-Apache-Qpid/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> + with AMQP 0-10 protocol, please refer to <a class="link" href="/releases/qpid-0.32/programming/book/" 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="JMS-Client-Book.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="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 2. Document Scope And Intended Audience</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html Sat Jan 2 23:59:48 2016 @@ -114,9 +114,9 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>3.2. Dependencies</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">3.2. Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Prev</a> </td><th align="center" width="60%">Chapter 3. Getting the Client And Dependencies</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Examples.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-JMS-Getting-And-Dependencies-Dependencies"></a>3.2. Dependencies</h2></div></div></div><p>The Qpid JMS client has minimal set of external dependencies. </p><p> It requires: </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>JDK 1.7 or higher.</p></li><li class="listitem"><p>JMS 1.1 specification (such as geronimo-jms_1.1_spec JAR)</p></li><li class="listitem"><p><a class="ulink" href="http://www.slf4j.org"; target="_top">Apache SLF4J</a> (slf4j-api-x.y.z JAR)</p></li></ul></div><p> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">3.2. Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Prev</a> </td><th align="center" width="60%">Chapter 3. Getting the Client And Dependencies</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Examples.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies"></a>3.2. Dependencies</h2></div></div></div><p>The Qpid JMS client has minimal set of external dependencies. </p><p> It requires: </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>JDK 1.7 or higher.</p></li><li class="listitem"><p>JMS 1.1 specification (such as geronimo-jms_1.1_spec JAR)</p></li><li class="listitem"><p><a class="link" href="http://www.slf4j.org"; target="_top">Apache SLF4J</a> (slf4j-api-x.y.z JAR)</p></li></ul></div><p> </p><p>The use of SLF4J means that application authors are free to plug in any logging framework - for which an SLF4J binding exists. </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-JMS-Getting-And-Dependencies.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Examples.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 3. Getting the Client And Dependencies </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 4. Examples</td></tr></table></div></div> + for which an SLF4J binding exists. </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-JMS-Getting-And-Dependencies.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JMS-Getting-And-Dependencies.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Examples.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 3. Getting the Client And Dependencies </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 4. Examples</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html Sat Jan 2 23:59:48 2016 @@ -114,17 +114,17 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/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 3. Getting the Client And Dependencies</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 3. Getting the Client And Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.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-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-JMS-Getting-And-Dependencies"></a>Chapter 3. Getting the Client And Dependencies</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-JMS-Getting-And-Dependencies.html#JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting">3.1. Getting the Client</a></span></dt><d t><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">3.2. Dependencies</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting"></a>3.1. Getting the Client</h2></div></div></div><p>The Qpid JMS client is available as a bundle or from Maven repositories.</p><p>The bundle (a .tar.gz) includes the Qpid JMS client itself (formed by two JAR: qpid-client + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 3. Getting the Client And Dependencies</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Document-Scope-And-Intended-Audience.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-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-JMS-Getting-And-Dependencies"></a>Chapter 3. Getting the Client And Dependencies</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-JMS-Getting-And-Dependencies.html#JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting">3.1. Getting the Client</a></span></dt><d t><span class="section"><a href="JMS-Client-0-8-JMS-Getting-And-Dependencies-Dependencies.html">3.2. Dependencies</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JMS-Getting-And-Dependencies-Getting"></a>3.1. Getting the Client</h2></div></div></div><p>The Qpid JMS client is available as a bundle or from Maven repositories.</p><p>The bundle (a .tar.gz) includes the Qpid JMS client itself (formed by two JAR: qpid-client and qpid-common) together with slf4j-api, and geronimo-jms_1.1_spec. There is also a qpid-all JAR artifact that, for convenience, includes a manifest classpath that references the other - JARs. The bundle is available from <a class="ulink" href="http://qpid.apache.org/download.html"; target="_top">the Apache Qpid project web site</a>.</p><p>The Qpid JMS client is also available from Maven repositories. Add the following + JARs. The bundle is available from <a class="link" href="http://qpid.apache.org/download.html"; target="_top">the Apache Qpid project web site</a>.</p><p>The Qpid JMS client is also available from Maven repositories. Add the following dependency:</p><pre class="screen"> <dependency> <groupId>org.apache.qpid</groupId> <artifactId>qpid-client</artifactId> - <version>0.32-SNAPSHOT</version> + <version>6.1.0-SNAPSHOT</version> </dependency> - </pre><p><a class="xref" href="JMS-Client-0-8-Appendix-Maven.html" title="Appendix B. Minimal Maven POM">Appendix B, <em>Minimal Maven POM</em></a> illustrates a minimal Maven POM required to use the Qpid Client.</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-Document-Scope-And-Intended-Audience.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-Dependencies.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 2. Document Scope And Intended Audience </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 3.2. Dependencies</td></tr></table></div></div> + </pre><p><a class="xref" href="JMS-Client-0-8-Appendix-Maven.html" title="Appendix B. Minimal Maven POM">Appendix B, <em>Minimal Maven POM</em></a> illustrates a minimal Maven POM required to use the Qpid Client.</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-Document-Scope-And-Intended-Audience.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-Dependencies.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 2. Document Scope And Intended Audience </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 3.2. Dependencies</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Destination.html Sat Jan 2 23:59:48 2016 @@ -114,9 +114,9 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>6.4. Destination</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.4. Destination</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Connection-URL.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-JNDI-Properties-Format-Destination"></a>6.4. Destination</h2></div></div></div><p><code class="literal">destination.</code><span class="emphasis"><em>name</em></span> declares either a <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html"; target="_top">Queue</a> or <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html"; target="_top">Topic </a> (depending on the class) with the + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.4. Destination</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Connection-URL.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Destination"></a>6.4. Destination</h2></div></div></div><p><code class="literal">destination.</code><span class="emphasis"><em>name</em></span> declares either a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html"; target="_top">Queue</a> or <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html"; t arget="_top">Topic</a> (depending on the class) with the given JNDI name. The value must be a Binding URL.</p><p>See <a class="xref" href="JMS-Client-0-8-Binding-URL.html" title="Chapter 8. Binding URL">Chapter 8, <em>Binding URL</em></a> for format of the URL and its permitted - options.</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-JNDI-Properties-Format-Topic.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Connection-URL.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.3. Topic </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 7. Connection URLs</td></tr></table></div></div> + options.</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-JNDI-Properties-Format-Topic.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Connection-URL.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.3. Topic </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 7. Connection URLs</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Queue.html Sat Jan 2 23:59:48 2016 @@ -114,8 +114,8 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>6.2. Queue</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.2. Queue</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-JNDI-Properties-Format-Queue"></a>6.2. Queue</h2></div></div></div><p><code class="literal">queue.</code><span class="emphasis"><em>name</em></span> declares a <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html"; target="_top">Queue</a> with the given JNDI name. The - value is simple queue name. This is the name of the queue as known by the Broker.</p><p>The <code class="literal">queue.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=direct://amq.direct//<queue name>?routingkey=’<queue name>’&durable=’true’</pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 6. JNDI Properties Format </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width ="40%"> 6.3. Topic</td></tr></table></div></div> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.2. Queue</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Queue"></a>6.2. Queue</h2></div></div></div><p><code class="literal">queue.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Queue.html"; target="_top">Queue</a> with the given JNDI name. The + value is simple queue name. This is the name of the queue as known by the Broker.</p><p>The <code class="literal">queue.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=direct://amq.direct//<queue name>?routingkey=’<queue name>’&durable=’true’</pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Topic.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 6. JNDI Properties Format </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign=" top" width="40%"> 6.3. Topic</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format-Topic.html Sat Jan 2 23:59:48 2016 @@ -114,10 +114,10 @@ https://github.com/apache/qpid-proton/bl <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>6.3. Topic</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.3. Topic</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-JNDI-Properties-Format-Topic"></a>6.3. Topic</h2></div></div></div><p><code class="literal">topic.</code><span class="emphasis"><em>name</em></span> declares a <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html"; target="_top">Topic</a> with the given JNDI name. The + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.3. Topic</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><th align="center" width="60%">Chapter 6. JNDI Properties Format</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-Topic"></a>6.3. Topic</h2></div></div></div><p><code class="literal">topic.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/Topic.html"; target="_top">Topic</a> with the given JNDI name. The value is topic name. This topic name is used on the Broker as a binding key between the <code class="literal">amq.topic</code> exchange and the queue corresponding to the topic - subscriber.</p><p>The <code class="literal">topic.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=topic://amq.topic/<topic name>/?routingkey=<topic name></pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.2. Queue </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 6.4. Destination</td></tr></table></div></div> + subscriber.</p><p>The <code class="literal">topic.</code> form is a short hand for declaring a destination:</p><pre class="screen">destination.name=topic://amq.topic/<topic name>/?routingkey=<topic name></pre></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-JNDI-Properties-Format.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Destination.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.2. Queue </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 6.4. Destination</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-JNDI-Properties-Format.html Sat Jan 2 23:59:48 2016 @@ -125,9 +125,9 @@ topic.<jndi name>=<topic name&g destination.<jndi name>=<binding url> </pre><p>An arbitrary number of connection factories, queues, topics, queues or destinations or can be declared in the JNDI properties file. Each JNDI name must be unique.</p><p>The application looks up the objects via an InitialContext. This lookup and an example JNDI - properties file is provided in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter 4. Examples">Chapter 4, <em>Examples</em></a></p><p>We now consider each JMS administered object type in turn.</p><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory"></a>6.1. ConnectionFactory</h2></div></div></div><p><code class="literal">connectionfactory.</code><span class="emphasis"><em>name</em></span> declares a <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html"; target="_top">ConnectionFactory</a> with the + properties file is provided in <a class="xref" href="JMS-Client-0-8-Examples.html" title="Chapter 4. Examples">Chapter 4, <em>Examples</em></a></p><p>We now consider each JMS administered object type in turn.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-JNDI-Properties-Format-ConnectionFactory"></a>6.1. ConnectionFactory</h2></div></div></div><p><code class="literal">connectionfactory.</code><span class="emphasis"><em>name</em></span> declares a <a class="link" href="http://docs.oracle.com/javaee/6/api/javax/jms/ConnectionFactory.html"; target="_top">ConnectionFactory</a> with the given JNDI name. The value must be a legal Connection URL.</p><p>See <a class="xref" href="JMS-Client-0-8-Connection-URL.html" title="Chapter 7. Connection URLs">Chapter 7, <em>Connection URLs</em></a> for format of the URL and its - permitted options.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">5.7. Destinations </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 6.2. Queue</td></tr></table></div></div> + permitted options.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Client-Understanding-Destinations.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-JNDI-Properties-Format-Queue.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">5.7. Destinations </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 6.2. Queue</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging-EnablingDebugLogging.html Sat Jan 2 23:59:48 2016 @@ -21,7 +21,7 @@ --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> <head> - <title>10.2. Enabling Debug - Apache Qpid™</title> + <title>11.2. Enabling Debug - 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"/> @@ -111,17 +111,17 @@ https://github.com/apache/qpid-proton/bl </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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>10.2. Enabling Debug</li></ul> + <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>11.2. Enabling Debug</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">10.2. Enabling Debug</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><th align="center" width="60%">Chapter 10. Logging</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-Logging-EnablingDebugLogging"></a>10.2. Enabling Debug</h2></div></div></div><p>If you are experiencing a problem, it can be informative to enable debug logging to allow + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">11.2. Enabling Debug</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><th align="center" width="60%">Chapter 11. Logging</th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-EnablingDebugLogging"></a>11.2. Enabling Debug</h2></div></div></div><p>If you are experiencing a problem, it can be informative to enable debug logging to allow the behaviour of the Qpid JMS client to be understood at a deeper level.</p><p>To do this, set the <code class="literal">org.apache.qpid</code> logger to <code class="literal">DEBUG</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding (or changing) the following line:</p><pre class="screen"> org.apache.qpid=DEBUG </pre><p>If you are using another logging framework, or you are using Log4j but configuring in another manner, refer to the documentation accompanying the logging framework for details of - how to proceed.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Logging.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 10. Logging </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix A. Exceptions</td></tr></table></div></div> + how to proceed.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Logging.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="JMS-Client-0-8-Logging.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Exceptions.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 11. Logging </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix A. Exceptions</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging.html?rev=1722689&r1=1722688&r2=1722689&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging.html (original) +++ qpid/site/docs/releases/qpid-java-trunk/jms-client-0-8/book/JMS-Client-0-8-Logging.html Sat Jan 2 23:59:48 2016 @@ -21,7 +21,7 @@ --> <html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en"> <head> - <title>Chapter 10. Logging - Apache Qpid™</title> + <title>Chapter 11. Logging - 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"/> @@ -111,21 +111,21 @@ https://github.com/apache/qpid-proton/bl </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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/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 10. Logging</li></ul> + <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-trunk/index.html">Qpid Java Trunk</a></li><li><a href="/releases/qpid-java-trunk/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 11. Logging</li></ul> <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 10. Logging</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Logging"></a>Chapter 10. Logging</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">10.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">10.2. Enabling Debug< /a></span></dt></dl></div><p>The Qpid JMS client uses the <a class="ulink" href="http://www.slf4j.org"; target="_top">Apache SLF4J</a> logging + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 11. Logging</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Logging"></a>Chapter 11. Logging</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Logging.html#JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel">11.1. Recommended Production Logging Level</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">11.2. Enabling Debug< /a></span></dt></dl></div><p>The Qpid JMS client uses the <a class="link" href="http://www.slf4j.org"; target="_top">Apache SLF4J</a> logging framework. All logging activity created by the client is directed through the SLF4J API. SLF4J is a is a façade for other common logging frameworks. This makes it easy for application authors to use their prefered logging framework in their application stack, and have the Qpid JMS Client - use it too. </p><p>SLF4J suppplies bindings for many common logging frameworks (<a class="ulink" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"; target="_top">JUL</a>, <a class="ulink" href="http://logging.apache.org/log4j/1.2/"; target="_top">Apache Log4J</a>, <a class="ulink" href="http://logback.qos.ch"; target="_top">Logback</a>.</p><p>Include the SLF4J binding corresponding to the logging framework of your choosen logging - framework on classpath. For full details, see the SLF4J <a class="ulink" href="http://www.slf4j.org"; target="_top">documentation</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel"></a>10.1. Recommended Production Logging Level</h2></div></div></div><p>In production, it is recommended that you configure your logging framework is configured + use it too. </p><p>SLF4J suppplies bindings for many common logging frameworks (<a class="link" href="http://docs.oracle.com/javase/7/docs/api/java/util/logging/package-summary.html"; target="_top">JUL</a>, <a class="link" href="http://logging.apache.org/log4j/1.2/"; target="_top">Apache Log4J</a>, <a class="link" href="http://logback.qos.ch"; target="_top">Logback</a>.</p><p>Include the SLF4J binding corresponding to the logging framework of your choosen logging + framework on classpath. For full details, see the SLF4J <a class="link" href="http://www.slf4j.org"; target="_top">documentation</a>.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-8-Logging-RecommendedProductionLoggingLevel"></a>11.1. Recommended Production Logging Level</h2></div></div></div><p>In production, it is recommended that you configure your logging framework is configured with logger <code class="literal">org.apache.qpid</code> set to <code class="literal">WARN</code>.</p><p>If you are using Apache Log4j with a log4j.properties file, this simply means adding the following line:</p><pre class="screen"> org.apache.qpid=WARN </pre><p>If you are using another logging framework, or you are using Log4j but configuring in another manner, refer to the documentation accompanying the logging framework for details of - how to proceed.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 9. System Properties </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 10.2. Enabling Debug</td></tr></table></div></div> + how to proceed.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-System-Properties.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 10. System Properties </td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-Book.html">Home</a></td><td align="right" valign="top" width="40%"> 11.2. Enabling Debug</td></tr></table></div></div> <hr/> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
