Author: buildbot
Date: Mon Apr 7 07:19:25 2014
New Revision: 905304
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/file2.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/file2.html
==============================================================================
--- websites/production/camel/content/file2.html (original)
+++ websites/production/camel/content/file2.html Mon Apr 7 07:19:25 2014
@@ -109,7 +109,7 @@
<h3 id="File2-URIOptions">URI Options</h3><h4
id="File2-Common">Common</h4><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> Default Value </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>autoCreate</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Automatically create missing
directories in the file's pathname. For the file consumer, that means creating
the starting directory. For the file producer, it means the directory the files
should be written to. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>bufferSize</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> 128kb </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> Write buffer sized in bytes. </p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p> <code>fileName</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Use <a shape="rect" href="expression.html"
title="Expression">Expression</a> such as <a shape="rect"
href="file-language.html" title="File Language">File Language</a> to
dynamically set the filename. For consumers, it's used as a filename filter.
For producers, it's used to evaluate the filename to write. If an expression is
set, it take precedence over the <code>CamelFileName</code> header.
(<strong>Note:</strong> The header itself can also be an <a shape="rect"
href="expression.html" title="Expression">Expression</a>). The expression
options support both <code>String</code> and <code>Expression</code> types. If
the expression is a <code>String</code> type, it is <strong>always</strong>
evaluated using the <a shape="rect" href="file-language.html" title="File
Language">File Language</a>. If the e
xpression is an <code>Expression</code> type, the specified
<code>Expression</code> type is used - this allows you, for instance, to use <a
shape="rect" href="ognl.html" title="OGNL">OGNL</a> expressions. For the
consumer, you can use it to filter filenames, so you can for instance consume
today's file using the <a shape="rect" href="file-language.html" title="File
Language">File Language</a> syntax:
<code>mydata-${date:now:yyyyMMdd}.txt</code>. From <strong>Camel 2.11</strong>
onwards the producers support the <code>CamelOverruleFileName</code> header
which takes precedence over any existing <code>CamelFileName</code> header; the
<code>CamelOverruleFileName</code> is a header that is used only once, and
makes it easier as this avoids to temporary store <code>CamelFileName</code>
and have to restore it afterwards. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>flatten</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code
> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Flatten is
> used to flatten the file name path to strip any leading paths, so it's just
> the file name. This allows you to consume recursively into sub-directories,
> but when you eg write the files to another directory they will be written in
> a single directory. Setting this to <code>true</code> on the producer
> enforces that any file name recived in <code>CamelFileName</code> header
> will be stripped for any leading paths. </p></td></tr><tr><td colspan="1"
> rowspan="1" class="confluenceTd"><p> <code>charset</code> </p></td><td
> colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code>
> </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel
> 2.9.3:</strong> this option is used to specify the encoding of the file, and
> camel will set the Exchange property with <code>Exchange.CHARSET_NAME</code>
> with the value of this option. You can use this on the consumer, to specify
> the encodings of the files, whic
h allow Camel to know the charset it should load the file content in case the
file content is being accessed. Likewise when writing a file, you can use this
option to specify which charset to write the file as well. See further below
for a examples and more important details. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>copyAndDeleteOnRenameFail</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel
2.9</strong>: whether to fallback and do a copy and delete file, in case the
file could not be renamed directly. This option is not available for the <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> component.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>renameUsingCopy</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd">
<p> <strong>Camel 2.13.1</strong>: Perform rename operations using a copy and
delete strategy. This is primarily used in environments where the regular
rename operation is unreliable (e.g. across different file systems or
networks). This option takes precedence over the
<code>copyAndDeleteOnRenameFail</code> parameter that will automatically fall
back to the copy and delete strategy, but only after additional
delays.</p></td></tr></tbody></table>
</div><h4 id="File2-Consumer">Consumer</h4><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> Default Value </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>initialDelay</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Milliseconds before polling
the file/directory starts. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>delay</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>500</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Milliseconds before the next poll of the
file/directory. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>useFixedDelay</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> 
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Controls if
fixed delay or 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
<strong>Camel 2.7.x</strong> or older the default value is <code>false</code>.
From <strong>Camel 2.8</strong> onwards the default value is <code>true</code>.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>runLoggingLevel</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>TRACE</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.8:</strong> The consumer
logs a start/complete log line when it polls. This option allows you to
configure the logging level for that. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>recursive</code> </p></td><td
colspan="1" rowspan="
1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> If a directory, will look for files in all
the sub-directories as well. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>delete</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> If <code>true</code>, the file
will be deleted <strong>after</strong> it is processed </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>noop</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> If
<code>true</code>, the file is not moved or deleted in any way. This option is
good for readonly data, or for <a shape="rect" href="etl.html"
title="ETL">ETL</a> type requirements. If <code>noop=true</code>, Camel will
set <code>idempotent=true</code> as well,
to avoid consuming the same files over and over again. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>preMove</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect"
href="expression.html" title="Expression">Expression</a> (such as <a
shape="rect" href="file-language.html" title="File Language">File Language</a>)
used to dynamically set the filename when moving it <strong>before</strong>
processing. For example to move in-progress files into the <code>order</code>
directory set this value to <code>order</code>. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>move</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>.camel</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect"
href="expression.html" title="Expression">Expression</a> (such as <a
shape="rect" href="file
-language.html" title="File Language">File Language</a>) used to dynamically
set the filename when moving it <strong>after</strong> processing. To move
files into a <code>.done</code> subdirectory just enter <code>.done</code>.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>moveFailed</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <a shape="rect" href="expression.html"
title="Expression">Expression</a> (such as <a shape="rect"
href="file-language.html" title="File Language">File Language</a>) used to
dynamically set a different target directory when moving files after processing
(configured via <code>move</code> defined above) failed. For example, to move
files into a <code>.error</code> subdirectory use: <code>.error</code>. Note:
When moving the files to the “fail” location Camel will
<strong>handle</strong> the error and will not pick up
the file again. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>include</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Is used to include files, if filename
matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>exclude</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Is used to exclude files, if filename
matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>antInclude</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10:</strong> Ant style
filter inclusion, for example
<code>antInclude=*</code><code><strong>/</strong></code><code>.txt</code>. Mu
ltiple inclusions may be specified in comma-delimited format. See <a
shape="rect" href="#File2-FilteringusingANTpathmatcher">below</a> for more
details about ant path filters. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>antExclude</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10:</strong> Ant style
filter exclusion. If both <code>antInclude</code> and <code>antExclude</code>
are used, <code>antExclude</code> takes precedence over
<code>antInclude</code>. Multiple exclusions may be specified in
comma-delimited format. See <a shape="rect"
href="#File2-FilteringusingANTpathmatcher">below</a> for more details about ant
path filters. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>antFilterCaseSensitive</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></td><td
colspan=
"1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.11:</strong> Ant
style filter which is case sensitive or not. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>idempotent</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Option to use the
<a shape="rect" href="idempotent-consumer.html" title="Idempotent
Consumer">Idempotent Consumer</a> EIP pattern to let Camel skip already
processed files. Will by default use a memory based LRUCache that holds 1000
entries. If <code>noop=true</code> then idempotent will be enabled as well to
avoid consuming the same files over and over again. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>idempotentKey</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>Expression</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <strong>Camel 2.11:</strong> To
use a custom idempotent key. By default the absolute path of the file is
used. You can use the <a shape="rect" href="file-language.html" title="File
Language">File Language</a>, for example to use the file name and file size,
you can do: </p>
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p> Name </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Default Value </p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p> Description </p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>initialDelay</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>1000</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> Milliseconds before polling
the file/directory starts. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>delay</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>500</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Milliseconds before the next poll of the
file/directory. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>useFixedDelay</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> 
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Controls if
fixed delay or 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
<strong>Camel 2.7.x</strong> or older the default value is <code>false</code>.
From <strong>Camel 2.8</strong> onwards the default value is <code>true</code>.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>runLoggingLevel</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>TRACE</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.8:</strong> The consumer
logs a start/complete log line when it polls. This option allows you to
configure the logging level for that. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>recursive</code> </p></td><td
colspan="1" rowspan="
1" class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> If a directory, will look for files in all
the sub-directories as well. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>delete</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>false</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> If <code>true</code>, the file
will be deleted <strong>after</strong> it is processed </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>noop</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>false</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> If
<code>true</code>, the file is not moved or deleted in any way. This option is
good for readonly data, or for <a shape="rect" href="etl.html"
title="ETL">ETL</a> type requirements. If <code>noop=true</code>, Camel will
set <code>idempotent=true</code> as well,
to avoid consuming the same files over and over again. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>preMove</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect"
href="expression.html" title="Expression">Expression</a> (such as <a
shape="rect" href="file-language.html" title="File Language">File Language</a>)
used to dynamically set the filename when moving it <strong>before</strong>
processing. For example to move in-progress files into the <code>order</code>
directory set this value to <code>order</code>. </p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>move</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>.camel</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <a shape="rect"
href="expression.html" title="Expression">Expression</a> (such as <a
shape="rect" href="file
-language.html" title="File Language">File Language</a>) used to dynamically
set the filename when moving it <strong>after</strong> processing. To move
files into a <code>.done</code> subdirectory just enter <code>.done</code>.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>moveFailed</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <a shape="rect" href="expression.html"
title="Expression">Expression</a> (such as <a shape="rect"
href="file-language.html" title="File Language">File Language</a>) used to
dynamically set a different target directory when moving files <em>in case
of</em> processing (configured via <code>move</code> defined above) failed. For
example, to move files into a <code>.error</code> subdirectory use:
<code>.error</code>. Note: When moving the files to the “fail”
location Camel will <strong>handle</strong> the error and wil
l not pick up the file again. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>include</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Is used to include files, if filename
matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>exclude</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Is used to exclude files, if filename
matches the regex pattern. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>antInclude</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10:</strong> Ant style
filter inclusion, for example
<code>antInclude=*</code><code><strong>/</strong></code><code>.
txt</code>. Multiple inclusions may be specified in comma-delimited format.
See <a shape="rect" href="#File2-FilteringusingANTpathmatcher">below</a> for
more details about ant path filters. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>antExclude</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>null</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.10:</strong>
Ant style filter exclusion. If both <code>antInclude</code> and
<code>antExclude</code> are used, <code>antExclude</code> takes precedence over
<code>antInclude</code>. Multiple exclusions may be specified in
comma-delimited format. See <a shape="rect"
href="#File2-FilteringusingANTpathmatcher">below</a> for more details about ant
path filters. </p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>antFilterCaseSensitive</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>true</code> </p></t
d><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel
2.11:</strong> Ant style filter which is case sensitive or not.
</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>
<code>idempotent</code> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p> <code>false</code> </p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> Option to use the <a shape="rect"
href="idempotent-consumer.html" title="Idempotent Consumer">Idempotent
Consumer</a> EIP pattern to let Camel skip already processed files. Will by
default use a memory based LRUCache that holds 1000 entries. If
<code>noop=true</code> then idempotent will be enabled as well to avoid
consuming the same files over and over again. </p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p> <code>idempotentKey</code> </p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p> <code>Expression</code>
</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> <strong>Camel 2.1
1:</strong> To use a custom idempotent key. By default the absolute path of
the file is used. You can use the <a shape="rect" href="file-language.html"
title="File Language">File Language</a>, for example to use the file name and
file size, you can do: </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[idempotentKey=${file:name}-${file:size}]]></script>
</div></div>
