Author: buildbot
Date: Wed Aug 22 15:20:37 2012
New Revision: 829711
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/cache/main.pageCache
websites/production/camel/content/camel-2110-release.html
websites/production/camel/content/file2.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 Wed Aug 22
15:20:37 2012
@@ -3655,7 +3655,7 @@ Notice from <b>Camel 2.10</b> onwards th
<h4><a shape="rect" name="BookComponentAppendix-Producer"></a>Producer</h4>
<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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b> and <b>Ignore</b>. <tt>Override</tt>, which is the default,
replaces the existing file. <tt>Append</tt> adds content to the existing file.
<tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>, indicating that
there is already an existing file. <tt>Ignore</tt> silently ignores the problem
and <b>does not</b> override the existing file, but assumes everything is okay.
</td></tr><tr><td colspan="1
" rowspan="1" class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> This option is used to write the file using a
temporary name and then, after the write is complete, rename it to the real
name. Can be used to identify files being written and also avoid consumers (not
using exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>tempFileName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.1:</b> The <b>same</b> as <tt>tempPrefix</tt> option but offering a more fine
grained control on the naming of the temporary filename as it uses the <a
shape="rect" href="file-language.html" title="File Language">File Language</a>.
</
td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled it will set this
timestamp on the written file. <b>Note:</b> This option only applies to the
<b>file</b> producer. You <em>cannot</em> use this option with any of the ftp
producers. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerDeleteTargetFile</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly delete any
existi
ng target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. </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, then Camel will write a
2nd <em>done</em> file when the original file has been written. The
<em>done</em> file will be empty. 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> fi
le will <b>always</b> be written in the same folder as the original file. See
<em>writing done file</em> section for examples. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><tt>allowNullBody</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.10.1:</b> Used to specify if a null body is
allowed during file writing. If set to true then an empty file will be created,
when set to false, and attempting to send a null body to the file component, a
GenericFileWriteException of 'Cannot write null body to file.' will be thrown.
If the `fileExist` option is set to 'Override', then the file will be
truncated, and if set to `append` the file will remain unchanged.
</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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b>, <b>Ignore</b>, and <tt><b>Move</b></tt>. <tt>Override</tt>, which
is the default, replaces the existing file. <tt>Append</tt> adds content to the
existing file. <tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>,
indicating that there is already an existing file. <tt>Ignore</tt> silently
ignores the problem and <b>does not</b> override the existing file, but assumes
everything is okay. The <
tt>Move</tt> option requires Camel 2.11 onwards, and the corresponding
<tt>moveExisting</tt> option to be configured as well. The option
<tt>eagerDeleteTargetFile</tt> can be used to control what to do if an moving
the file, and there exists already an existing file, otherwise causing the move
operation to fail. The <tt>Move</tt> option will move any existing files,
before writing the target file. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> This option is used to write the file using a temporary
name and then, after the write is complete, rename it to the real name. Can be
used to identify files being written and also avoid consumers (not using
exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan=
"1" rowspan="1" class="confluenceTd"> <tt>tempFileName</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.1:</b> The <b>same</b>
as <tt>tempPrefix</tt> option but offering a more fine grained control on the
naming of the temporary filename as it uses the <a shape="rect"
href="file-language.html" title="File Language">File Language</a>.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>moveExisting</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.11:</b> <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
compute file name to use when <tt>fileExist=Move</tt> is configured. To move
files into a <tt>backup</tt> subdirectory just enter <tt>backup</tt>. This
option o
nly supports the following <a shape="rect" href="file-language.html"
title="File Language">File Language</a> tokens: "file:name", "file:name.ext",
"file:name.noext", "file:onlyname", "file:onlyname.noext", "file:ext", and
"file:parent". Notice the "file:parent" is not supported by the <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> component, as the FTP component can only
move any existing files to a relative directory based on current dir as base.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled i
t will set this timestamp on the written file. <b>Note:</b> This option only
applies to the <b>file</b> producer. You <em>cannot</em> use this option with
any of the ftp producers. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>eagerDeleteTargetFile</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly
delete any existing target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. From <b>Camel 2.11</b> onwards this
option is
also used to control whether to delete any existing files when
<tt>fileExist=Move</tt> is enabled, and an existing file exists. If this option
is false, then an exception will be thrown if an existing file existed, if its
true, then the existing file is deleted before the move operation.
</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, then Camel will write a 2nd <em>done</em> file when the
original file has been written. The <em>done</em> file will be empty. 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 will <b>always</b>
be written in the same folder as the original file. See <em>writing done
file</em> section for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><tt
>allowNullBody</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
>false </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
>2.10.1:</b> Used to specify if a null body is allowed during file writing. If
>set to true then an empty file will be created, when set to false, and
>attempting to send a null body to the file component, a
>GenericFileWriteException of 'Cannot write null body to file.' will be
>thrown. If the `fileExist` option is set to 'Override', then the file will be
>truncated, and if set to `append` the file will remain unchanged.
></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 Wed Aug 22 15:20:37
2012
@@ -4177,12 +4177,16 @@ dfm.registerDestinationFactory(CamelTran
http://camel.apache.org/schema/cxf
http://camel.apache.org/schema/cxf/cxfEndpoint.xsd
http://camel.apache.org/schema/spring
http://camel.apache.org/schema/spring/camel-spring.xsd
">
+
+ <!-- Enable bridge between Camel Property Placeholder and Spring
Property placeholder so we can use system properties
+ to dynamically set the port number for unit testing the example. -->
+ <span class="code-tag"><bean id=<span
class="code-quote">"bridgePropertyPlaceholder"</span> class=<span
class="code-quote">"org.apache.camel.spring.spi.BridgePropertyPlaceholderConfigurer"</span>/></span>
<span class="code-tag"><bean id = <span
class="code-quote">"roundRobinRef"</span> class=<span
class="code-quote">"org.apache.camel.processor.loadbalancer.RoundRobinLoadBalancer"</span>
/></span>
<span class="code-tag"><camelContext id=<span
class="code-quote">"dest_context"</span> xmlns=<span
class="code-quote">"http://camel.apache.org/schema/spring";</span>></span>
<span class="code-tag"><route></span>
- <span class="code-tag"><from uri=<span
class="code-quote">"jetty:http://localhost:9091/GreeterContext/GreeterPort";</span>/></span>
+ <span class="code-tag"><from uri=<span
class="code-quote">"jetty:http://localhost:{{port}}/GreeterContext/GreeterPort";</span>/></span>
<span class="code-tag"><loadBalance ref=<span
class="code-quote">"roundRobinRef"</span>></span>
<span class="code-tag"><to uri=<span
class="code-quote">"direct:EndpointA"</span>/></span>
<span class="code-tag"><to uri=<span
class="code-quote">"direct:EndpointB"</span>/></span>
@@ -24248,7 +24252,7 @@ Notice from <b>Camel 2.10</b> onwards th
<h4><a shape="rect" name="BookInOnePage-Producer"></a>Producer</h4>
<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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b> and <b>Ignore</b>. <tt>Override</tt>, which is the default,
replaces the existing file. <tt>Append</tt> adds content to the existing file.
<tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>, indicating that
there is already an existing file. <tt>Ignore</tt> silently ignores the problem
and <b>does not</b> override the existing file, but assumes everything is okay.
</td></tr><tr><td colspan="1
" rowspan="1" class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> This option is used to write the file using a
temporary name and then, after the write is complete, rename it to the real
name. Can be used to identify files being written and also avoid consumers (not
using exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>tempFileName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.1:</b> The <b>same</b> as <tt>tempPrefix</tt> option but offering a more fine
grained control on the naming of the temporary filename as it uses the <a
shape="rect" href="file-language.html" title="File Language">File Language</a>.
</
td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled it will set this
timestamp on the written file. <b>Note:</b> This option only applies to the
<b>file</b> producer. You <em>cannot</em> use this option with any of the ftp
producers. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerDeleteTargetFile</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly delete any
existi
ng target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. </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, then Camel will write a
2nd <em>done</em> file when the original file has been written. The
<em>done</em> file will be empty. 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> fi
le will <b>always</b> be written in the same folder as the original file. See
<em>writing done file</em> section for examples. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><tt>allowNullBody</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.10.1:</b> Used to specify if a null body is
allowed during file writing. If set to true then an empty file will be created,
when set to false, and attempting to send a null body to the file component, a
GenericFileWriteException of 'Cannot write null body to file.' will be thrown.
If the `fileExist` option is set to 'Override', then the file will be
truncated, and if set to `append` the file will remain unchanged.
</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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b>, <b>Ignore</b>, and <tt><b>Move</b></tt>. <tt>Override</tt>, which
is the default, replaces the existing file. <tt>Append</tt> adds content to the
existing file. <tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>,
indicating that there is already an existing file. <tt>Ignore</tt> silently
ignores the problem and <b>does not</b> override the existing file, but assumes
everything is okay. The <
tt>Move</tt> option requires Camel 2.11 onwards, and the corresponding
<tt>moveExisting</tt> option to be configured as well. The option
<tt>eagerDeleteTargetFile</tt> can be used to control what to do if an moving
the file, and there exists already an existing file, otherwise causing the move
operation to fail. The <tt>Move</tt> option will move any existing files,
before writing the target file. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> This option is used to write the file using a temporary
name and then, after the write is complete, rename it to the real name. Can be
used to identify files being written and also avoid consumers (not using
exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan=
"1" rowspan="1" class="confluenceTd"> <tt>tempFileName</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.1:</b> The <b>same</b>
as <tt>tempPrefix</tt> option but offering a more fine grained control on the
naming of the temporary filename as it uses the <a shape="rect"
href="file-language.html" title="File Language">File Language</a>.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>moveExisting</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.11:</b> <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
compute file name to use when <tt>fileExist=Move</tt> is configured. To move
files into a <tt>backup</tt> subdirectory just enter <tt>backup</tt>. This
option o
nly supports the following <a shape="rect" href="file-language.html"
title="File Language">File Language</a> tokens: "file:name", "file:name.ext",
"file:name.noext", "file:onlyname", "file:onlyname.noext", "file:ext", and
"file:parent". Notice the "file:parent" is not supported by the <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> component, as the FTP component can only
move any existing files to a relative directory based on current dir as base.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled i
t will set this timestamp on the written file. <b>Note:</b> This option only
applies to the <b>file</b> producer. You <em>cannot</em> use this option with
any of the ftp producers. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>eagerDeleteTargetFile</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly
delete any existing target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. From <b>Camel 2.11</b> onwards this
option is
also used to control whether to delete any existing files when
<tt>fileExist=Move</tt> is enabled, and an existing file exists. If this option
is false, then an exception will be thrown if an existing file existed, if its
true, then the existing file is deleted before the move operation.
</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, then Camel will write a 2nd <em>done</em> file when the
original file has been written. The <em>done</em> file will be empty. 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 will <b>always</b>
be written in the same folder as the original file. See <em>writing done
file</em> section for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><tt
>allowNullBody</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
>false </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
>2.10.1:</b> Used to specify if a null body is allowed during file writing. If
>set to true then an empty file will be created, when set to false, and
>attempting to send a null body to the file component, a
>GenericFileWriteException of 'Cannot write null body to file.' will be
>thrown. If the `fileExist` option is set to 'Override', then the file will be
>truncated, and if set to `append` the file will remain unchanged.
></td></tr></tbody></table>
</div>
</div>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-2110-release.html
==============================================================================
--- websites/production/camel/content/camel-2110-release.html (original)
+++ websites/production/camel/content/camel-2110-release.html Wed Aug 22
15:20:37 2012
@@ -84,7 +84,7 @@
<p>Welcome to the 2.11.0 release with approximately XXX issues resolved -
including new features, improvements, and bug fixes, such as: </p>
-<ul><li>Added support for SOAP 1.2 in <a shape="rect" href="soap.html"
title="SOAP">SOAP</a> data format.</li><li><a shape="rect" href="cache.html"
title="Cache">Cache</a> operation for add/update now supports expiry headers to
control time to live/idle/eternal.</li><li>Added <tt>allowNullBody</tt> option
to <a shape="rect" href="jms.html" title="JMS">JMS</a> to configure whether
sending messages with no body is allowed.</li><li>Added
<tt>connectOnStartup</tt> option to <a shape="rect" href="hdfs.html"
title="HDFS">HDFS</a> to allow to connect on demand, to avoid having Hadoop
block for long time connecting to the HDFS cluster, as it has a hardcoded 15
minute retry mechanism.</li><li>Added support for daily and weekly trends to <a
shape="rect" href="twitter.html" title="Twitter">Twitter</a>
component.</li><li>The <a shape="rect" href="camel-maven-archetypes.html"
title="Camel Maven Archetypes">Camel Maven Archetypes</a> now generates
projects without any license headers.</li
><li>Added 'rejectOld' option to the <a shape="rect" href="resequencer.html"
>title="Resequencer">Resequencer</a> to prevent out of order messages from
>being delivered after capacity/timeout events occur</li><li>Further optimized
><a shape="rect" href="xpath.html" title="XPath">XPath</a> under concurrent
>load, and as well ensured resources are cleaned up eagerly</li><li>Added
>options <tt>allowNullBody</tt> and <tt>readLockMinLength</tt> to the <a
>shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
>href="ftp2.html" title="FTP2">FTP</a> components.</li><li>Made
><tt>changed</tt> read lock strategy on <a shape="rect" href="ftp2.html"
>title="FTP2">FTP</a> go faster (eg when the FTP server has a lot of files in
>the directory) if you enable the <tt>fastExistsCheck=true</tt> option as
>well. Notice that some FTP server may not support this.</li><li><a
>shape="rect" href="hl7.html" title="HL7">HL7</a> moves the HAPI 2.0 and
>supports Parser instance into unmarshal an
d "Terser" language and expression to be able to extract fields from a parsed
message. <a shape="rect" href="hl7.html" title="HL7">HL7</a> also upgraded to
now use Apache Mina 2.x.</li><li>Add an option <tt>HttpMethodRestrict</tt> to
restrict HTTP method in <a shape="rect" href="jetty.html"
title="Jetty">Jetty</a> and <a shape="rect" href="servlet.html"
title="SERVLET">SERVLET</a></li><li>Add support for selection of <a
shape="rect" href="direct-vm.html" title="Direct-VM">Direct-VM</a> consumers by
using ant-like path expression.</li><li>The <a shape="rect"
href="pojo-producing.html" title="POJO Producing">POJO Producing</a>, and <a
shape="rect" href="pojo-consuming.html" title="POJO Consuming">POJO
Consuming</a> with @Consume, @Produce, @EndpointInject now supports a new
{{property} attribute to get the endpoint configuration from a bean property
(eg using a getter method); this allows you to configure this on the bean using
conventional bean configuration.</li><li>Testing
with <tt>camel-test-blueprint</tt> on Windows no longer tries to cleanup after
testing taking up 5 seconds and logging WARNs.</li></ul>
+<ul><li>Added support for SOAP 1.2 in <a shape="rect" href="soap.html"
title="SOAP">SOAP</a> data format.</li><li><a shape="rect" href="cache.html"
title="Cache">Cache</a> operation for add/update now supports expiry headers to
control time to live/idle/eternal.</li><li>Added <tt>allowNullBody</tt> option
to <a shape="rect" href="jms.html" title="JMS">JMS</a> to configure whether
sending messages with no body is allowed.</li><li>Added
<tt>connectOnStartup</tt> option to <a shape="rect" href="hdfs.html"
title="HDFS">HDFS</a> to allow to connect on demand, to avoid having Hadoop
block for long time connecting to the HDFS cluster, as it has a hardcoded 15
minute retry mechanism.</li><li>Added support for daily and weekly trends to <a
shape="rect" href="twitter.html" title="Twitter">Twitter</a>
component.</li><li>The <a shape="rect" href="camel-maven-archetypes.html"
title="Camel Maven Archetypes">Camel Maven Archetypes</a> now generates
projects without any license headers.</li
><li>Added 'rejectOld' option to the <a shape="rect" href="resequencer.html"
>title="Resequencer">Resequencer</a> to prevent out of order messages from
>being delivered after capacity/timeout events occur</li><li>Further optimized
><a shape="rect" href="xpath.html" title="XPath">XPath</a> under concurrent
>load, and as well ensured resources are cleaned up eagerly</li><li>Added
>options <tt>allowNullBody</tt> and <tt>readLockMinLength</tt> to the <a
>shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect"
>href="ftp2.html" title="FTP2">FTP</a> components.</li><li>Made
><tt>changed</tt> read lock strategy on <a shape="rect" href="ftp2.html"
>title="FTP2">FTP</a> go faster (eg when the FTP server has a lot of files in
>the directory) if you enable the <tt>fastExistsCheck=true</tt> option as
>well. Notice that some FTP server may not support this.</li><li><a
>shape="rect" href="hl7.html" title="HL7">HL7</a> moves the HAPI 2.0 and
>supports Parser instance into unmarshal an
d "Terser" language and expression to be able to extract fields from a parsed
message. <a shape="rect" href="hl7.html" title="HL7">HL7</a> also upgraded to
now use Apache Mina 2.x.</li><li>Add an option <tt>HttpMethodRestrict</tt> to
restrict HTTP method in <a shape="rect" href="jetty.html"
title="Jetty">Jetty</a> and <a shape="rect" href="servlet.html"
title="SERVLET">SERVLET</a></li><li>Add support for selection of <a
shape="rect" href="direct-vm.html" title="Direct-VM">Direct-VM</a> consumers by
using ant-like path expression.</li><li>The <a shape="rect"
href="pojo-producing.html" title="POJO Producing">POJO Producing</a>, and <a
shape="rect" href="pojo-consuming.html" title="POJO Consuming">POJO
Consuming</a> with @Consume, @Produce, @EndpointInject now supports a new
{{property} attribute to get the endpoint configuration from a bean property
(eg using a getter method); this allows you to configure this on the bean using
conventional bean configuration.</li><li>Testing
with <tt>camel-test-blueprint</tt> on Windows no longer tries to cleanup after
testing taking up 5 seconds and logging WARNs.</li><li>The <a shape="rect"
href="file2.html" title="File2">File</a>, and <a shape="rect" href="ftp2.html"
title="FTP2">FTP</a> components now support <tt>fileExist=Move</tt> option to
move any existing files before writing a file.</li></ul>
<h3><a shape="rect" name="Camel2.11.0Release-Fixedissues"></a>Fixed issues</h3>
@@ -121,7 +121,7 @@
<h2><a shape="rect"
name="Camel2.11.0Release-Internal%2FNonAPIrefactoringsthatmayaffectusers"></a>Internal/Non
API refactorings that may affect users</h2>
-<ul><li>The <a shape="rect" href="testing.html" title="Testing">Camel Test
Kit</a> provides a default <a shape="rect" href="properties.html"
title="Properties">Properties</a> component out of the box; which mean using
<tt>addComponent("properties", ...)</tt> is no longer needed; instead get the
component using <tt>getComponent("properties")</tt> and configure the component
instead.</li></ul>
+<ul><li>The <a shape="rect" href="testing.html" title="Testing">Camel Test
Kit</a> provides a default <a shape="rect" href="properties.html"
title="Properties">Properties</a> component out of the box; which mean using
<tt>addComponent("properties", ...)</tt> is no longer needed; instead get the
component using <tt>getComponent("properties")</tt> and configure the component
instead.</li><li>Added abstract method <tt>createGenericFile</tt> to
<tt>org.apache.camel.component.file.GenericFileEndpoint</tt></li></ul>
<h2><a shape="rect" name="Camel2.11.0Release-KnownIssues"></a>Known Issues</h2>
Modified: websites/production/camel/content/file2.html
==============================================================================
--- websites/production/camel/content/file2.html (original)
+++ websites/production/camel/content/file2.html Wed Aug 22 15:20:37 2012
@@ -127,7 +127,7 @@ Notice from <b>Camel 2.10</b> onwards th
<h4><a shape="rect" name="File2-Producer"></a>Producer</h4>
<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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b> and <b>Ignore</b>. <tt>Override</tt>, which is the default,
replaces the existing file. <tt>Append</tt> adds content to the existing file.
<tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>, indicating that
there is already an existing file. <tt>Ignore</tt> silently ignores the problem
and <b>does not</b> override the existing file, but assumes everything is okay.
</td></tr><tr><td colspan="1
" rowspan="1" class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> This option is used to write the file using a
temporary name and then, after the write is complete, rename it to the real
name. Can be used to identify files being written and also avoid consumers (not
using exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>tempFileName</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.1:</b> The <b>same</b> as <tt>tempPrefix</tt> option but offering a more fine
grained control on the naming of the temporary filename as it uses the <a
shape="rect" href="file-language.html" title="File Language">File Language</a>.
</
td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled it will set this
timestamp on the written file. <b>Note:</b> This option only applies to the
<b>file</b> producer. You <em>cannot</em> use this option with any of the ftp
producers. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>eagerDeleteTargetFile</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>true</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly delete any
existi
ng target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. </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, then Camel will write a
2nd <em>done</em> file when the original file has been written. The
<em>done</em> file will be empty. 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> fi
le will <b>always</b> be written in the same folder as the original file. See
<em>writing done file</em> section for examples. </td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><tt>allowNullBody</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.10.1:</b> Used to specify if a null body is
allowed during file writing. If set to true then an empty file will be created,
when set to false, and attempting to send a null body to the file component, a
GenericFileWriteException of 'Cannot write null body to file.' will be thrown.
If the `fileExist` option is set to 'Override', then the file will be
truncated, and if set to `append` the file will remain unchanged.
</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>fileExist</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>Override</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> What to do if a file already exists with the same name.
The following values can be specified: <b>Override</b>, <b>Append</b>,
<b>Fail</b>, <b>Ignore</b>, and <tt><b>Move</b></tt>. <tt>Override</tt>, which
is the default, replaces the existing file. <tt>Append</tt> adds content to the
existing file. <tt>Fail</tt> throws a <tt>GenericFileOperationException</tt>,
indicating that there is already an existing file. <tt>Ignore</tt> silently
ignores the problem and <b>does not</b> override the existing file, but assumes
everything is okay. The <
tt>Move</tt> option requires Camel 2.11 onwards, and the corresponding
<tt>moveExisting</tt> option to be configured as well. The option
<tt>eagerDeleteTargetFile</tt> can be used to control what to do if an moving
the file, and there exists already an existing file, otherwise causing the move
operation to fail. The <tt>Move</tt> option will move any existing files,
before writing the target file. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>tempPrefix</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>null</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> This option is used to write the file using a temporary
name and then, after the write is complete, rename it to the real name. Can be
used to identify files being written and also avoid consumers (not using
exclusive read locks) reading in progress files. Is often used by <a
shape="rect" href="ftp2.html" title="FTP2">FTP</a> when uploading big files.
</td></tr><tr><td colspan=
"1" rowspan="1" class="confluenceTd"> <tt>tempFileName</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <tt>null</tt> </td><td
colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.1:</b> The <b>same</b>
as <tt>tempPrefix</tt> option but offering a more fine grained control on the
naming of the temporary filename as it uses the <a shape="rect"
href="file-language.html" title="File Language">File Language</a>.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>moveExisting</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
<tt>null</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
2.11:</b> <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
compute file name to use when <tt>fileExist=Move</tt> is configured. To move
files into a <tt>backup</tt> subdirectory just enter <tt>backup</tt>. This
option o
nly supports the following <a shape="rect" href="file-language.html"
title="File Language">File Language</a> tokens: "file:name", "file:name.ext",
"file:name.noext", "file:onlyname", "file:onlyname.noext", "file:ext", and
"file:parent". Notice the "file:parent" is not supported by the <a shape="rect"
href="ftp2.html" title="FTP2">FTP</a> component, as the FTP component can only
move any existing files to a relative directory based on current dir as base.
</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">
<tt>keepLastModified</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>false</tt> </td><td colspan="1" rowspan="1"
class="confluenceTd"> <b>Camel 2.2:</b> Will keep the last modified timestamp
from the source file (if any). Will use the
<tt>Exchange.FILE_LAST_MODIFIED</tt> header to located the timestamp. This
header can contain either a <tt>java.util.Date</tt> or <tt>long</tt> with the
timestamp. If the timestamp exists and the option is enabled i
t will set this timestamp on the written file. <b>Note:</b> This option only
applies to the <b>file</b> producer. You <em>cannot</em> use this option with
any of the ftp producers. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>eagerDeleteTargetFile</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <tt>true</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> Whether or not to eagerly
delete any existing target file. This option only applies when you use
<tt>fileExists=Override</tt> and the <tt>tempFileName</tt> option as well. You
can use this to disable (set it to false) deleting the target file before the
temp file is written. For example you may write big files and want the target
file to exists during the temp file is being written. This ensure the target
file is only deleted until the very last moment, just before the temp file is
being renamed to the target filename. From <b>Camel 2.11</b> onwards this
option is
also used to control whether to delete any existing files when
<tt>fileExist=Move</tt> is enabled, and an existing file exists. If this option
is false, then an exception will be thrown if an existing file existed, if its
true, then the existing file is deleted before the move operation.
</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, then Camel will write a 2nd <em>done</em> file when the
original file has been written. The <em>done</em> file will be empty. 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 will <b>always</b>
be written in the same folder as the original file. See <em>writing done
file</em> section for examples. </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><tt
>allowNullBody</tt> </td><td colspan="1" rowspan="1" class="confluenceTd">
>false </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel
>2.10.1:</b> Used to specify if a null body is allowed during file writing. If
>set to true then an empty file will be created, when set to false, and
>attempting to send a null body to the file component, a
>GenericFileWriteException of 'Cannot write null body to file.' will be
>thrown. If the `fileExist` option is set to 'Override', then the file will be
>truncated, and if set to `append` the file will remain unchanged.
></td></tr></tbody></table>
</div>
</div>
