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 &
Non-Durable)</li><li>InOnly & 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"> </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"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>keyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan
="1" class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>maxConnections</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> </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"> </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"> </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"> </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"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>keyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>DefaultJmsKeyFormatStrategy</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">
<tt>transactionCommitStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </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, & Producer Pooling & 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 & 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 & 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>