servicemix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache ServiceMix > servicemix-jms new endpoints
Date Tue, 26 Jan 2010 09:01:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=SM&amp;forWysiwyg=true" type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/SM/servicemix-jms+new+endpoints">servicemix-jms new endpoints</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~gertvanthienen">Gert Vanthienen</a>
    </h4>
     
          <br/>
     <div class="notificationGreySide">
         <h1><a name="servicemix-jmsnewendpoints-NewservicemixjmsEndpoints"></a>New servicemix-jms Endpoints </h1>

<p>These newer JMS endpoints reuse some of the <a href="http://static.springframework.org/spring/docs/2.0.x/reference/jms.html" rel="nofollow">Spring JMS features</a> including the message listener container, JMS transactions and the JMS template. Using these new endpoints can be achieved by using the <tt>jms:consumer</tt> and <tt>jms:provider</tt> in the xbean.xml file for the servicemix-jms component. This page provides various examples of the syntax to access these newer endpoints. </p>

<style type='text/css'>/*<![CDATA[*/
div.rbtoc1264496417354 {margin-left: 1.5em;padding: 0px;}
div.rbtoc1264496417354 ul {list-style: disc;margin-left: 0px;padding-left: 20px;}
div.rbtoc1264496417354 li {margin-left: 0px;padding-left: 0px;}

/*]]>*/</style><div class='rbtoc1264496417354'>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-NewservicemixjmsEndpoints'>New servicemix-jms Endpoints</a></li>
    <li><a href='#servicemix-jmsnewendpoints-ConsumerEndpoints'>Consumer Endpoints</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-SimpleExamples'>Simple Examples</a></li>
    <li><a href='#servicemix-jmsnewendpoints-TheConnectionFactory'>The Connection Factory</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-ActiveMQ'>ActiveMQ</a></li>
    <li><a href='#servicemix-jmsnewendpoints-OtherJMSproviders'>Other JMS providers</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-Tips'>Tips</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-UsingaMarshaler'>Using a Marshaler</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-Reference'>Reference</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-CommonProperties'>Common Properties</a></li>
    <li><a href='#servicemix-jmsnewendpoints-%7B%7B%3Cjms%3Aconsumer%2F%3E%7D%7Dand%7B%7B%3Cjms%3Asoapconsumer%2F%3E%7D%7D'> <tt>&lt;jms:consumer/&gt;</tt> and <tt>&lt;jms:soap-consumer/&gt;</tt></a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-Soapspecificproperties'>Soap specific properties</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-%7B%7B%3Cjms%3Ajcaconsumer%2F%3E%7D%7D'> <tt>&lt;jms:jca-consumer/&gt;</tt></a></li>
</ul>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-ProviderEndpoints'>Provider Endpoints</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-SimpleExamples'>Simple Examples</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-%3Cjms%3Aprovider%2F%3E'>&lt;jms:provider/&gt;</a></li>
    <li><a href='#servicemix-jmsnewendpoints-%3Cjms%3Aprovider%2F%3E'>&lt;jms:provider/&gt;</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-TheConnectionFactory'>The Connection Factory</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-ActiveMQ'>ActiveMQ</a></li>
    <li><a href='#servicemix-jmsnewendpoints-OtherJMSproviders'>Other JMS providers</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-Tips'>Tips</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-UsingaMarshaler'>Using a Marshaler</a></li>
    <li><a href='#servicemix-jmsnewendpoints-UseapooledconnectionFactoryforoptimaljms%3Aproviderperformance.'>Use a pooled connectionFactory for optimal jms:provider performance.</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-Reference'>Reference</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-CommonProperties'>Common Properties</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-Attributes'>Attributes</a></li>
    <li><a href='#servicemix-jmsnewendpoints-Beans'>Beans</a></li>
</ul>
    <li><a href='#servicemix-jmsnewendpoints-SOAPSpecificProperties'>SOAP Specific Properties</a></li>
<ul>
    <li><a href='#servicemix-jmsnewendpoints-Attributes'>Attributes</a></li>
    <li><a href='#servicemix-jmsnewendpoints-Beans'>Beans</a></li>
</ul>
</ul>
</ul>
</ul></div>

<h1><a name="servicemix-jmsnewendpoints-ConsumerEndpoints"></a>Consumer Endpoints</h1>

<h2><a name="servicemix-jmsnewendpoints-SimpleExamples"></a>Simple Examples</h2>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:consumer service=<span class="code-quote">"my:ConsumerService"</span>
              endpoint=<span class="code-quote">"jbi"</span>
              destinationName=<span class="code-quote">"my.queue"</span>
              connectionFactory=<span class="code-quote">"#connectionFactory"</span>
              concurrentConsumers=<span class="code-quote">"8"</span> /&gt;
