Author: buildbot
Date: Fri Dec 20 08:19:35 2013
New Revision: 891163
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/seda.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/seda.html
==============================================================================
--- websites/production/camel/content/seda.html (original)
+++ websites/production/camel/content/seda.html Fri Dec 20 08:19:35 2013
@@ -96,9 +96,8 @@
<h3 id="SEDA-URIformat">URI format</h3><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[seda:someName[?options]
]]></script>
-</div></div><p>Where <strong>someName</strong> can be any string that uniquely
identifies the endpoint within the current <a shape="rect"
href="camelcontext.html">CamelContext</a>.</p><p>You can append query options
to the URI in the following format:
<code>?option=value&option=value&…</code></p><h3
id="SEDA-Options">Options</h3><div class="confluenceTableSmall">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p> Name </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Since </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Default </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>size</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The maximum capacity of the SEDA queue (i.e., the
number of messages it can hold). The default value in Camel 2.2 or older is
<code>1000</code>. From Camel 2.3 onwards, the size is unbounded by default.
<strong>Notice:</strong> Mind if you use this option, then its the first
endpoint being created with the queue name, that determines the size. To make
sure all endpoints use same size, then configu
re the size option on all of them, or the first endpoint being created. From
<strong>Camel 2.11</strong> onwards, a validation is taken place to ensure if
using mixed queue sizes for the same queue name, Camel would detect this and
fail creating the endpoint. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>concurrentConsumers</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>1</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Number of concurrent threads processing
exchanges. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>waitForTaskToComplete</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>IfReplyExpected</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Option to specify whether the
caller should wait f
or the async task to complete or not before continuing. The following three
options are supported: <code>Always</code>, <code>Never</code> or
<code>IfReplyExpected</code>. The first two values are self-explanatory. The
last value, <code>IfReplyExpected</code>, will only wait if the message is <a
shape="rect" href="request-reply.html" title="Request Reply">Request Reply</a>
based. The default option is <code>IfReplyExpected</code>. See more information
about <a shape="rect" href="async.html" title="Async">Async</a> messaging.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>timeout</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>30000</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Timeout (in milliseconds) before a SEDA
producer will stop waiting for an asynchronous task to complete. See
<code>waitForTaskToComplete</code> and <a shape="rect"
href="async.html" title="Async">Async</a> for more details. In <strong>Camel
2.2</strong> you can now disable timeout by using 0 or a negative value.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>multipleConsumers</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>2.2</strong> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Specifies whether multiple
consumers are allowed. If enabled, you can use <a shape="rect" href="seda.html"
title="SEDA">SEDA</a> for <a shape="rect" class="external-link"
href="http://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern"
rel="nofollow">Publish-Subscribe</a> messaging. That is, you can send a message
to the SEDA queue and have each consumer receive a copy of the message. When
enabled, this option should be specified on every consumer endpoint.
</p></td></tr><tr><td colspan="1" rowspan="1" class=
"confluenceTd"><p> <code>limitConcurrentConsumers</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>2.3</strong>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether to limit
the number of <code>concurrentConsumers</code> to the maximum of
<code>500</code>. By default, an exception will be thrown if a SEDA endpoint is
configured with a greater number. You can disable that check by turning this
option off. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>blockWhenFull</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>2.9</strong> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether a thread
that sends messages to a full SEDA queue will block until the queue's capacity
is no longer exhausted. By default, an exce
ption will be thrown stating that the queue is full. By enabling this option,
the calling thread will instead block and wait until the message can be
accepted. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>queueSize</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>2.9</strong> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Component only:</strong> The
maximum default size (capacity of the number of messages it can hold) of the
SEDA queue. This option is used if <code>size</code> is not in use.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>pollTimeout</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>2.9.3</strong> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <em>Consumer only</em> 
211; The timeout used when polling. When a timeout occurs, the consumer can
check whether it is allowed to continue running. Setting a lower value allows
the consumer to react more quickly upon shutdown. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>purgeWhenStopping</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<strong>2.11.1</strong> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Whether to purge the task queue when
stopping the consumer/route. This allows to stop faster, as any pending
messages on the queue is discarded. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>queue</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>2.12.0</strong>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> null </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Define the q
ueue instance which will be used by seda endpoint </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>queueFactory</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<strong>2.12.0</strong> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> null </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> Define the QueueFactory which could create the queue
for the seda endpoint </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>failIfNoConsumers</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>2.12.0</strong>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> false
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether the
producer should fail by throwing an exception, when sending to a SEDA queue
with no active consumers. </p></td></tr></tbody></table>
-</div><h3 id="SEDA-ChoosingBlockingQueueimplementation">Choosing BlockingQueue
implementation</h3><p><strong>Available as of Camel 2.12</strong></p><p>By
default, the SEDA component always intantiates LinkedBlockingQueue, but you can
use different implementation, you can reference your own BlockingQueue
implementation, in this case the size option is not used</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>Where <strong>someName</strong> can be any string that uniquely
identifies the endpoint within the current <a shape="rect"
href="camelcontext.html">CamelContext</a>.</p><p>You can append query options
to the URI in the following format:
<code>?option=value&option=value&…</code></p><h3
id="SEDA-Options">Options</h3><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p> Name </p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p> Since </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Default </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>size</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> The maximum capacity of the SEDA queue (i.e., the numbe
r of messages it can hold). The default value in Camel 2.2 or older is
<code>1000</code>. From Camel 2.3 onwards, the size is unbounded by default.
<strong>Notice:</strong> Mind if you use this option, then its the first
endpoint being created with the queue name, that determines the size. To make
sure all endpoints use same size, then configure the size option on all of
them, or the first endpoint being created. From <strong>Camel 2.11</strong>
onwards, a validation is taken place to ensure if using mixed queue sizes for
the same queue name, Camel would detect this and fail creating the endpoint.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>concurrentConsumers</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>1</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> Number of concurrent threads processing exchanges.
</p></td></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"><p> <code>waitForTaskToComplete</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>IfReplyExpected</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option to specify
whether the caller should wait for the async task to complete or not before
continuing. The following three options are supported: <code>Always</code>,
<code>Never</code> or <code>IfReplyExpected</code>. The first two values are
self-explanatory. The last value, <code>IfReplyExpected</code>, will only wait
if the message is <a shape="rect" href="request-reply.html" title="Request
Reply">Request Reply</a> based. The default option is
<code>IfReplyExpected</code>. See more information about <a shape="rect"
href="async.html" title="Async">Async</a> messaging. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>timeout</code>
</p></td><td colspan="1" rows
pan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>30000</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Timeout (in milliseconds) before a SEDA
producer will stop waiting for an asynchronous task to complete. See
<code>waitForTaskToComplete</code> and <a shape="rect" href="async.html"
title="Async">Async</a> for more details. In <strong>Camel 2.2</strong> you can
now disable timeout by using 0 or a negative value. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>multipleConsumers</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<strong>2.2</strong> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Specifies whether multiple consumers are
allowed. If enabled, you can use <a shape="rect" href="seda.html"
title="SEDA">SEDA</a> for <a shape="rect" class="external-link" hre
f="http://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern"
rel="nofollow">Publish-Subscribe</a> messaging. That is, you can send a message
to the SEDA queue and have each consumer receive a copy of the message. When
enabled, this option should be specified on every consumer endpoint.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>limitConcurrentConsumers</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>2.3</strong> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Whether to limit the number of
<code>concurrentConsumers</code> to the maximum of <code>500</code>. By
default, an exception will be thrown if a SEDA endpoint is configured with a
greater number. You can disable that check by turning this option off.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>blockWhenFull</code> </p></td><td colspan=
"1" rowspan="1" class="confluenceTd"><p> <strong>2.9</strong> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Whether a thread
that sends messages to a full SEDA queue will block until the queue's capacity
is no longer exhausted. By default, an exception will be thrown stating that
the queue is full. By enabling this option, the calling thread will instead
block and wait until the message can be accepted. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>queueSize</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<strong>2.9</strong> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Component only:</strong> The maximum default
size (capacity of the number of messages it can hold) of the SEDA queue. This
option is used if <code>size</code> is not in use. </p>
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>pollTimeout</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>2.9.3</strong> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <em>Consumer only</em> – The timeout
used when polling. When a timeout occurs, the consumer can check whether it is
allowed to continue running. Setting a lower value allows the consumer to react
more quickly upon shutdown. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>purgeWhenStopping</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>2.11.1</strong>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>false</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> Whether to purge the task queue when stopping the
consumer/route. This allows to stop faster, as any pending messages
on the queue is discarded. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>queue</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>2.12.0</strong> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> null </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Define the queue instance which will be
used by seda endpoint </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>queueFactory</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>2.12.0</strong> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> null </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Define the QueueFactory which could create
the queue for the seda endpoint </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>failIfNoConsumers</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>2.12.0</strong>
</p></td><td colspan="1" ro
wspan="1" class="confluenceTd"><p> false </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> Whether the producer should fail by throwing an
exception, when sending to a SEDA queue with no active consumers.
</p></td></tr></tbody></table>
+<h3 id="SEDA-ChoosingBlockingQueueimplementation">Choosing BlockingQueue
implementation</h3><p><strong>Available as of Camel 2.12</strong></p><p>By
default, the SEDA component always intantiates LinkedBlockingQueue, but you can
use different implementation, you can reference your own BlockingQueue
implementation, in this case the size option is not used</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<bean id="arrayQueue"
class="java.util.ArrayBlockingQueue">
<constructor-arg index="0" value="10" ><!-- size
-->
<constructor-arg index="1" value="true" ><!--
fairness -->