Author: buildbot
Date: Sun Jun 24 13:21:29 2012
New Revision: 822956
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/book-component-appendix.html
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/camel-2100-release.html
websites/production/camel/content/file2.html
websites/production/camel/content/polling-consumer.html
Modified: websites/production/camel/content/book-component-appendix.html
==============================================================================
--- websites/production/camel/content/book-component-appendix.html (original)
+++ websites/production/camel/content/book-component-appendix.html Sun Jun 24
13:21:29 2012
@@ -3657,7 +3657,7 @@ This option provides the build in strate
<br clear="none" class="atl-forced-newline"> <tt>rename</tt> is for using a
try to rename the file as a test if we can get exclusive read-lock.
<br clear="none" class="atl-forced-newline"> <tt>none</tt> is for no read
locks at all.<br clear="none">
Notice from <b>Camel 2.10</b> onwards the read locks <tt>changed</tt>,
<tt>fileLock</tt> and <tt>rename</tt> will also use a <tt>markerFile</tt> as
well, to ensure not picking up files that may be in process by another Camel
consumer running on another node (eg cluster). This is only supported by the
file component (not the ftp component). </td></tr><tr><td></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>readLockTimeout</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"><ul class="alternate"
type="square"><li></li></ul>
-</td><td colspan="1" rowspan="1" class="confluenceTd"> Optional timeout in
millis for the read-lock, if supported by the read-lock. If the read-lock could
not be granted and the timeout triggered, then Camel will skip the file. At
next poll Camel, will try the file again, and this time maybe the read-lock
could be granted. Use a value of 0 or lower to indicate forever. In <b>Camel
2.0</b> the default value is 0. In <b>Camel 2.1</b> the default value is 10000.
Currently <tt>fileLock</tt>, <tt>changed</tt> and <tt>rename</tt> support the
timeout. For <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockTimeout</tt> value is 20000. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>readLockCheckInterval</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>1000</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.6:</b> Interval in
millis for the read-lock, if supported by the read lock. This interval is used
for sleeping between attempts to acquire the read lock. For example when
using the <tt>changed</tt> read lock, you can set a higher interval period to
cater for <em>slow writes</em>. The default of 1 sec. may be <em>too fast</em>
if the producer is very slow writing the file. For <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockCheckInterval</tt> is <tt>5000</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>directoryMustExist</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.5:</b> Similar to
<tt>startingDirectoryMustExist</tt> but this applies during polling recursive
sub directories. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>doneFileName</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.6:</b> If provided, Camel will
only consume files if a <em>done</em> file exists. This option configures
what file name to use. Either you can specify a fixed name. Or you can use
dynamic placeholders. The <em>done</em> file is <b>always</b> expected in the
same folder as the original file. See <em>using done file</em> and <em>writing
done file</em> sections for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>exclusiveReadLockStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> Pluggable read-lock as a
<tt>org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy</tt>
implementation. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>maxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> An integer to define a maximum messages to gather per
poll. By default no maximum is set.
Can be used to set a limit of e.g. 1000 to avoid when starting up the server
that there are thousands of files. Set a value of 0 or negative to disabled it.
See more details at <a shape="rect" href="batch-consumer.html" title="Batch
Consumer">Batch Consumer</a>. <b>Notice:</b> If this option is in use then the
<a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> components will limit <b>before</b> any
sorting. For example if you have 100000 files and use
<tt>maxMessagesPerPoll=500</tt>, then only the first 500 files will be picked
up, and then sorted. You can use the <tt>eagerMaxMessagesPerPoll</tt> option
and set this to <tt>false</tt> to allow to scan all files first and then sort
afterwards. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerMaxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <
b>Camel 2.9.3:</b> Allows to control whether the limit from
<tt>maxMessagesPerPoll</tt> is eager or not. If eager then the limit is during
the scanning of files. Where as <tt>false</tt> would scan all files, and then
perform sorting. Setting this option to <tt>false</tt> allows to sort all files
first, and then limit the poll. Mind that this requires a higher memory usage
as all file details are in memory to perform the sorting. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>minDepth</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> 0 </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.8</b>: The minimum depth to start
processing when recursively processing a directory. Using <tt>minDepth=1</tt>
means the base directory. Using <tt>minDepth=2</tt> means the first sub
directory. This option is supported by <a shape="rect" href="ftp2.html"
title="FTP2">FTP</a> consumer from <b>Camel 2.8.2, 2.9</b> onwards.
</td></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"> <tt>maxDepth</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>Integer.MAX_VALUE</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.8:</b> The maximum
depth to traverse when recursively processing a directory. This option is
supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer
from <b>Camel 2.8.2, 2.9</b> onwards. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>processStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A pluggable
<tt>org.apache.camel.component.file.GenericFileProcessStrategy</tt> allowing
you to implement your own <tt>readLock</tt> option or similar. Can also be used
when special conditions must be met before a file can be consumed, such as a
special <em>ready</em> file exists. If this option is set then the
<tt>readLock</tt> option does not apply. </td></tr><t
r><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startingDirectoryMustExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.5:</b> Whether the starting directory must
exist. Mind that the <tt>autoCreate</tt> option is default enabled, which means
the starting directory is normally auto created if it doesn't exist. You can
disable <tt>autoCreate</tt> and enable this to ensure the starting directory
must exist. Will thrown an exception if the directory doesn't exist.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>pollStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.0:</b> A pluggable <tt>org.apache.camel.PollingConsumerPollStrategy</tt>
allowing you to provide your custom implementation to control error handling
usually occurred during the <tt>poll</tt> operat
ion <b>before</b> an <a shape="rect" href="exchange.html"
title="Exchange">Exchange</a> have been created and being routed in Camel. In
other words the error occurred while the polling was gathering information, for
instance access to a file network failed so Camel cannot access it to scan for
files. The default implementation will log the caused exception at
<tt>WARN</tt> level and ignore it. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling consumer did
not poll any files, you can enable this option to send an empty message (no
body) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>consumer.bridgeErrorHandler</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Cam
el 2.10:</b> Allows to bridge the consumer to the Camel routing <a
shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>,
which mean any exceptions occurred while trying to pickup files, or the likes,
will now be processed as a message and handled by the routing <a shape="rect"
href="error-handler.html" title="Error Handler">Error Handler</a>. By default
the consumer will use the <tt>org.apache.camel.spi.ExceptionHandler</tt> to
deal with exceptions, that by default will be logged at WARN/ERROR level and
ignored. See further below on this page fore more details, at section <em>How
to use the Camel error handler to deal with exceptions triggered outside the
routing engine</em>. </td></tr></tbody></table>
+</td><td colspan="1" rowspan="1" class="confluenceTd"> Optional timeout in
millis for the read-lock, if supported by the read-lock. If the read-lock could
not be granted and the timeout triggered, then Camel will skip the file. At
next poll Camel, will try the file again, and this time maybe the read-lock
could be granted. Use a value of 0 or lower to indicate forever. In <b>Camel
2.0</b> the default value is 0. In <b>Camel 2.1</b> the default value is 10000.
Currently <tt>fileLock</tt>, <tt>changed</tt> and <tt>rename</tt> support the
timeout. For <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockTimeout</tt> value is 20000. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>readLockCheckInterval</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>1000</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.6:</b> Interval in
millis for the read-lock, if supported by the read lock. This interval is used
for sleeping between attempts to acquire the read lock. For example when
using the <tt>changed</tt> read lock, you can set a higher interval period to
cater for <em>slow writes</em>. The default of 1 sec. may be <em>too fast</em>
if the producer is very slow writing the file. For <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockCheckInterval</tt> is <tt>5000</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>directoryMustExist</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.5:</b> Similar to
<tt>startingDirectoryMustExist</tt> but this applies during polling recursive
sub directories. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>doneFileName</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.6:</b> If provided, Camel will
only consume files if a <em>done</em> file exists. This option configures
what file name to use. Either you can specify a fixed name. Or you can use
dynamic placeholders. The <em>done</em> file is <b>always</b> expected in the
same folder as the original file. See <em>using done file</em> and <em>writing
done file</em> sections for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>exclusiveReadLockStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> Pluggable read-lock as a
<tt>org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy</tt>
implementation. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>maxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> An integer to define a maximum messages to gather per
poll. By default no maximum is set.
Can be used to set a limit of e.g. 1000 to avoid when starting up the server
that there are thousands of files. Set a value of 0 or negative to disabled it.
See more details at <a shape="rect" href="batch-consumer.html" title="Batch
Consumer">Batch Consumer</a>. <b>Notice:</b> If this option is in use then the
<a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> components will limit <b>before</b> any
sorting. For example if you have 100000 files and use
<tt>maxMessagesPerPoll=500</tt>, then only the first 500 files will be picked
up, and then sorted. You can use the <tt>eagerMaxMessagesPerPoll</tt> option
and set this to <tt>false</tt> to allow to scan all files first and then sort
afterwards. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerMaxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <
b>Camel 2.9.3:</b> Allows to control whether the limit from
<tt>maxMessagesPerPoll</tt> is eager or not. If eager then the limit is during
the scanning of files. Where as <tt>false</tt> would scan all files, and then
perform sorting. Setting this option to <tt>false</tt> allows to sort all files
first, and then limit the poll. Mind that this requires a higher memory usage
as all file details are in memory to perform the sorting. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>minDepth</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> 0 </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.8</b>: The minimum depth to start
processing when recursively processing a directory. Using <tt>minDepth=1</tt>
means the base directory. Using <tt>minDepth=2</tt> means the first sub
directory. This option is supported by <a shape="rect" href="ftp2.html"
title="FTP2">FTP</a> consumer from <b>Camel 2.8.2, 2.9</b> onwards.
</td></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"> <tt>maxDepth</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>Integer.MAX_VALUE</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.8:</b> The maximum
depth to traverse when recursively processing a directory. This option is
supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer
from <b>Camel 2.8.2, 2.9</b> onwards. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>processStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A pluggable
<tt>org.apache.camel.component.file.GenericFileProcessStrategy</tt> allowing
you to implement your own <tt>readLock</tt> option or similar. Can also be used
when special conditions must be met before a file can be consumed, such as a
special <em>ready</em> file exists. If this option is set then the
<tt>readLock</tt> option does not apply. </td></tr><t
r><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startingDirectoryMustExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.5:</b> Whether the starting directory must
exist. Mind that the <tt>autoCreate</tt> option is default enabled, which means
the starting directory is normally auto created if it doesn't exist. You can
disable <tt>autoCreate</tt> and enable this to ensure the starting directory
must exist. Will thrown an exception if the directory doesn't exist.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>pollStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.0:</b> A pluggable <tt>org.apache.camel.PollingConsumerPollStrategy</tt>
allowing you to provide your custom implementation to control error handling
usually occurred during the <tt>poll</tt> operat
ion <b>before</b> an <a shape="rect" href="exchange.html"
title="Exchange">Exchange</a> have been created and being routed in Camel. In
other words the error occurred while the polling was gathering information, for
instance access to a file network failed so Camel cannot access it to scan for
files. The default implementation will log the caused exception at
<tt>WARN</tt> level and ignore it. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling consumer did
not poll any files, you can enable this option to send an empty message (no
body) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>consumer.bridgeErrorHandler</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Cam
el 2.10:</b> Allows to bridge the consumer to the Camel routing <a
shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>,
which mean any exceptions occurred while trying to pickup files, or the likes,
will now be processed as a message and handled by the routing <a shape="rect"
href="error-handler.html" title="Error Handler">Error Handler</a>. By default
the consumer will use the <tt>org.apache.camel.spi.ExceptionHandler</tt> to
deal with exceptions, that by default will be logged at WARN/ERROR level and
ignored. See further below on this page fore more details, at section <em>How
to use the Camel error handler to deal with exceptions triggered outside the
routing engine</em>. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>scheduledExecutorService</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Allows to configure a
custom/shared t
hread pool to use for the consumer. By default each consumer has its own
single threaded thread pool. This option allows you to share a thread pool
among multiple file consumers. </td></tr></tbody></table>
</div>
</div>
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 Sun Jun 24 13:21:29
2012
@@ -19180,7 +19180,7 @@ from(<span class="code-quote">"activemq:
<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"> Default </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>pollStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"><ul class="alternate" type="square"><li></li></ul>
-</td><td colspan="1" rowspan="1" class="confluenceTd"> A pluggable
<tt>org.apache.camel.PollingConsumerPollStrategy</tt> allowing you to provide
your custom implementation to control error handling usually occurred during
the <tt>poll</tt> operation <b>before</b> an <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> have been created and being
routed in Camel. In other words the error occurred while the polling was
gathering information, for instance access to a file network failed so Camel
cannot access it to scan for files. The default implementation will log the
caused exception at <tt>WARN</tt> level and ignore it. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling
consumer did not poll any files, you can enable this option to send an empty
message (no b
ody) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startScheduler</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether
the scheduler should be auto started. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>initialDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Milliseconds before the first poll starts.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delay</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>500</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> Milliseconds before the next
poll. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>useFixedDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Controls if fixed delay o
r fixed rate is used. See <a shape="rect" class="external-link"
href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html";
rel="nofollow">ScheduledExecutorService</a> in JDK for details. In <b>Camel
2.7.x</b> or older the default value is <tt>false</tt>. From <b>Camel 2.8</b>
onwards the default value is <tt>true</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> timeUnit </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TimeUnit.MILLISECONDS</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> time unit for <tt>initialDelay</tt> and
<tt>delay</tt> options. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>runLoggingLevel</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TRACE</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.8:</b> The consumer logs a start/complete log
line when it polls. This option allows you to configure the logging level for th
at. </td></tr></tbody></table>
+</td><td colspan="1" rowspan="1" class="confluenceTd"> A pluggable
<tt>org.apache.camel.PollingConsumerPollStrategy</tt> allowing you to provide
your custom implementation to control error handling usually occurred during
the <tt>poll</tt> operation <b>before</b> an <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> have been created and being
routed in Camel. In other words the error occurred while the polling was
gathering information, for instance access to a file network failed so Camel
cannot access it to scan for files. The default implementation will log the
caused exception at <tt>WARN</tt> level and ignore it. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling
consumer did not poll any files, you can enable this option to send an empty
message (no b
ody) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startScheduler</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether
the scheduler should be auto started. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>initialDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Milliseconds before the first poll starts.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delay</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>500</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> Milliseconds before the next
poll. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>useFixedDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Controls if fixed delay o
r fixed rate is used. See <a shape="rect" class="external-link"
href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html";
rel="nofollow">ScheduledExecutorService</a> in JDK for details. In <b>Camel
2.7.x</b> or older the default value is <tt>false</tt>. From <b>Camel 2.8</b>
onwards the default value is <tt>true</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> timeUnit </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TimeUnit.MILLISECONDS</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> time unit for <tt>initialDelay</tt> and
<tt>delay</tt> options. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>runLoggingLevel</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TRACE</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.8:</b> The consumer logs a start/complete log
line when it polls. This option allows you to configure the logging level for th
at. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>scheduledExecutorService</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.10:</b> Allows to configure a custom/shared
thread pool to use for the consumer. By default each consumer has its own
single threaded thread pool. This option allows you to share a thread pool
among multiple consumers. </td></tr></tbody></table>
</div>
</div>
@@ -24105,7 +24105,7 @@ This option provides the build in strate
<br clear="none" class="atl-forced-newline"> <tt>rename</tt> is for using a
try to rename the file as a test if we can get exclusive read-lock.
<br clear="none" class="atl-forced-newline"> <tt>none</tt> is for no read
locks at all.<br clear="none">
Notice from <b>Camel 2.10</b> onwards the read locks <tt>changed</tt>,
<tt>fileLock</tt> and <tt>rename</tt> will also use a <tt>markerFile</tt> as
well, to ensure not picking up files that may be in process by another Camel
consumer running on another node (eg cluster). This is only supported by the
file component (not the ftp component). </td></tr><tr><td></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>readLockTimeout</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"><ul class="alternate"
type="square"><li></li></ul>
-</td><td colspan="1" rowspan="1" class="confluenceTd"> Optional timeout in
millis for the read-lock, if supported by the read-lock. If the read-lock could
not be granted and the timeout triggered, then Camel will skip the file. At
next poll Camel, will try the file again, and this time maybe the read-lock
could be granted. Use a value of 0 or lower to indicate forever. In <b>Camel
2.0</b> the default value is 0. In <b>Camel 2.1</b> the default value is 10000.
Currently <tt>fileLock</tt>, <tt>changed</tt> and <tt>rename</tt> support the
timeout. For <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockTimeout</tt> value is 20000. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>readLockCheckInterval</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>1000</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.6:</b> Interval in
millis for the read-lock, if supported by the read lock. This interval is used
for sleeping between attempts to acquire the read lock. For example when
using the <tt>changed</tt> read lock, you can set a higher interval period to
cater for <em>slow writes</em>. The default of 1 sec. may be <em>too fast</em>
if the producer is very slow writing the file. For <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockCheckInterval</tt> is <tt>5000</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>directoryMustExist</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.5:</b> Similar to
<tt>startingDirectoryMustExist</tt> but this applies during polling recursive
sub directories. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>doneFileName</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.6:</b> If provided, Camel will
only consume files if a <em>done</em> file exists. This option configures
what file name to use. Either you can specify a fixed name. Or you can use
dynamic placeholders. The <em>done</em> file is <b>always</b> expected in the
same folder as the original file. See <em>using done file</em> and <em>writing
done file</em> sections for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>exclusiveReadLockStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> Pluggable read-lock as a
<tt>org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy</tt>
implementation. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>maxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> An integer to define a maximum messages to gather per
poll. By default no maximum is set.
Can be used to set a limit of e.g. 1000 to avoid when starting up the server
that there are thousands of files. Set a value of 0 or negative to disabled it.
See more details at <a shape="rect" href="batch-consumer.html" title="Batch
Consumer">Batch Consumer</a>. <b>Notice:</b> If this option is in use then the
<a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> components will limit <b>before</b> any
sorting. For example if you have 100000 files and use
<tt>maxMessagesPerPoll=500</tt>, then only the first 500 files will be picked
up, and then sorted. You can use the <tt>eagerMaxMessagesPerPoll</tt> option
and set this to <tt>false</tt> to allow to scan all files first and then sort
afterwards. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerMaxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <
b>Camel 2.9.3:</b> Allows to control whether the limit from
<tt>maxMessagesPerPoll</tt> is eager or not. If eager then the limit is during
the scanning of files. Where as <tt>false</tt> would scan all files, and then
perform sorting. Setting this option to <tt>false</tt> allows to sort all files
first, and then limit the poll. Mind that this requires a higher memory usage
as all file details are in memory to perform the sorting. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>minDepth</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> 0 </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.8</b>: The minimum depth to start
processing when recursively processing a directory. Using <tt>minDepth=1</tt>
means the base directory. Using <tt>minDepth=2</tt> means the first sub
directory. This option is supported by <a shape="rect" href="ftp2.html"
title="FTP2">FTP</a> consumer from <b>Camel 2.8.2, 2.9</b> onwards.
</td></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"> <tt>maxDepth</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>Integer.MAX_VALUE</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.8:</b> The maximum
depth to traverse when recursively processing a directory. This option is
supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer
from <b>Camel 2.8.2, 2.9</b> onwards. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>processStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A pluggable
<tt>org.apache.camel.component.file.GenericFileProcessStrategy</tt> allowing
you to implement your own <tt>readLock</tt> option or similar. Can also be used
when special conditions must be met before a file can be consumed, such as a
special <em>ready</em> file exists. If this option is set then the
<tt>readLock</tt> option does not apply. </td></tr><t
r><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startingDirectoryMustExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.5:</b> Whether the starting directory must
exist. Mind that the <tt>autoCreate</tt> option is default enabled, which means
the starting directory is normally auto created if it doesn't exist. You can
disable <tt>autoCreate</tt> and enable this to ensure the starting directory
must exist. Will thrown an exception if the directory doesn't exist.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>pollStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.0:</b> A pluggable <tt>org.apache.camel.PollingConsumerPollStrategy</tt>
allowing you to provide your custom implementation to control error handling
usually occurred during the <tt>poll</tt> operat
ion <b>before</b> an <a shape="rect" href="exchange.html"
title="Exchange">Exchange</a> have been created and being routed in Camel. In
other words the error occurred while the polling was gathering information, for
instance access to a file network failed so Camel cannot access it to scan for
files. The default implementation will log the caused exception at
<tt>WARN</tt> level and ignore it. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling consumer did
not poll any files, you can enable this option to send an empty message (no
body) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>consumer.bridgeErrorHandler</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Cam
el 2.10:</b> Allows to bridge the consumer to the Camel routing <a
shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>,
which mean any exceptions occurred while trying to pickup files, or the likes,
will now be processed as a message and handled by the routing <a shape="rect"
href="error-handler.html" title="Error Handler">Error Handler</a>. By default
the consumer will use the <tt>org.apache.camel.spi.ExceptionHandler</tt> to
deal with exceptions, that by default will be logged at WARN/ERROR level and
ignored. See further below on this page fore more details, at section <em>How
to use the Camel error handler to deal with exceptions triggered outside the
routing engine</em>. </td></tr></tbody></table>
+</td><td colspan="1" rowspan="1" class="confluenceTd"> Optional timeout in
millis for the read-lock, if supported by the read-lock. If the read-lock could
not be granted and the timeout triggered, then Camel will skip the file. At
next poll Camel, will try the file again, and this time maybe the read-lock
could be granted. Use a value of 0 or lower to indicate forever. In <b>Camel
2.0</b> the default value is 0. In <b>Camel 2.1</b> the default value is 10000.
Currently <tt>fileLock</tt>, <tt>changed</tt> and <tt>rename</tt> support the
timeout. For <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockTimeout</tt> value is 20000. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>readLockCheckInterval</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>1000</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.6:</b> Interval in
millis for the read-lock, if supported by the read lock. This interval is used
for sleeping between attempts to acquire the read lock. For example when
using the <tt>changed</tt> read lock, you can set a higher interval period to
cater for <em>slow writes</em>. The default of 1 sec. may be <em>too fast</em>
if the producer is very slow writing the file. For <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> the default
<tt>readLockCheckInterval</tt> is <tt>5000</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>directoryMustExist</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.5:</b> Similar to
<tt>startingDirectoryMustExist</tt> but this applies during polling recursive
sub directories. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>doneFileName</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.6:</b> If provided, Camel will
only consume files if a <em>done</em> file exists. This option configures
what file name to use. Either you can specify a fixed name. Or you can use
dynamic placeholders. The <em>done</em> file is <b>always</b> expected in the
same folder as the original file. See <em>using done file</em> and <em>writing
done file</em> sections for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>exclusiveReadLockStrategy</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> Pluggable read-lock as a
<tt>org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy</tt>
implementation. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>maxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>0</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> An integer to define a maximum messages to gather per
poll. By default no maximum is set.
Can be used to set a limit of e.g. 1000 to avoid when starting up the server
that there are thousands of files. Set a value of 0 or negative to disabled it.
See more details at <a shape="rect" href="batch-consumer.html" title="Batch
Consumer">Batch Consumer</a>. <b>Notice:</b> If this option is in use then the
<a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> components will limit <b>before</b> any
sorting. For example if you have 100000 files and use
<tt>maxMessagesPerPoll=500</tt>, then only the first 500 files will be picked
up, and then sorted. You can use the <tt>eagerMaxMessagesPerPoll</tt> option
and set this to <tt>false</tt> to allow to scan all files first and then sort
afterwards. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerMaxMessagesPerPoll</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <
b>Camel 2.9.3:</b> Allows to control whether the limit from
<tt>maxMessagesPerPoll</tt> is eager or not. If eager then the limit is during
the scanning of files. Where as <tt>false</tt> would scan all files, and then
perform sorting. Setting this option to <tt>false</tt> allows to sort all files
first, and then limit the poll. Mind that this requires a higher memory usage
as all file details are in memory to perform the sorting. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>minDepth</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> 0 </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.8</b>: The minimum depth to start
processing when recursively processing a directory. Using <tt>minDepth=1</tt>
means the base directory. Using <tt>minDepth=2</tt> means the first sub
directory. This option is supported by <a shape="rect" href="ftp2.html"
title="FTP2">FTP</a> consumer from <b>Camel 2.8.2, 2.9</b> onwards.
</td></tr><tr><td colspan="
1" rowspan="1" class="confluenceTd"> <tt>maxDepth</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>Integer.MAX_VALUE</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.8:</b> The maximum
depth to traverse when recursively processing a directory. This option is
supported by <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumer
from <b>Camel 2.8.2, 2.9</b> onwards. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>processStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> A pluggable
<tt>org.apache.camel.component.file.GenericFileProcessStrategy</tt> allowing
you to implement your own <tt>readLock</tt> option or similar. Can also be used
when special conditions must be met before a file can be consumed, such as a
special <em>ready</em> file exists. If this option is set then the
<tt>readLock</tt> option does not apply. </td></tr><t
r><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startingDirectoryMustExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.5:</b> Whether the starting directory must
exist. Mind that the <tt>autoCreate</tt> option is default enabled, which means
the starting directory is normally auto created if it doesn't exist. You can
disable <tt>autoCreate</tt> and enable this to ensure the starting directory
must exist. Will thrown an exception if the directory doesn't exist.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>pollStrategy</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.0:</b> A pluggable <tt>org.apache.camel.PollingConsumerPollStrategy</tt>
allowing you to provide your custom implementation to control error handling
usually occurred during the <tt>poll</tt> operat
ion <b>before</b> an <a shape="rect" href="exchange.html"
title="Exchange">Exchange</a> have been created and being routed in Camel. In
other words the error occurred while the polling was gathering information, for
instance access to a file network failed so Camel cannot access it to scan for
files. The default implementation will log the caused exception at
<tt>WARN</tt> level and ignore it. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling consumer did
not poll any files, you can enable this option to send an empty message (no
body) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>consumer.bridgeErrorHandler</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Cam
el 2.10:</b> Allows to bridge the consumer to the Camel routing <a
shape="rect" href="error-handler.html" title="Error Handler">Error Handler</a>,
which mean any exceptions occurred while trying to pickup files, or the likes,
will now be processed as a message and handled by the routing <a shape="rect"
href="error-handler.html" title="Error Handler">Error Handler</a>. By default
the consumer will use the <tt>org.apache.camel.spi.ExceptionHandler</tt> to
deal with exceptions, that by default will be logged at WARN/ERROR level and
ignored. See further below on this page fore more details, at section <em>How
to use the Camel error handler to deal with exceptions triggered outside the
routing engine</em>. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>scheduledExecutorService</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.10:</b> Allows to configure a
custom/shared t
hread pool to use for the consumer. By default each consumer has its own
single threaded thread pool. This option allows you to share a thread pool
among multiple file consumers. </td></tr></tbody></table>
</div>
</div>
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 Sun Jun 24
13:21:29 2012
@@ -4955,7 +4955,7 @@ from(<span class="code-quote">"activemq:
<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"> Default </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>pollStrategy</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"><ul class="alternate" type="square"><li></li></ul>
-</td><td colspan="1" rowspan="1" class="confluenceTd"> A pluggable
<tt>org.apache.camel.PollingConsumerPollStrategy</tt> allowing you to provide
your custom implementation to control error handling usually occurred during
the <tt>poll</tt> operation <b>before</b> an <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> have been created and being
routed in Camel. In other words the error occurred while the polling was
gathering information, for instance access to a file network failed so Camel
cannot access it to scan for files. The default implementation will log the
caused exception at <tt>WARN</tt> level and ignore it. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling
consumer did not poll any files, you can enable this option to send an empty
message (no b
ody) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startScheduler</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether
the scheduler should be auto started. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>initialDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Milliseconds before the first poll starts.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delay</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>500</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> Milliseconds before the next
poll. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>useFixedDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Controls if fixed delay o
r fixed rate is used. See <a shape="rect" class="external-link"
href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html";
rel="nofollow">ScheduledExecutorService</a> in JDK for details. In <b>Camel
2.7.x</b> or older the default value is <tt>false</tt>. From <b>Camel 2.8</b>
onwards the default value is <tt>true</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> timeUnit </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TimeUnit.MILLISECONDS</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> time unit for <tt>initialDelay</tt> and
<tt>delay</tt> options. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>runLoggingLevel</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TRACE</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.8:</b> The consumer logs a start/complete log
line when it polls. This option allows you to configure the logging level for th
at. </td></tr></tbody></table>
+</td><td colspan="1" rowspan="1" class="confluenceTd"> A pluggable
<tt>org.apache.camel.PollingConsumerPollStrategy</tt> allowing you to provide
your custom implementation to control error handling usually occurred during
the <tt>poll</tt> operation <b>before</b> an <a shape="rect"
href="exchange.html" title="Exchange">Exchange</a> have been created and being
routed in Camel. In other words the error occurred while the polling was
gathering information, for instance access to a file network failed so Camel
cannot access it to scan for files. The default implementation will log the
caused exception at <tt>WARN</tt> level and ignore it. </td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>sendEmptyMessageWhenIdle</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>false</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.9:</b> If the polling
consumer did not poll any files, you can enable this option to send an empty
message (no b
ody) instead. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>startScheduler</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>true</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> Whether
the scheduler should be auto started. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>initialDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>1000</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Milliseconds before the first poll starts.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> <tt>delay</tt>
</td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>500</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> Milliseconds before the next
poll. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>useFixedDelay</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> </td><td colspan="1" rowspan="1"
class="confluenceTd"> Controls if fixed delay o
r fixed rate is used. See <a shape="rect" class="external-link"
href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/concurrent/ScheduledExecutorService.html";
rel="nofollow">ScheduledExecutorService</a> in JDK for details. In <b>Camel
2.7.x</b> or older the default value is <tt>false</tt>. From <b>Camel 2.8</b>
onwards the default value is <tt>true</tt>. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"> timeUnit </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TimeUnit.MILLISECONDS</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> time unit for <tt>initialDelay</tt> and
<tt>delay</tt> options. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>runLoggingLevel</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>TRACE</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.8:</b> The consumer logs a start/complete log
line when it polls. This option allows you to configure the logging level for th
at. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>scheduledExecutorService</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.10:</b> Allows to configure a custom/shared
thread pool to use for the consumer. By default each consumer has its own
single threaded thread pool. This option allows you to share a thread pool
among multiple consumers. </td></tr></tbody></table>
</div>
</div>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