</pre>
</div></div>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:soap-consumer wsdl=<span class="code-quote">"classpath:service.wsdl"</span>
                   destinationName=<span class="code-quote">"my.queue"</span>
                   connectionFactory=<span class="code-quote">"#connectionFactory"</span>
                   concurrentConsumers=<span class="code-quote">"8"</span> /&gt;
</pre>
</div></div>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:jca-consumer service=<span class="code-quote">"my:ConsumerService"</span>
                  endpoint=<span class="code-quote">"jbi"</span>
                  destinationName=<span class="code-quote">"my.queue"</span>
                  connectionFactory=<span class="code-quote">"#connectionFactory"</span>
                  resourceAdapter=<span class="code-quote">"#ra"</span>
                  activationSpec=<span class="code-quote">"#as"</span> /&gt;
</pre>
</div></div>

<h2><a name="servicemix-jmsnewendpoints-TheConnectionFactory"></a>The Connection Factory</h2>

<h3><a name="servicemix-jmsnewendpoints-ActiveMQ"></a>ActiveMQ</h3>

<p>If you're using ActiveMQ, the ActiveMQ connection pool from the <a href="http://jencks.codehaus.org/AMQPool" rel="nofollow">Jencks AMQPool</a>. Just add  <a href="http://repo1.maven.org/maven2/org/jencks/jencks-amqpool/2.0/jencks-amqpool-2.0.jar" rel="nofollow">jencks-amqpool</a> to your classpath.  Then you can define a connection pool the following way:</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;beans <span class="code-keyword">xmlns:amqpool</span>=<span class="code-quote">"http://jencks.org/amqpool/2.0"</span>&gt;</span>
  &lt;amqpool:xa-pool id=<span class="code-quote">"connectionFactory"</span> 
                   url=<span class="code-quote">"tcp://localhost:61616"</span>
                   transactionManager=<span class="code-quote">"#transactionManager"</span> /&gt;
<span class="code-tag">&lt;/beans&gt;</span>
</pre>
</div></div>

<p>See the <a href="http://jencks.codehaus.org/AMQPool#AMQPool-XBeanconfiguration" rel="nofollow">Jencks AMQPool documentation</a> from the Jencks project for more information. </p>

<h3><a name="servicemix-jmsnewendpoints-OtherJMSproviders"></a>Other JMS providers</h3>

<p>For other JMS providers, the ConnectionFactory can be configured to be retrieved via JNDI:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;beans <span class="code-keyword">xmlns:jee</span>=<span class="code-quote">"http://www.springframework.org/schema/jee"</span>&gt;</span>
  <span class="code-tag">&lt;jee:jndi-lookup id=<span class="code-quote">"connectionFactory"</span> jndi-name=<span class="code-quote">"weblogic.jms.XAConnectionFactory"</span>&gt;</span>
    <span class="code-tag">&lt;jee:environment&gt;</span>
      java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
      java.naming.provider.url=t3://localhost:7001
    <span class="code-tag">&lt;/jee:environment&gt;</span>
  <span class="code-tag">&lt;/jee:jndi-lookup&gt;</span>
<span class="code-tag">&lt;beans&gt;</span>
</pre>
</div></div>

<p>Or just configured as a Spring bean: </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;bean id=<span class="code-quote">"connectionFactory"</span> class=<span class="code-quote">"com.ibm.mq.jms.MQQueueConnectionFactory"</span>&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"transportType"</span>&gt;</span>
         <span class="code-tag">&lt;util:constant static-field=<span class="code-quote">"com.ibm.mq.jms.JMSC.MQJMS_TP_CLIENT_MQ_TCPIP"</span> /&gt;</span>
     <span class="code-tag">&lt;/property&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"queueManager"</span> value=<span class="code-quote">"foo.queue.mgr"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"hostName"</span> value=<span class="code-quote">"hostname"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"channel"</span> value=<span class="code-quote">"channelname"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"port"</span> value=<span class="code-quote">"12345"</span> /&gt;</span>
<span class="code-tag">&lt;/bean&gt;</span>
</pre>
</div></div>

<p>Check your JMS provider for any of the provider-specific configuration that might be needed.</p>

<h2><a name="servicemix-jmsnewendpoints-Tips"></a>Tips</h2>

<h3><a name="servicemix-jmsnewendpoints-UsingaMarshaler"></a>Using a Marshaler</h3>

