Return-Path: X-Original-To: apmail-camel-commits-archive@www.apache.org Delivered-To: apmail-camel-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 2FD0DDAC4 for ; Wed, 26 Sep 2012 16:18:22 +0000 (UTC) Received: (qmail 73279 invoked by uid 500); 26 Sep 2012 16:18:22 -0000 Delivered-To: apmail-camel-commits-archive@camel.apache.org Received: (qmail 73216 invoked by uid 500); 26 Sep 2012 16:18:22 -0000 Mailing-List: contact commits-help@camel.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@camel.apache.org Delivered-To: mailing list commits@camel.apache.org Received: (qmail 73208 invoked by uid 99); 26 Sep 2012 16:18:22 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 26 Sep 2012 16:18:22 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 26 Sep 2012 16:18:20 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id C0A9323888E4 for ; Wed, 26 Sep 2012 16:17:37 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r833082 - in /websites/production/camel/content: cache/main.pageCache sjms.html Date: Wed, 26 Sep 2012 16:17:37 -0000 To: commits@camel.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120926161737.C0A9323888E4@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org 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 @@
This component is under active development.
-

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:

+

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:

  • Standard Queue and Topic Support (Durable & Non-Durable)
  • InOnly & InOut MEP Support
  • Asynchronous Producer and Consumer Processing
  • Internal JMS Transaction Support
@@ -144,7 +144,7 @@ sjms:topic:Stocks.Prices

The SJMS Component supports the following configuration options:

-
Option Required Default Value Description
connectionFactory null A ConnectionFactory is required to enable the SjmsComponent. It can be set directly or set set as part of a ConnectionResource.
connectionResource   null A ConnectionResource is an interface that allows for customization and container control of the ConnectionFactory. See Plugable Connection Resource Management for further details.
headerFilterStrategy   DefaultJmsKeyFormatStrategy  
keyFormatStrategy   DefaultJmsKeyFormatStrategy  
maxConnections   1 The maximum number of connections available to endpoints started under this component
transactionCommitStrategy   DefaultTransactionCommitStrategy() Defines the number of MessageProducer instances.
+
Option Required Default Value Description
connectionCount   1 The maximum number of connections available to endpoints started under this component
connectionFactory null A ConnectionFactory is required to enable the SjmsComponent. It can be set directly or set set as part of a ConnectionResource.
connectionResource   null A ConnectionResource is an interface that allows for customization and container control of the ConnectionFactory. See Plugable Connection Resource Management for further details.
headerFilterStrategy   DefaultJmsKeyFormatStrategy  
keyFormatStrategy   DefaultJmsKeyFormatStrategy  
transactionCommitStrategy   null  
@@ -192,11 +192,15 @@ component.setMaxConnections(1);

Usage Notes

-

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.

-

Plugable Connection Resource Management

-

SJMS uses a ConnectionResource

+

SJMS provides JMS Connection 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 ConnectionResource interface.

+ +

The ConnectionResource provides methods for barrowing and returning Connections as needed is the contract used to provide

+
Unknown macro: {@link Connection}
+

pools to the SJMS component. A user should use when it is necessary to integrate SJMS with an external connection pooling manager.

+ +

It is recommended though that for standard ConnectionFactory providers you use the ConnectionFactoryResource implementation that is provided with SJMS as it is optimized for this component.

Session, Consumer, & Producer Pooling & Caching Management

@@ -218,9 +222,8 @@ component.setMaxConnections(1);

Keys starting with JMS or JMSX are reserved.
exchange.in.headers keys must be literals and all be valid Java identifiers (do not use dots in the key name).
-Camel replaces dots & hyphens and the reverse when when consuming JMS messages:
-. is replaced by DOT and the reverse replacement when Camel consumes the message.

-
  • is replaced by HYPHEN and the reverse replacement when Camel consumes the message.
    +Camel replaces dots & hyphens and the reverse when when consuming JMS messages:

    +
    • is replaced by DOT and the reverse replacement when Camel consumes the message.
    • is replaced by HYPHEN and the reverse replacement when Camel consumes the message.
      See also the option jmsKeyFormatStrategy, which allows use of your own custom strategy for formatting keys.