Author: buildbot
Date: Mon Jan 21 12:23:50 2013
New Revision: 847450
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-in-one-page.html
websites/production/camel/content/book-pattern-appendix.html
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/message-filter.html
websites/production/camel/content/throttler.html
Modified: websites/production/camel/content/book-in-one-page.html
==============================================================================
--- websites/production/camel/content/book-in-one-page.html (original)
+++ websites/production/camel/content/book-in-one-page.html Mon Jan 21 12:23:50
2013
@@ -15339,7 +15339,7 @@ from(<span class="code-quote">"activemq:
<p><span class="image-wrap" style=""><img
src="http://www.enterpriseintegrationpatterns.com/img/MessageFilter.gif";
style="border: 0px solid black"></span></p>
-<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b> which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
+<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b>, which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
<p><b>Using the <a shape="rect" href="fluent-builders.html" title="Fluent
Builders">Fluent Builders</a></b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -15355,7 +15355,7 @@ from(<span class="code-quote">"activemq:
</pre>
</div></div>
-<p>You can of course use many different <a shape="rect" href="predicate.html"
title="Predicate">Predicate</a> languages such as <a shape="rect"
href="xpath.html" title="XPath">XPath</a>, <a shape="rect" href="xquery.html"
title="XQuery">XQuery</a>, <a shape="rect" href="sql.html" title="SQL">SQL</a>
or various <a shape="rect" href="scripting-languages.html" title="Scripting
Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
+<p>You can, of course, use many different <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> languages such as <a
shape="rect" href="xpath.html" title="XPath">XPath</a>, <a shape="rect"
href="xquery.html" title="XQuery">XQuery</a>, <a shape="rect" href="sql.html"
title="SQL">SQL</a> or various <a shape="rect" href="scripting-languages.html"
title="Scripting Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">from(<span class="code-quote">"direct:start"</span>).
@@ -15419,9 +15419,9 @@ from(<span class="code-quote">"direct:st
<h4><a shape="rect"
name="BookInOnePage-KnowingifExchangewasfilteredornot"></a>Knowing if <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was filtered or
not</h4>
<p><b>Available as of Camel 2.5</b></p>
-<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> which states if it was
filtered or not.</p>
+<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> that states if it was
filtered or not.</p>
-<p>The property has the key <tt>Exchannge.FILTER_MATCHED</tt> which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block.</p>
+<p>The property has the key <tt>Exchange.FILTER_MATCHED</tt>, which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block. This property will be visible within the <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> block
who's <a shape="rect" href="predicate.html" title="Predicate">Predicate</a>
matches (value set to <tt>true</tt>), and to the steps immediately following
the <a shape="rect" href="message-filter.html" title="Message Filter">Message
Filter</a> with the value set based on the results of the last <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> <a
shape="rect" href="predicate.html" title="Predicate">Predicate</a>
evaluated.</p>
<h4><a shape="rect" name="BookInOnePage-UsingThisPattern"></a>Using This
Pattern</h4>
@@ -17549,7 +17549,7 @@ from(<span class="code-quote">"activemq:
<h3><a shape="rect" name="BookInOnePage-Options"></a>Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided and a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in millis, in which the
throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rowspan="
1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if <tt>asyncDelayed</tt>
was enabled. This controls if the caller thread should execute the task if the
thread pool rejected the task. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided as a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in milliseconds, in whic
h the throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rows
pan="1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if
<tt>asyncDelayed</tt> was enabled. This controls if the caller thread should
execute the task if the thread pool rejected the task.
</td></tr></tbody></table>
</div>
</div>
@@ -17562,7 +17562,9 @@ from(<span class="code-quote">"activemq:
</pre>
</div></div>
-<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window. Note that typically you would
often use the default time period of a second. So to throttle requests at 100
requests per second between two endpoints it would look more like this...</p>
+<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window.</p>
+
+<p>Note that since <tt>timePeriodMillis</tt> defaults to 1000 milliseconds,
just setting the <tt>maximumRequestsPerPeriod</tt> has the effect of setting
the maximum number of requests per second. So to throttle requests at 100
requests per second between two endpoints, it would look more like this...</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
@@ -17599,7 +17601,7 @@ from(<span class="code-quote">"seda:a"</
</div></div>
<h3><a shape="rect"
name="BookInOnePage-Dynamicallychangingmaximumrequestsperperiod"></a>Dynamically
changing maximum requests per period</h3>
-<p><b>Available os of Camel 2.8</b> <br clear="none">
+<p><b>Available as of Camel 2.8</b> <br clear="none">
Since we use an <a shape="rect" href="expression.html"
title="Expression">Expression</a> you can adjust this value at runtime, for
example you can provide a header with the value. At runtime Camel evaluates the
expression and converts the result to a <tt>java.lang.Long</tt> type. In the
example below we use a header from the message to determine the maximum
requests per period. If the header is absent, then the <a shape="rect"
href="throttler.html" title="Throttler">Throttler</a> uses the old value. So
that allows you to only provide a header if the value is to be changed:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml"><span class="code-tag"><route></span>
@@ -17616,7 +17618,7 @@ Since we use an <a shape="rect" href="ex
<h3><a shape="rect" name="BookInOnePage-Asynchronousdelaying"></a>Asynchronous
delaying</h3>
<p><b>Available as of Camel 2.4</b></p>
-<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages etc.</p>
+<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages, etc.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
Modified: websites/production/camel/content/book-pattern-appendix.html
==============================================================================
--- websites/production/camel/content/book-pattern-appendix.html (original)
+++ websites/production/camel/content/book-pattern-appendix.html Mon Jan 21
12:23:50 2013
@@ -1094,7 +1094,7 @@ from(<span class="code-quote">"activemq:
<p><span class="image-wrap" style=""><img
src="http://www.enterpriseintegrationpatterns.com/img/MessageFilter.gif";
style="border: 0px solid black"></span></p>
-<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b> which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
+<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b>, which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
<p><b>Using the <a shape="rect" href="fluent-builders.html" title="Fluent
Builders">Fluent Builders</a></b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -1110,7 +1110,7 @@ from(<span class="code-quote">"activemq:
</pre>
</div></div>
-<p>You can of course use many different <a shape="rect" href="predicate.html"
title="Predicate">Predicate</a> languages such as <a shape="rect"
href="xpath.html" title="XPath">XPath</a>, <a shape="rect" href="xquery.html"
title="XQuery">XQuery</a>, <a shape="rect" href="sql.html" title="SQL">SQL</a>
or various <a shape="rect" href="scripting-languages.html" title="Scripting
Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
+<p>You can, of course, use many different <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> languages such as <a
shape="rect" href="xpath.html" title="XPath">XPath</a>, <a shape="rect"
href="xquery.html" title="XQuery">XQuery</a>, <a shape="rect" href="sql.html"
title="SQL">SQL</a> or various <a shape="rect" href="scripting-languages.html"
title="Scripting Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">from(<span class="code-quote">"direct:start"</span>).
@@ -1174,9 +1174,9 @@ from(<span class="code-quote">"direct:st
<h4><a shape="rect"
name="BookPatternAppendix-KnowingifExchangewasfilteredornot"></a>Knowing if <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was filtered or
not</h4>
<p><b>Available as of Camel 2.5</b></p>
-<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> which states if it was
filtered or not.</p>
+<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> that states if it was
filtered or not.</p>
-<p>The property has the key <tt>Exchannge.FILTER_MATCHED</tt> which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block.</p>
+<p>The property has the key <tt>Exchange.FILTER_MATCHED</tt>, which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block. This property will be visible within the <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> block
who's <a shape="rect" href="predicate.html" title="Predicate">Predicate</a>
matches (value set to <tt>true</tt>), and to the steps immediately following
the <a shape="rect" href="message-filter.html" title="Message Filter">Message
Filter</a> with the value set based on the results of the last <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> <a
shape="rect" href="predicate.html" title="Predicate">Predicate</a>
evaluated.</p>
<h4><a shape="rect" name="BookPatternAppendix-UsingThisPattern"></a>Using This
Pattern</h4>
@@ -3304,7 +3304,7 @@ from(<span class="code-quote">"activemq:
<h3><a shape="rect" name="BookPatternAppendix-Options"></a>Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided and a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in millis, in which the
throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rowspan="
1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if <tt>asyncDelayed</tt>
was enabled. This controls if the caller thread should execute the task if the
thread pool rejected the task. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided as a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in milliseconds, in whic
h the throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rows
pan="1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if
<tt>asyncDelayed</tt> was enabled. This controls if the caller thread should
execute the task if the thread pool rejected the task.
</td></tr></tbody></table>
</div>
</div>
@@ -3317,7 +3317,9 @@ from(<span class="code-quote">"activemq:
</pre>
</div></div>
-<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window. Note that typically you would
often use the default time period of a second. So to throttle requests at 100
requests per second between two endpoints it would look more like this...</p>
+<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window.</p>
+
+<p>Note that since <tt>timePeriodMillis</tt> defaults to 1000 milliseconds,
just setting the <tt>maximumRequestsPerPeriod</tt> has the effect of setting
the maximum number of requests per second. So to throttle requests at 100
requests per second between two endpoints, it would look more like this...</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
@@ -3354,7 +3356,7 @@ from(<span class="code-quote">"seda:a"</
</div></div>
<h3><a shape="rect"
name="BookPatternAppendix-Dynamicallychangingmaximumrequestsperperiod"></a>Dynamically
changing maximum requests per period</h3>
-<p><b>Available os of Camel 2.8</b> <br clear="none">
+<p><b>Available as of Camel 2.8</b> <br clear="none">
Since we use an <a shape="rect" href="expression.html"
title="Expression">Expression</a> you can adjust this value at runtime, for
example you can provide a header with the value. At runtime Camel evaluates the
expression and converts the result to a <tt>java.lang.Long</tt> type. In the
example below we use a header from the message to determine the maximum
requests per period. If the header is absent, then the <a shape="rect"
href="throttler.html" title="Throttler">Throttler</a> uses the old value. So
that allows you to only provide a header if the value is to be changed:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml"><span class="code-tag"><route></span>
@@ -3371,7 +3373,7 @@ Since we use an <a shape="rect" href="ex
<h3><a shape="rect"
name="BookPatternAppendix-Asynchronousdelaying"></a>Asynchronous delaying</h3>
<p><b>Available as of Camel 2.4</b></p>
-<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages etc.</p>
+<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages, etc.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/message-filter.html
==============================================================================
--- websites/production/camel/content/message-filter.html (original)
+++ websites/production/camel/content/message-filter.html Mon Jan 21 12:23:50
2013
@@ -81,7 +81,7 @@
<p><span class="image-wrap" style=""><img
src="http://www.enterpriseintegrationpatterns.com/img/MessageFilter.gif";
style="border: 0px solid black"></span></p>
-<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b> which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
+<p>The following example shows how to create a Message Filter route consuming
messages from an endpoint called <b>queue:a</b>, which if the <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> is true will be
dispatched to <b>queue:b</b></p>
<p><b>Using the <a shape="rect" href="fluent-builders.html" title="Fluent
Builders">Fluent Builders</a></b></p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
@@ -97,7 +97,7 @@
</pre>
</div></div>
-<p>You can of course use many different <a shape="rect" href="predicate.html"
title="Predicate">Predicate</a> languages such as <a shape="rect"
href="xpath.html" title="XPath">XPath</a>, <a shape="rect" href="xquery.html"
title="XQuery">XQuery</a>, <a shape="rect" href="sql.html" title="SQL">SQL</a>
or various <a shape="rect" href="scripting-languages.html" title="Scripting
Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
+<p>You can, of course, use many different <a shape="rect"
href="predicate.html" title="Predicate">Predicate</a> languages such as <a
shape="rect" href="xpath.html" title="XPath">XPath</a>, <a shape="rect"
href="xquery.html" title="XQuery">XQuery</a>, <a shape="rect" href="sql.html"
title="SQL">SQL</a> or various <a shape="rect" href="scripting-languages.html"
title="Scripting Languages">Scripting Languages</a>. Here is an <a shape="rect"
class="external-link"
href="http://svn.apache.org/repos/asf/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/XPathFilterTest.java";>XPath
example</a> </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">from(<span class="code-quote">"direct:start"</span>).
@@ -161,9 +161,9 @@ from(<span class="code-quote">"direct:st
<h4><a shape="rect"
name="MessageFilter-KnowingifExchangewasfilteredornot"></a>Knowing if <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was filtered or
not</h4>
<p><b>Available as of Camel 2.5</b></p>
-<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> which states if it was
filtered or not.</p>
+<p>The <a shape="rect" href="message-filter.html" title="Message
Filter">Message Filter</a> EIP will add a property on the <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> that states if it was
filtered or not.</p>
-<p>The property has the key <tt>Exchannge.FILTER_MATCHED</tt> which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block.</p>
+<p>The property has the key <tt>Exchange.FILTER_MATCHED</tt>, which has the
String value of <tt>CamelFilterMatched</tt>. Its value is a boolean indicating
<tt>true</tt> or <tt>false</tt>. If the value is <tt>true</tt> then the <a
shape="rect" href="exchange.html" title="Exchange">Exchange</a> was routed in
the filter block. This property will be visible within the <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> block
who's <a shape="rect" href="predicate.html" title="Predicate">Predicate</a>
matches (value set to <tt>true</tt>), and to the steps immediately following
the <a shape="rect" href="message-filter.html" title="Message Filter">Message
Filter</a> with the value set based on the results of the last <a shape="rect"
href="message-filter.html" title="Message Filter">Message Filter</a> <a
shape="rect" href="predicate.html" title="Predicate">Predicate</a>
evaluated.</p>
<h4><a shape="rect" name="MessageFilter-UsingThisPattern"></a>Using This
Pattern</h4>
Modified: websites/production/camel/content/throttler.html
==============================================================================
--- websites/production/camel/content/throttler.html (original)
+++ websites/production/camel/content/throttler.html Mon Jan 21 12:23:50 2013
@@ -82,7 +82,7 @@
<h3><a shape="rect" name="Throttler-Options"></a>Options</h3>
<div class="confluenceTableSmall"><div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided and a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in millis, in which the
throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rowspan="
1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if <tt>asyncDelayed</tt>
was enabled. This controls if the caller thread should execute the task if the
thread pool rejected the task. </td></tr></tbody></table>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Name </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>maximumRequestsPerPeriod</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Maximum number of requests per period to throttle. This
option must be provided as a positive number. Notice, in the XML DSL, from
<b>Camel 2.8</b> onwards this option is configured using an <a shape="rect"
href="expression.html" title="Expression">Expression</a> instead of an
attribute. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>timePeriodMillis</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> The time period in milliseconds, in whic
h the throttler will allow at most <tt>maximumRequestsPerPeriod</tt> number of
messages. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>asyncDelayed</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>false</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.4:</b> If enabled then any messages which is delayed happens asynchronously
using a scheduled thread pool. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>executorServiceRef</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.4:</b> Refers to a custom <a shape="rect"
href="threading-model.html" title="Threading Model">Thread Pool</a> to be used
if <tt>asyncDelay</tt> has been enabled. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>callerRunsWhenRejected</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td
colspan="1" rows
pan="1" class="confluenceTd"> <b>Camel 2.4:</b> Is used if
<tt>asyncDelayed</tt> was enabled. This controls if the caller thread should
execute the task if the thread pool rejected the task.
</td></tr></tbody></table>
</div>
</div>
@@ -95,7 +95,9 @@
</pre>
</div></div>
-<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window. Note that typically you would
often use the default time period of a second. So to throttle requests at 100
requests per second between two endpoints it would look more like this...</p>
+<p>So the above example will throttle messages all messages received on
<b>seda:a</b> before being sent to <b>mock:result</b> ensuring that a maximum
of 3 messages are sent in any 10 second window.</p>
+
+<p>Note that since <tt>timePeriodMillis</tt> defaults to 1000 milliseconds,
just setting the <tt>maximumRequestsPerPeriod</tt> has the effect of setting
the maximum number of requests per second. So to throttle requests at 100
requests per second between two endpoints, it would look more like this...</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
@@ -132,7 +134,7 @@ from(<span class="code-quote">"seda:a"</
</div></div>
<h3><a shape="rect"
name="Throttler-Dynamicallychangingmaximumrequestsperperiod"></a>Dynamically
changing maximum requests per period</h3>
-<p><b>Available os of Camel 2.8</b> <br clear="none">
+<p><b>Available as of Camel 2.8</b> <br clear="none">
Since we use an <a shape="rect" href="expression.html"
title="Expression">Expression</a> you can adjust this value at runtime, for
example you can provide a header with the value. At runtime Camel evaluates the
expression and converts the result to a <tt>java.lang.Long</tt> type. In the
example below we use a header from the message to determine the maximum
requests per period. If the header is absent, then the <a shape="rect"
href="throttler.html" title="Throttler">Throttler</a> uses the old value. So
that allows you to only provide a header if the value is to be changed:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-xml"><span class="code-tag"><route></span>
@@ -149,7 +151,7 @@ Since we use an <a shape="rect" href="ex
<h3><a shape="rect" name="Throttler-Asynchronousdelaying"></a>Asynchronous
delaying</h3>
<p><b>Available as of Camel 2.4</b></p>
-<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages etc.</p>
+<p>You can let the <a shape="rect" href="throttler.html"
title="Throttler">Throttler</a> use non blocking asynchronous delaying, which
means Camel will use a scheduler to schedule a task to be executed in the
future. The task will then continue routing. This allows the caller thread to
not block and be able to service other messages, etc.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
<pre class="code-java">
![http://www.enterpriseintegrationpatterns.com/img/MessageFilter.gif"](http://www.enterpriseintegrationpatterns.com/img/MessageFilter.gif"){kind=link}