<p>The <a href="http://svn.apache.org/viewvc/servicemix/components/bindings/servicemix-jms/trunk/src/main/java/org/apache/servicemix/jms/endpoints/JmsConsumerMarshaler.java?revision=HEAD" rel="nofollow">org.apache.servicemix.jms.endpoints.JmsConsumerMarshaler</a> interface defines the way the incoming JMS message is transformed.  There are two implementations:</p>
<ul>
	<li>DefaultConsumerMarshaler for <tt>&lt;jms:consumer/&gt;</tt> and <tt>&lt;jms:jca-consumer/&gt;</tt> endpoints</li>
	<li>JmsSoapConsumerMarshaler for <tt>&lt;jms:soap-consumer/&gt;</tt> endpoints</li>
</ul>


<p>For SOAP enabled endpoints, there is not particular need to modify the way the marshaling is done.  But the DefaultConsumerMarshaler does not support the whole range of messages.  So from time to time, you will need to process JMS properties or receive a Map based message.  In such a case, you would create your own class implementing the <tt>JmsConsumerMarshaler</tt> interface and configure it on the endpoint:</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:consumer service=<span class="code-quote">"my:ConsumerService"</span>

              endpoint=<span class="code-quote">"jbi"</span>
              destinationName=<span class="code-quote">"my.queue"</span>
              connectionFactory=<span class="code-quote">"#connectionFactory"</span>
              marshaler=<span class="code-quote">"#myMarshaler"</span> /&gt;

<span class="code-tag">&lt;bean id=<span class="code-quote">"myMarshaler"</span> class=<span class="code-quote">"my.package.MyMarshaler"</span> /&gt;</span>
</pre>
</div></div>

<p>OR</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:consumer service=<span class="code-quote">"foo:MyService"</span>
  endpoint=<span class="code-quote">"blah"</span>
  destinationName=<span class="code-quote">"FOO.BAR"</span>
  connectionFactory=<span class="code-quote">"#connectionFactory"</span>
  marshaler=<span class="code-quote">"#marshaler"</span> /&gt;

<span class="code-tag">&lt;bean id=<span class="code-quote">"marshaler"</span> class=<span class="code-quote">"org.apache.servicemix.jms.endpoints.DefaultConsumerMarshaler"</span>&gt;</span>
   <span class="code-tag">&lt;property name=<span class="code-quote">"mep"</span> value=<span class="code-quote">"http://www.w3.org/2004/08/wsdl/in-out"</span> /&gt;</span>
<span class="code-tag">&lt;/bean&gt;</span>
</pre>
</div></div>

<h2><a name="servicemix-jmsnewendpoints-Reference"></a>Reference</h2>

<p>ServiceMix uses JMS support from the Spring Framework, hence most of the following properties are fully documented at the following locations:</p>
<ul>
	<li><a href="http://static.springframework.org/spring/docs/2.0.x/reference/jms.html" rel="nofollow">http://static.springframework.org/spring/docs/2.0.x/reference/jms.html</a></li>
	<li><a href="http://static.springframework.org/spring/docs/2.0.x/api/org/springframework/jms/listener/package-summary.html" rel="nofollow">http://static.springframework.org/spring/docs/2.0.x/api/org/springframework/jms/listener/package-summary.html</a></li>
</ul>


