camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r833082 - in /websites/production/camel/content: cache/main.pageCache sjms.html
Date Wed, 26 Sep 2012 16:17:37 GMT
Author: buildbot
Date: Wed Sep 26 16:17:37 2012
New Revision: 833082

Log:
Production update by buildbot for camel

Modified:
    websites/production/camel/content/cache/main.pageCache
    websites/production/camel/content/sjms.html

Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/camel/content/sjms.html
==============================================================================
--- websites/production/camel/content/sjms.html (original)
+++ websites/production/camel/content/sjms.html Wed Sep 26 16:17:37 2012
@@ -81,7 +81,7 @@
 
 <div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif"
width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">This
component is under active development.</td></tr></table></div>
 
-<p>The SJMS Component is a JMS client API for use with Camel. It is based purely on
the JMS API and as such does not rely on any third party messaging implementations keeping
it light and flexible.  It is scheduled to be released as part of Camel 2.11 with the following
functionality:</p>
+<p>The SJMS Component is a JMS client for use with Camel. SJMS uses a JMS client API
written explicitly for Camel and does not depend on any third party messaging implementations
keeping it light and flexible.  It is scheduled to be released as part of Camel 2.11 with
the following functionality:</p>
 
 <ul><li>Standard Queue and Topic Support (Durable &amp; Non-Durable)</li><li>InOnly
&amp; InOut MEP Support</li><li>Asynchronous Producer and Consumer Processing</li><li>Internal
JMS Transaction Support</li></ul>
 
@@ -144,7 +144,7 @@ sjms:topic:Stocks.Prices
 <p>The SJMS Component supports the following configuration options:</p>
 
 <div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh">
Required </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value
</th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>connectionFactory</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <img align="middle" class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"
height="16" width="16" alt="" border="0"> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
A <a shape="rect" class="external-link" href="http://docs.oracle.com/javaee/5/api/javax/jms/ConnectionFactory.html"
rel="nofollow">ConnectionFactory</a> is required to enable the SjmsComponent. It
can be set directly or set set as part of a ConnectionResource. </td>
 </tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>connectionResource</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> A ConnectionResource is an interface that
allows for customization and container control of the ConnectionFactory.  See <a shape="rect"
href="#SJMS-connectionresource">Plugable Connection Resource Management</a> for further
details. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>headerFilterStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>keyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan
 ="1" class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>maxConnections</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The maximum number of connections available to endpoints started
under this component </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>transactionCommitStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>DefaultTransactionCommitStrategy()</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> Defines the number of <a
shape="rect" class="external-link" href="http://docs.oracle.com/javaee/5/api/javax/jms/MessageProducer.html"
rel="nofollow">MessageProducer</a> instances. </td></tr></tbody
 ></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh">
Required </th><th colspan="1" rowspan="1" class="confluenceTh"> Default Value
</th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>connectionCount</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The maximum number of connections available to endpoints started
under this component </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>connectionFactory</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<img align="middle" class="emoticon" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"
height="16" width="16" alt="" border="0"> </td><td colspan="1" rowspan="1" c
 lass="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A <a shape="rect" class="external-link" href="http://docs.oracle.com/javaee/5/api/javax/jms/ConnectionFactory.html"
rel="nofollow">ConnectionFactory</a> is required to enable the SjmsComponent. It
can be set directly or set set as part of a ConnectionResource. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>connectionResource</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A ConnectionResource is an interface that allows for customization
and container control of the ConnectionFactory.  See <a shape="rect" href="#SJMS-connectionresource">Plugable
Connection Resource Management</a> for further details. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>headerFilterStrategy</tt>
</td><td colspan="1" rowspan="1" cl
 ass="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>DefaultJmsKeyFormatStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>keyFormatStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>DefaultJmsKeyFormatStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>transactionCommitStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td></tr></tbody></table>
 </div>
 </div>
 
@@ -192,11 +192,15 @@ component.setMaxConnections(1);
 
 <h3><a shape="rect" name="SJMS-UsageNotes"></a>Usage Notes</h3>
 
-<p>As stated above SJMS Component uses a JMS client API that was written from the ground
up for use in Camel. As such there are some key behaviors and features that deserve noting.</p>
-
 <h4><a shape="rect" name="SJMS-PlugableConnectionResourceManagement"></a>Plugable
Connection Resource Management <a shape="rect" name="SJMS-connectionresource"></a></h4>
 
-<p>SJMS uses a ConnectionResource </p>
+<p>SJMS provides JMS <a shape="rect" class="external-link" href="http://docs.oracle.com/javaee/5/api/javax/jms/Connection.html"
rel="nofollow">Connection</a> resource management through built-in connection pooling.
This eliminates the need to depend on third party API pooling logic. However there may be
times that you are required to use an external Connection resource manager such as those provided
by J2EE or OSGi containers. For this SJMS provides an interface that can be used to override
the internal SJMS Connection pooling capabilities. This is accomplished through the <tt>ConnectionResource</tt>
interface. </p>
+
+<p>The <tt>ConnectionResource</tt> provides methods for barrowing and returning
Connections as needed is the contract used to provide </p>
+<div class="error"><span class="error">Unknown macro: {@link Connection}</span>
</div>
+<p> pools to the SJMS component. A user should use when it is necessary to integrate
SJMS with an external connection pooling manager.</p>
+
+<p>It is recommended though that for standard <a shape="rect" class="external-link"
href="http://docs.oracle.com/javaee/5/api/javax/jms/ConnectionFactory.html" rel="nofollow">ConnectionFactory</a>
providers you use the <tt>ConnectionFactoryResource</tt> implementation that is
provided with SJMS as it is optimized for this component. </p>
 
 <h4><a shape="rect" name="SJMS-Session%2CConsumer%2C%26ProducerPooling%26CachingManagement"></a>Session,
Consumer, &amp; Producer Pooling &amp; Caching Management</h4>
 
@@ -218,9 +222,8 @@ component.setMaxConnections(1);
 
 <p>Keys starting with JMS or JMSX are reserved.<br clear="none">
 exchange.in.headers keys must be literals and all be valid Java identifiers (do not use dots
in the key name).<br clear="none">
-Camel replaces dots &amp; hyphens and the reverse when when consuming JMS messages:<br
clear="none">
-. is replaced by <em>DOT</em> and the reverse replacement when Camel consumes
the message.</p>
-<ul class="alternate" type="square"><li>is replaced by <em>HYPHEN</em>
and the reverse replacement when Camel consumes the message.<br clear="none">
+Camel replaces dots &amp; hyphens and the reverse when when consuming JMS messages:</p>
+<ul><li>is replaced by <em>DOT</em> and the reverse replacement when
Camel consumes the message.</li><li>is replaced by <em>HYPHEN</em>
and the reverse replacement when Camel consumes the message.<br clear="none">
 See also the option jmsKeyFormatStrategy, which allows use of your own custom strategy for
formatting keys.</li></ul>
 
 



Mime
View raw message