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 62F8510E66 for ; Sat, 31 May 2014 13:19:11 +0000 (UTC) Received: (qmail 29732 invoked by uid 500); 31 May 2014 13:19:10 -0000 Delivered-To: apmail-camel-commits-archive@camel.apache.org Received: (qmail 29675 invoked by uid 500); 31 May 2014 13:19:10 -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 29668 invoked by uid 99); 31 May 2014 13:19:10 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 31 May 2014 13:19:10 +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; Sat, 31 May 2014 13:19:08 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id D65D32388868 for ; Sat, 31 May 2014 13:18:48 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r910692 - in /websites/production/camel/content: cache/main.pageCache wire-tap.html Date: Sat, 31 May 2014 13:18:48 -0000 To: commits@camel.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140531131848.D65D32388868@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: buildbot Date: Sat May 31 13:18:48 2014 New Revision: 910692 Log: Production update by buildbot for camel Modified: websites/production/camel/content/cache/main.pageCache websites/production/camel/content/wire-tap.html Modified: websites/production/camel/content/cache/main.pageCache ============================================================================== Binary files - no diff available. Modified: websites/production/camel/content/wire-tap.html ============================================================================== --- websites/production/camel/content/wire-tap.html (original) +++ websites/production/camel/content/wire-tap.html Sat May 31 13:18:48 2014 @@ -93,7 +93,7 @@

If you Wire Tap a stream message body then you should consider enabling Stream caching to ensure the message body can be read at each endpoint. See more details at Stream caching.

-

Options

Name

Default Value

Description

uri

 

The URI of the endpoint to which the wire-tapped message will be sent. You should use either uri or ref.

ref

 

Reference identifier of the endpoint to which the wire-tapped message will be sent. You should use either uri or re f.

executorServiceRef

 

Reference identifier of a custom Thread Pool to use when processing the wire-tapped messages. If not set, Camel will use a default thread pool.

processorRef

 

Reference identifier of a custom Processor to use for creating a new message (e.g., the "send a new message" mode). See below.

copy

true

Camel 2.3: Whether to copy the Exchange before wire-tapping the message.

onPrepareRef

 

Camel 2.8: Reference identifier of a custom Processor to prepare the copy of the Exchange to be wire-tapped. This allows you to do any custom logic, such as deep-cloning the message payload.

WireTap thread pool

The Wire Tap uses a thread pool to process the tapped messages. This thread pool will by default use the settings detailed at Threading Model. In particular, when the pool is exhausted (with all threads utilized), further wiretaps will be executed synchronously by the calling thread. To remedy this, you can configure an explicit thread pool on the Wire Tap having either a different rejection policy, a larger worker queue, or more worker threads.

WireTap node

Camel's Wire Tap node supports two flavors when tapping an Exchange:

-With the traditional Wire Tap, Camel will copy the original Exchange and set its Exchange Pattern to InOnly, as we want the tapped Exchange to be sent in a fire and forget style. The tapped Exchange is then sent in a separate thread so it can run in paralle l with the original. Beware that only the Exchange is copied - Wire Tap won't do a deep clone. So all copies could share objects from the original Exchange.

-Camel also provides an option of sending a new Exchange allowing you to populate it with new values.

Sending a copy (traditional wiretap)

Using the Fluent Builders

+

Options

Name

Default Value

Description

uri

 

The URI of the endpoint to which the wire-tapped message will be sent. You should use either uri or ref.

ref

 

Reference identifier of the endpoint to which the wire-tapped message will be sent. You should use either uri or re f.

executorServiceRef

 

Reference identifier of a custom Thread Pool to use when processing the wire-tapped messages. If not set, Camel will use a default thread pool.

processorRef

 

Reference identifier of a custom Processor to use for creating a new message (e.g., the "send a new message" mode). See below.

copy

true

Camel 2.3: Whether to copy the Exchange before wire-tapping the message.

onPrepareRef

 

Camel 2.8: Reference identifier of a custom Processor to prepare the copy of the Exchange to be wire-tapped. This allows you to do any custom logic, such as deep-cloning the message payload.

WireTap thread pool

The Wire Tap uses a thread pool to process the tapped messages. This thread pool will by default use the settings detailed at Threading Model. In particular, when the pool is exhausted (with all threads utilized), further wiretaps will be executed synchronously by the calling thread. To remedy this, you can configure an explicit thread pool on the Wire Tap having either a different rejection policy, a larger worker queue, or more worker threads.

WireTap node

Camel's Wire Tap node supports two flavors when tapping an Exchange:

-With the traditional Wire Tap, Camel will copy the original Exchange and set its Exchange Pattern to InOnly, as we want the tapped Exchange to be sent in a fire and forget style. The tapped Exchange is then sent in a separate thread so it can run in parallel with the original. Bewar e that only the Exchange is copied - Wire Tap won't do a deep clone (unless you specify a custom processor via onPrepareRef which does that). So all copies could share objects from the original Exchange.

-Camel also provides an option of sending a new Exchange allowing you to populate it with new values.

Sending a copy (traditional wiretap)

Using the Fluent Builders