mirror of
https://github.com/apache/activemq-artemis.git
synced 2025-02-08 19:15:08 +00:00
3c44e26854
https://issues.apache.org/jira/browse/ACTIVEMQ6-3 We are renaming packages from activemq6 to activemq as that's more generic and version independent On this first commit I'm just renaming the directories otherwise the history would be lost. The next commit will rename the text on the directories. If I squash these two commits git will make us delete / add again.
<html>
<head>
<title>HornetQ JMS Completion Listener Example</title>
<link rel="stylesheet" type="text/css" href="../common/common.css" />
<link rel="stylesheet" type="text/css" href="../common/prettify.css" />
<script type="text/javascript" src="../common/prettify.js"></script>
</head>
<body onload="prettyPrint()">
<h1>JMS Completion Listener Example</h1>
<p>This example shows you how to send a message asynchronously to HornetQ and use a CompletionListener to be notified of
the Broker receiving it</p>
<h2>Example step-by-step</h2>
<p><i>To run the example, simply type <code>mvn verify</code> from this directory</i></p>
<ol>
<li>First we need to get an initial context so we can look-up the JMS connection factory and destination objects from JNDI. This initial context will get it's properties from the <code>client-jndi.properties</code> file in the directory <code>../common/config</code></li>
<pre class="prettyprint">
<code>InitialContext initialContext = getContext();</code>
</pre>
<li>We look-up the JMS queue object from JNDI</li>
<pre class="prettyprint">
<code>Queue queue = (Queue) initialContext.lookup("/queue/exampleQueue");</code>
</pre>
<li>We look-up the JMS connection factory object from JNDI</li>
<pre class="prettyprint">
<code>ConnectionFactory cf = (ConnectionFactory) initialContext.lookup("/ConnectionFactory");</code>
</pre>
<li>We create a JMS context</li>
<pre class="prettyprint">
<code>jmsContext = cf.createContext();</code>
</pre>
<li>We create a JMS Producer.</li>
<pre class="prettyprint">
<code>JMSProducer producer = jmsContext.createProducer();</code>
</pre>
<li>We set a CompletionListener on the Producer</li>
<pre class="prettyprint">
<code>producer.setAsync(new CompletionListener()
{
@Override
public void onCompletion(Message message)
{
System.out.println("message acknowledged by HornetQ");
latch.countDown();
}
@Override
public void onException(Message message, Exception e)
{
e.printStackTrace();
}
});</code>
</pre>
<li>We send a message</li>
<pre class="prettyprint">
<code>producer.send(queue, "this is a string");</code>
</pre>
<li> and then wait for the Completion Listener to be called</li>
<pre class="prettyprint">
<code>return latch.await(5, TimeUnit.SECONDS);</code>
</pre>
<li>And finally, <b>always</b> remember to close your JMS connections and resources after use, in a <code>finally</code> block. Closing a JMS connection will automatically close all of its sessions, consumers, producer and browser objects</li>
<pre class="prettyprint">
<code>finally
{
if (initialContext != null)
{
initialContext.close();
}
if (jmsContext != null)
{
jmsContext.close();
}
}</code>
</pre>
</ol>
</body>
</html>