<h3><a name="servicemix-jmsnewendpoints-CommonProperties"></a>Common Properties</h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Bean </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> service </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The service name of the proxied endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> endpoint </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The endpoint name of the proxied endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> interfaceName </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The interface name of the proxied endpoint </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> targetService </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The service name of the target endpoint </td>
<td class='confluenceTd'> no (defaults to the service attribute) </td>
</tr>
<tr>
<td class='confluenceTd'> targetEndpoint </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The endpoint name of the target endpoint </td>
<td class='confluenceTd'> no (defaults to the endpoint attribute) </td>
</tr>
<tr>
<td class='confluenceTd'> targetInterface </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The interface name of the target endpoint </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> targetUri </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> The URI of the target endpoint </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> marshaler </td>
<td class='confluenceTd'> JmsConsumerMarshaler </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> The class implementing the message marshaler </td>
<td class='confluenceTd'> no (defaults to <tt>DefaultConsumerMarshaler</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> synchronous </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies if the consumer will block while waiting for a response </td>
<td class='confluenceTd'> no (defaults to true) </td>
</tr>
<tr>
<td class='confluenceTd'> destinationChooser </td>
<td class='confluenceTd'> DestinationChooser </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> A class implementing logic for choosing among JMS destinations </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> destinationResolver </td>
<td class='confluenceTd'> DestinationResolver </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> A class implementing logic for converting strings into destination IDs</td>
<td class='confluenceTd'> no (defaults to <tt>DynamicDestinationResolver</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> pubSubDomain </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies if the destination is a topic</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> connectionFactory </td>
<td class='confluenceTd'> ConnectionFactory </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> The <tt>ConnectionFactory</tt> used to connect with the destination </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> useMessageIdInResponse </td>
<td class='confluenceTd'> Boolean </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> Specifies if the request message's ID is used as the reply's correlation ID</td>
<td class='confluenceTd'> no (if not set the request's correlation ID is used) </td>
</tr>
<tr>
<td class='confluenceTd'> replyDestination </td>
<td class='confluenceTd'> Destination</td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> Specifies the JMS destination for the reply</td>
<td class='confluenceTd'> no (if not set either the replyDestination or the destinationChooser is used) </td>
</tr>
<tr>
<td class='confluenceTd'> replyDestinationName </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies the name of the JMS destination to use for the reply </td>
<td class='confluenceTd'> no (if not set the replyDestination or the destinationChooser is used) </td>
</tr>
<tr>
<td class='confluenceTd'> replyExplicitQosEnabled </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies if the QoS values specified for the endpoint are explicity used when the reply is sent </td>
<td class='confluenceTd'> no (default is false) </td>
</tr>
<tr>
<td class='confluenceTd'> replyDeliveryMode </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies the JMS delivery mode used for the reply</td>
<td class='confluenceTd'> no (defaults to persistent) </td>
</tr>
<tr>
<td class='confluenceTd'> replyPriority </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies the JMS message priority of the reply </td>
<td class='confluenceTd'> no (defaults to 4)</td>
</tr>
<tr>
<td class='confluenceTd'> replyTimeToLive </td>
<td class='confluenceTd'> long </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> Specifies the number of milliseconds the reply message is valid </td>
<td class='confluenceTd'> no (defaults to unlimited)</td>
</tr>
<tr>
<td class='confluenceTd'> replyProperties </td>
<td class='confluenceTd'> Map </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> Specifies custom properties to be placed in the reply's JMS header </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
</tr>
<tr>
<td class='confluenceTd'> storeFactory </td>
<td class='confluenceTd'> StoreFactory </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> The factory class used to create the data store for state information</td>
<td class='confluenceTd'> no (defaults to <tt>MemoryStoreFactory</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> store </td>
<td class='confluenceTd'> Store </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> The data store used to store state information </td>
<td class='confluenceTd'> no </td>
</tr>
</tbody></table>

<h3><a name="servicemix-jmsnewendpoints-%7B%7B%3Cjms%3Aconsumer%2F%3E%7D%7Dand%7B%7B%3Cjms%3Asoapconsumer%2F%3E%7D%7D"></a><tt>&lt;jms:consumer/&gt;</tt> and <tt>&lt;jms:soap-consumer/&gt;</tt></h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> listenerType</td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> Specifies the type of Spring JMS message listener to use </td>
<td class='confluenceTd'> <tt>default</tt>, <tt>simple</tt>, <tt>server</tt> (defaults to <tt>default</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> jms102 </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the consumer is to be use JMS 1.0.2 </td>
<td class='confluenceTd'> no (defaults to <tt>false</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> transacted </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> Specifies the type of transaction to wrap the message exchanges </td>
<td class='confluenceTd'> <tt>none</tt>, <tt>xa</tt>, <tt>jms</tt> (defaults to <tt>none</tt>) </td>
</tr>
</tbody></table>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Simple </th>
<th class='confluenceTh'> Default </th>
<th class='confluenceTh'> Server </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> clientId </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The JMS client id for a shared <tt>Connection</tt> created and used by this listener </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> destination </td>
<td class='confluenceTd'> Destination </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The destination used to receive messages </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> destinationName </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The name of the destination used to receive messages</td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> durableSubscriptionName </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The durable subscriber name </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> exceptionListener </td>
<td class='confluenceTd'> ExceptionListener </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The <tt>ExceptionListener</tt> to notify in case of a <tt>JMSException</tt> thrown by the registered message listener or the invocation infrastructure </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> messageSelector </td>
<td class='confluenceTd'> String</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The message selector string to use </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> sessionAcknowlegeMode </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The acknowledgment mode that is used when creating a Session to send a message </td>
<td class='confluenceTd'> no (defaults to <tt>Session.AUTO_ACKNOWLEDGE</tt>)</td>
</tr>
<tr>
<td class='confluenceTd'> subscriptionDurable </td>
<td class='confluenceTd'> boolean  </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> Specifies if the listener uses a durable subscription to listen form messages </td>
<td class='confluenceTd'> no (defaults to false) </td>
</tr>
<tr>
<td class='confluenceTd'> pubSubNoLocal </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> Specifies if messages published by the listener's <tt>Connection</tt> are suppressed </td>
<td class='confluenceTd'> no (defaults to false) </td>
</tr>
<tr>
<td class='confluenceTd'> concurrentConsumers </td>
<td class='confluenceTd'> int  </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> The number of concurrent consumers created by the listener </td>
<td class='confluenceTd'> no (defaults to 1) </td>
</tr>
<tr>
<td class='confluenceTd'> cacheLevel </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> The level of caching allowed by the listener </td>
<td class='confluenceTd'> no (defaults to <tt>CACHE_NONE</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> receiveTimeout</td>
<td class='confluenceTd'> long </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> The timeout for receiving a message in milliseconds </td>
<td class='confluenceTd'> no (default is 1000) </td>
</tr>
<tr>
<td class='confluenceTd'> recoveryInterval </td>
<td class='confluenceTd'> long </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> The interval, in milliseconds, between attempts to recover after a failed listener set-up </td>
<td class='confluenceTd'> no (defaults to 5000) </td>
</tr>
<tr>
<td class='confluenceTd'> maxMessagesPerTask </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The number of attempts to receive messages per task </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> serverSessionFactory </td>
<td class='confluenceTd'> ServerSessionFactory </td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'>&nbsp;</td>
<td class='confluenceTd'> X </td>
<td class='confluenceTd'> The <tt>ServerSessionFactory</tt> to use </td>
<td class='confluenceTd'> no (defaults to <tt>SimpleServerSessionFactory</tt>) </td>
</tr>
</tbody></table>

<div class='panelMacro'><table class='warningMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>cacheLevel</b><br /><p>The listener cacheLevel defaults to CACHE_NONE, which means no jms resources are cached at all. If your consumer consumes any volume of messages you should set this to at least CACHE_CONNECTION (cacheLevel="1") or for optimal consumer performance use CACHE_CONSUMER (cacheLevel="3")</p></td></tr></table></div>

<h4><a name="servicemix-jmsnewendpoints-Soapspecificproperties"></a>Soap specific properties</h4>

<p>Note that when deploying a soap consumer, the service and endpoint name are optional and can be inferred from the given WSDL (if the WSDL only contains a single port definition).  If the service and/or endpoint attributes are given, they must match the service and port name of the WSDL.</p>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Name</th>
<th class='confluenceTh'>Type</th>
<th class='confluenceTh'>Description</th>
<th class='confluenceTh'>Required</th>
</tr>
<tr>
<td class='confluenceTd'> wsdl </td>
<td class='confluenceTd'> Resource </td>
<td class='confluenceTd'> WSDL describing the service </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> useJbiWrapper </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the JBI wrapper is sent in the body of the message </td>
<td class='confluenceTd'> no (defaults to true) </td>
</tr>
<tr>
<td class='confluenceTd'> validateWsdl </td>
<td class='confluenceTd'> boolan </td>
<td class='confluenceTd'> Checks WSI-BP compliance </td>
<td class='confluenceTd'> no (defaults to true) </td>
</tr>
<tr>
<td class='confluenceTd'> policies </td>
<td class='confluenceTd'> Policy[] </td>
<td class='confluenceTd'> A list of interceptors that will process the message </td>
<td class='confluenceTd'> no </td>
</tr>
</tbody></table>


<h3><a name="servicemix-jmsnewendpoints-%7B%7B%3Cjms%3Ajcaconsumer%2F%3E%7D%7D"></a><tt>&lt;jms:jca-consumer/&gt;</tt></h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> resourceAdapter</td>
<td class='confluenceTd'> ResourceAdapter </td>
<td class='confluenceTd'> The resource adapter used for the endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> activationSpec </td>
<td class='confluenceTd'> ActivationSpec </td>
<td class='confluenceTd'> The activation information needed for the endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> bootstrapContext </td>
<td class='confluenceTd'> BootstrapContext </td>
<td class='confluenceTd'> The bootstrap context used when starting the resource adapter  </td>
<td class='confluenceTd'> no (a default one will be created) </td>
</tr>
</tbody></table>

<h1><a name="servicemix-jmsnewendpoints-ProviderEndpoints"></a>Provider Endpoints</h1>

<h2><a name="servicemix-jmsnewendpoints-SimpleExamples"></a>Simple Examples</h2>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:provider service=<span class="code-quote">"my:ProviderService"</span>
              endpoint=<span class="code-quote">"jbi"</span>
              destinationName=<span class="code-quote">"my.queue"</span>
              connectionFactory=<span class="code-quote">"#connectionFactory"</span> /&gt;
</pre>
</div></div>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:soap-provider wsdl=<span class="code-quote">"classpath:service.wsdl"</span>
                   destinationName=<span class="code-quote">"my.queue"</span>
                   connectionFactory=<span class="code-quote">"#connectionFactory"</span> /&gt;
</pre>
</div></div>

<h3><a name="servicemix-jmsnewendpoints-%3Cjms%3Aprovider%2F%3E"></a>&lt;jms:provider/&gt;</h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Default </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> preserveQos </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> <b><tt>false</tt></b> </td>
<td class='confluenceTd'> When set to <tt>true</tt>, the JMS Priority and TimeToLive set on the Message will override the value set on the endpoint </td>
<td class='confluenceTd'> false </td>
</tr>
</tbody></table>


<h3><a name="servicemix-jmsnewendpoints-%3Cjms%3Aprovider%2F%3E"></a>&lt;jms:provider/&gt;</h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Default </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> preserveQos </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> <b><tt>false</tt></b> </td>
<td class='confluenceTd'> When set to <tt>true</tt>, the JMS Priority and TimeToLive set on the Message will override the value set on the endpoint </td>
<td class='confluenceTd'> false </td>
</tr>
</tbody></table>


<h2><a name="servicemix-jmsnewendpoints-TheConnectionFactory"></a>The Connection Factory</h2>

<h3><a name="servicemix-jmsnewendpoints-ActiveMQ"></a>ActiveMQ</h3>

<p>We recommend jencks specific ActiveMQ connection pool if you use ActiveMQ.<br/>
Just add <a href="http://repo1.maven.org/maven2/org/jencks/jencks-amqpool/2.0/jencks-amqpool-2.0.jar" rel="nofollow">jencks-amqpool</a> to your classpath.  Then you can define a connection pool the following way:</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;beans <span class="code-keyword">xmlns:amqpool</span>=<span class="code-quote">"http://jencks.org/amqpool/2.0"</span>&gt;</span>
  &lt;amqpool:xa-pool id=<span class="code-quote">"connectionFactory"</span> 
                   url=<span class="code-quote">"tcp://localhost:61616"</span>
                   transactionManager=<span class="code-quote">"#transactionManager"</span> /&gt;
<span class="code-tag">&lt;/beans&gt;</span>
</pre>
</div></div>

<p>Take a look at the <a href="http://jencks.codehaus.org/AMQPool#AMQPool-XBeanconfiguration" rel="nofollow">AMQPool documentation</a> from the Jencks project for more information. </p>

<h3><a name="servicemix-jmsnewendpoints-OtherJMSproviders"></a>Other JMS providers</h3>

<p>For other JMS providers, the ConnectionFactory can be configured to be retrieved via JNDI:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;beans <span class="code-keyword">xmlns:jee</span>=<span class="code-quote">"http://www.springframework.org/schema/jee"</span>&gt;</span>
  <span class="code-tag">&lt;jee:jndi-lookup id=<span class="code-quote">"connectionFactory"</span> jndi-name=<span class="code-quote">"weblogic.jms.XAConnectionFactory"</span>&gt;</span>
    <span class="code-tag">&lt;jee:environment&gt;</span>
      java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
      java.naming.provider.url=t3://localhost:7001
    <span class="code-tag">&lt;/jee:environment&gt;</span>
  <span class="code-tag">&lt;/jee:jndi-lookup&gt;</span>
<span class="code-tag">&lt;beans&gt;</span>
</pre>
</div></div>

<p>Or just configured as a Spring bean: </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;bean id=<span class="code-quote">"connectionFactory"</span> class=<span class="code-quote">"com.ibm.mq.jms.MQQueueConnectionFactory"</span>&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"transportType"</span>&gt;</span>
         <span class="code-tag">&lt;util:constant static-field=<span class="code-quote">"com.ibm.mq.jms.JMSC.MQJMS_TP_CLIENT_MQ_TCPIP"</span> /&gt;</span>
     <span class="code-tag">&lt;/property&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"queueManager"</span> value=<span class="code-quote">"foo.queue.mgr"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"hostName"</span> value=<span class="code-quote">"hostname"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"channel"</span> value=<span class="code-quote">"channelname"</span> /&gt;</span>
     <span class="code-tag">&lt;property name=<span class="code-quote">"port"</span> value=<span class="code-quote">"12345"</span> /&gt;</span>
<span class="code-tag">&lt;/bean&gt;</span>
</pre>
</div></div>

<p>Check your JMS provider for any of the provider-specific configuration that might be needed.</p>

<h2><a name="servicemix-jmsnewendpoints-Tips"></a>Tips</h2>

<h3><a name="servicemix-jmsnewendpoints-UsingaMarshaler"></a>Using a Marshaler</h3>

<p>The <a href="http://svn.apache.org/viewvc/servicemix/components/bindings/servicemix-jms/trunk/src/main/java/org/apache/servicemix/jms/endpoints/JmsProviderMarshaler.java?revision=HEAD" rel="nofollow">org.apache.servicemix.jms.endpoints.JmsProviderMarshaler</a> interface defines the way incoming and outgoing JMS messages are transformed.  There are two implementations:</p>
<ul>
	<li><tt>DefaultProviderMarshaler</tt> for <tt>&lt;jms:provider /&gt;</tt> endpoints</li>
	<li><tt>JmsSoapProviderMarshaler</tt> for <tt>&lt;jms:soap-provider /&gt;</tt> endpoints</li>
</ul>


<p>For SOAP enabled endpoints, there is no particular need to modify the way the marshaling is done.  But the <tt>DefaultProviderMarshaler</tt> does not support the whole range of messages.  So from time to time, you will need to process JMS properties or receive a Map based message.  In such a case, you would create your own class implementing the <tt>JmsProviderMarshaler</tt> interface and configure it on the endpoint:</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">&lt;jms:provider service=<span class="code-quote">"my:ProviderService"</span>
              endpoint=<span class="code-quote">"jbi"</span>
              destinationName=<span class="code-quote">"my.queue"</span>
              connectionFactory=<span class="code-quote">"#connectionFactory"</span>
              marshaler=<span class="code-quote">"#marshaler"</span> /&gt;
<span class="code-tag">&lt;bean id=<span class="code-quote">"marshaler"</span> class=<span class="code-quote">"my.package.MyMarshaler"</span> /&gt;</span>
</pre>
</div></div>

<h3><a name="servicemix-jmsnewendpoints-UseapooledconnectionFactoryforoptimaljms%3Aproviderperformance."></a>Use a pooled connectionFactory for optimal jms:provider performance.</h3>

<p>In order to optimize jms resource usage configure your jms:provider with a PooledConnectionFactory. </p>

<p>Example:</p>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">  &lt;bean id=<span class="code-quote">"connectionFactory"</span> class=<span class="code-quote">"org.apache.activemq.pool.PooledConnectionFactory"</span>&gt;
    &lt;property name=<span class="code-quote">"connectionFactory"</span>&gt;
      &lt;bean class=<span class="code-quote">"org.apache.activemq.ActiveMQConnectionFactory"</span>&gt;
        &lt;property name=<span class="code-quote">"brokerURL"</span> value=<span class="code-quote">"tcp:<span class="code-comment">//localhost:61616"</span> /&gt;
</span>      &lt;/bean&gt;
    &lt;/property&gt;
    &lt;!--Configure maximum connections used by the pool --&gt;
    &lt;property name=<span class="code-quote">"maxConnections"</span> value=<span class="code-quote">"1"</span> /&gt;
    &lt;!--Configure maximum sessions per connection --&gt;
    &lt;property name=<span class="code-quote">"maximumActive"</span> value=<span class="code-quote">"1"</span> /&gt;
  &lt;/bean&gt;
</pre>
</div></div>

<p>See: <a href="http://activemq.apache.org/jmstemplate-gotchas.html" rel="nofollow">JMS Template Gotchas </a> for additional background.</p>

<h2><a name="servicemix-jmsnewendpoints-Reference"></a>Reference</h2>

<h3><a name="servicemix-jmsnewendpoints-CommonProperties"></a>Common Properties</h3>

<h4><a name="servicemix-jmsnewendpoints-Attributes"></a>Attributes</h4>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> deliveryMode </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> The JMS delivery mode </td>
<td class='confluenceTd'> no (defaults to persistent)  </td>
</tr>
<tr>
<td class='confluenceTd'> destinationName </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> The JNDI name of the destination used to send messages </td>
<td class='confluenceTd'> no </td>
</tr>
</tbody></table>

<table class='confluenceTable'><tbody>
<tr>
<td class='confluenceTd'> endpoint </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> The endpoint name of the proxied endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> explicitQosEnabled </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the JMS messages have the specified properties explicitly applied </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> interfaceName </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> The interface name of the proxied endpoint </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> jms102 </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the consumer is to be use JMS 1.0.2 </td>
<td class='confluenceTd'> no (defaults to <tt>false</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> messageIdEnabled </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if JMS message IDs are enabled </td>
<td class='confluenceTd'> no (defaults to <tt>true</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> messageTimeStampEnabled </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if JMS messages are time stamped </td>
<td class='confluenceTd'> no (defaults to <tt>true</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> priority </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> The JMS message priority </td>
<td class='confluenceTd'> no (defaults to 4) </td>
</tr>
<tr>
<td class='confluenceTd'> pubSubDomain </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the destination is a topic</td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> pubSubNoLocal </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if messages published by the listener's <tt>Connection</tt> are suppressed </td>
<td class='confluenceTd'> no (defaults to false) </td>
</tr>
<tr>
<td class='confluenceTd'> recieveTimeout </td>
<td class='confluenceTd'> long </td>
<td class='confluenceTd'> The timeout for receiving a message in milliseconds </td>
<td class='confluenceTd'> no (default is unlimited) </td>
</tr>
<tr>
<td class='confluenceTd'> replyDestinationName </td>
<td class='confluenceTd'> String </td>
<td class='confluenceTd'> The JNDI name of the destination used to receive messages </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> service </td>
<td class='confluenceTd'> QName </td>
<td class='confluenceTd'> The service name of the proxied endpoint </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> stateless </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the consumer retains state information about the message exchange while it is in process </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> timeToLive </td>
<td class='confluenceTd'> long </td>
<td class='confluenceTd'> Specifies the number of milliseconds the message is valid </td>
<td class='confluenceTd'> no (defaults to unlimited)</td>
</tr>
</tbody></table>

<h4><a name="servicemix-jmsnewendpoints-Beans"></a>Beans</h4>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> connectionFactory </td>
<td class='confluenceTd'> ConnectionFactory </td>
<td class='confluenceTd'> The <tt>ConnectionFactory</tt> used to connect with the destination </td>
<td class='confluenceTd'> yes </td>
</tr>
<tr>
<td class='confluenceTd'> destination </td>
<td class='confluenceTd'> Destination </td>
<td class='confluenceTd'> The JMS destination used to send messages </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> destinationChooser </td>
<td class='confluenceTd'> DestinationChooser </td>
<td class='confluenceTd'> A class implementing logic for choosing among JMS destinations </td>
<td class='confluenceTd'> no (defaults to <tt>SimpleDestinationChooser</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> destinationResolver </td>
<td class='confluenceTd'> DestinationResolver </td>
<td class='confluenceTd'> A class implementing logic for converting strings into destination IDs</td>
<td class='confluenceTd'> no (defaults to <tt>DynamicDestinationResolver</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> marshaler </td>
<td class='confluenceTd'> JmsProviderMarshaler </td>
<td class='confluenceTd'> The class implementing the message marshaler </td>
<td class='confluenceTd'> no (defaults to <tt>DefaultProviderMarshaler</tt> or <tt>JmsSoapProviderMarshaler</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> replyDestination </td>
<td class='confluenceTd'> Destination </td>
<td class='confluenceTd'> The JMS destinations to receive messages </td>
<td class='confluenceTd'> no </td>
</tr>
<tr>
<td class='confluenceTd'> storeFactory </td>
<td class='confluenceTd'> StoreFactory </td>
<td class='confluenceTd'> The factory class used to create the data store for state information</td>
<td class='confluenceTd'> no (defaults to <tt>MemoryStoreFactory</tt>) </td>
</tr>
<tr>
<td class='confluenceTd'> store </td>
<td class='confluenceTd'> Store </td>
<td class='confluenceTd'> The data store used to store state information </td>
<td class='confluenceTd'> no </td>
</tr>
</tbody></table>

<h3><a name="servicemix-jmsnewendpoints-SOAPSpecificProperties"></a>SOAP Specific Properties</h3>

<p>The following are only applicable to <tt>&lt;jms:soap-provider /&gt;</tt>.</p>

<h4><a name="servicemix-jmsnewendpoints-Attributes"></a>Attributes</h4>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> useJbiWrapper </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> Specifies if the JBI wrapper is sent in the body of the message </td>
<td class='confluenceTd'> no (defaults to true) </td>
</tr>
<tr>
<td class='confluenceTd'> validateWsdl </td>
<td class='confluenceTd'> boolan </td>
<td class='confluenceTd'> Specifies if the WSDL is checked for WSI-BP compliance </td>
<td class='confluenceTd'> no (defaults to true) </td>
</tr>
<tr>
<td class='confluenceTd'> wsdl </td>
<td class='confluenceTd'> Resource </td>
<td class='confluenceTd'> WSDL describing the service </td>
<td class='confluenceTd'> yes </td>
</tr>
</tbody></table>

<h4><a name="servicemix-jmsnewendpoints-Beans"></a>Beans</h4>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Name </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> policies </td>
<td class='confluenceTd'> Policy[] </td>
<td class='confluenceTd'> A list of interceptors that will process the message </td>
<td class='confluenceTd'> no </td>
</tr>
</tbody></table>
     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action" class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/SM/servicemix-jms+new+endpoints">View Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=64155&revisedVersion=40&originalVersion=39">View Change</a>
              |
       <a href="http://cwiki.apache.org/confluence/display/SM/servicemix-jms+new+endpoints?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message