Author: buildbot
Date: Wed Apr 24 10:20:13 2013
New Revision: 859714
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/ftp.html
websites/production/camel/content/ftp2.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 Apr 24
10:20:13 2013
@@ -4910,7 +4910,8 @@ ${body}
<p>Maven users will need to add the following dependency to their
<tt>pom.xml</tt> for this component:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"><span class="code-tag"><dependency></span>
+<pre class="code-xml">
+<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.camel<span
class="code-tag"></groupId></span>
<span class="code-tag"><artifactId></span>camel-ftp<span
class="code-tag"></artifactId></span>
<span class="code-tag"><version></span>x.x.x<span
class="code-tag"></version></span>
@@ -4926,7 +4927,8 @@ ${body}
<h3><a shape="rect" name="BookComponentAppendix-URIformat"></a>URI format</h3>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
+<pre class="code-java">
+ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>sftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>ftps:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]</span>
</pre>
@@ -4969,13 +4971,15 @@ FTPS (also known as FTP Secure) is an ex
<p>For example to set the <tt>setDataTimeout</tt> on the <tt>FTPClient</tt> to
30 seconds you can do:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
<p>You can mix and match and have use both prefixes, for example to configure
date format or timezones.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -4988,7 +4992,8 @@ And as well for <a shape="rect" class="e
<p>For example:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java"> <bean id=<span
class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
+<pre class="code-java">
+ <bean id=<span class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
<property name=<span class="code-quote">"lenientFutureDates"</span>
value=<span class="code-quote">"<span
class="code-keyword">true</span>"</span>/>
<property name=<span class="code-quote">"serverLanguageCode"</span>
value=<span class="code-quote">"fr"</span>/>
</bean>
@@ -4997,7 +5002,8 @@ And as well for <a shape="rect" class="e
<p>And then let Camel lookup this bean when you use the # notation in the
url.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -5041,6 +5047,12 @@ There are other solutions to avoid consu
</div>
</div>
+<p>In addition the FTP/FTPS consumer and producer will enrich the Camel
<tt>Message</tt> with the following headers</p>
+<div class="confluenceTableSmall"><div class="table-wrap">
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Header </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyCode</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
code (the type is a integer) </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyString</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
string </td></tr></tbody></table>
+</div>
+</div>
+
<h3><a shape="rect" name="BookComponentAppendix-Abouttimeouts"></a>About
timeouts</h3>
<p>The two set of libraries (see top) has different API for setting timeout.
You can use the <tt>connectTimeout</tt> option for both of them to set a
timeout in millis to establish a network connection. An individual
<tt>soTimeout</tt> can also be set on the FTP/FTPS, which corresponds to using
<tt>ftpClient.soTimeout</tt>. Notice SFTP will automatically use
<tt>connectTimeout</tt> as its <tt>soTimeout</tt>. The <tt>timeout</tt> option
only applies for FTP/FTSP as the data timeout, which corresponds to the
<tt>ftpClient.dataTimeout</tt> value. All timeout values are in millis.</p>
@@ -5054,7 +5066,8 @@ There are other solutions to avoid consu
<p>So if you want to download files from a remote FTP server and store it as
files then you need to route to a file endpoint such as:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
</pre>
</div></div>
@@ -5078,7 +5091,8 @@ There are other solutions to avoid consu
<p>The difference between the two of them is best illustrated with an example.
Suppose we have the following directory structure on the remote FTP server we
need to traverse and download files:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">/
+<pre class="code-java">
+/
/one
/one/two
/one/two/sub-a
@@ -5090,7 +5104,8 @@ There are other solutions to avoid consu
<h4><a shape="rect"
name="BookComponentAppendix-Usingstepwise%3Dtrue%28defaultmode%29"></a>Using
stepwise=true (default mode)</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">TYPE A
+<pre class="code-java">
+TYPE A
200 Type set to A
PWD
257 <span class="code-quote">"/"</span> is current directory.
@@ -5178,7 +5193,8 @@ disconnected.
<h4><a shape="rect"
name="BookComponentAppendix-Usingstepwise%3Dfalse"></a>Using stepwise=false</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">230 Logged on
+<pre class="code-java">
+230 Logged on
TYPE A
200 Type set to A
SYST
@@ -5248,7 +5264,8 @@ disconnected.
<p>And the route using Spring DSL:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><route></span>
+<pre class="code-xml">
+ <span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span
class="code-quote">"ftp://scott@localhost/public/reports?password=tiger&amp;binary=true&amp;delay=60000";</span>/></span>
<span class="code-tag"><to uri=<span
class="code-quote">"file://target/test-reports"</span>/></span>
<span class="code-tag"></route></span>
@@ -5257,7 +5274,8 @@ disconnected.
<h4><a shape="rect"
name="BookComponentAppendix-ConsumingaremoteFTPSserver%28implicitSSL%29andclientauthentication"></a>Consuming
a remote FTPS server (implicit SSL) and client authentication</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from("ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
+<pre class="code-java">
+from("ftps:<span class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
</span> &ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to(<span class="code-quote">"bean:foo"</span>);
@@ -5266,7 +5284,8 @@ disconnected.
<h4><a shape="rect"
name="BookComponentAppendix-ConsumingaremoteFTPSserver%28explicitTLS%29andacustomtruststoreconfiguration"></a>Consuming
a remote FTPS server (explicit TLS) and a custom trust store configuration</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
+<pre class="code-java">
+from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
</span> .to(<span class="code-quote">"bean:foo"</span>);
</pre>
</div></div>
@@ -5289,7 +5308,8 @@ disconnected.
<p>And then we can configure our route using the <b>filter</b> attribute to
reference our filter (using <tt>#</tt> notation) that we have defined in the
spring XML file:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><span
class="code-comment"><!-- define our sorter as a plain spring bean
--></span></span>
+<pre class="code-xml">
+ <span class="code-tag"><span class="code-comment"><!-- define our sorter
as a plain spring bean --></span></span>
<span class="code-tag"><bean id=<span
class="code-quote">"myFilter"</span> class=<span
class="code-quote">"com.mycompany.MyFileFilter"</span>/></span>
<span class="code-tag"><route></span>
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 Apr 24 10:20:13
2013
@@ -25894,7 +25894,8 @@ ${body}
<p>Maven users will need to add the following dependency to their
<tt>pom.xml</tt> for this component:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"><span class="code-tag"><dependency></span>
+<pre class="code-xml">
+<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.camel<span
class="code-tag"></groupId></span>
<span class="code-tag"><artifactId></span>camel-ftp<span
class="code-tag"></artifactId></span>
<span class="code-tag"><version></span>x.x.x<span
class="code-tag"></version></span>
@@ -25910,7 +25911,8 @@ ${body}
<h3><a shape="rect" name="BookInOnePage-URIformat"></a>URI format</h3>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
+<pre class="code-java">
+ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>sftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>ftps:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]</span>
</pre>
@@ -25953,13 +25955,15 @@ FTPS (also known as FTP Secure) is an ex
<p>For example to set the <tt>setDataTimeout</tt> on the <tt>FTPClient</tt> to
30 seconds you can do:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
<p>You can mix and match and have use both prefixes, for example to configure
date format or timezones.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -25972,7 +25976,8 @@ And as well for <a shape="rect" class="e
<p>For example:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java"> <bean id=<span
class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
+<pre class="code-java">
+ <bean id=<span class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
<property name=<span class="code-quote">"lenientFutureDates"</span>
value=<span class="code-quote">"<span
class="code-keyword">true</span>"</span>/>
<property name=<span class="code-quote">"serverLanguageCode"</span>
value=<span class="code-quote">"fr"</span>/>
</bean>
@@ -25981,7 +25986,8 @@ And as well for <a shape="rect" class="e
<p>And then let Camel lookup this bean when you use the # notation in the
url.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -26025,6 +26031,12 @@ There are other solutions to avoid consu
</div>
</div>
+<p>In addition the FTP/FTPS consumer and producer will enrich the Camel
<tt>Message</tt> with the following headers</p>
+<div class="confluenceTableSmall"><div class="table-wrap">
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Header </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyCode</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
code (the type is a integer) </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyString</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
string </td></tr></tbody></table>
+</div>
+</div>
+
<h3><a shape="rect" name="BookInOnePage-Abouttimeouts"></a>About timeouts</h3>
<p>The two set of libraries (see top) has different API for setting timeout.
You can use the <tt>connectTimeout</tt> option for both of them to set a
timeout in millis to establish a network connection. An individual
<tt>soTimeout</tt> can also be set on the FTP/FTPS, which corresponds to using
<tt>ftpClient.soTimeout</tt>. Notice SFTP will automatically use
<tt>connectTimeout</tt> as its <tt>soTimeout</tt>. The <tt>timeout</tt> option
only applies for FTP/FTSP as the data timeout, which corresponds to the
<tt>ftpClient.dataTimeout</tt> value. All timeout values are in millis.</p>
@@ -26038,7 +26050,8 @@ There are other solutions to avoid consu
<p>So if you want to download files from a remote FTP server and store it as
files then you need to route to a file endpoint such as:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
</pre>
</div></div>
@@ -26062,7 +26075,8 @@ There are other solutions to avoid consu
<p>The difference between the two of them is best illustrated with an example.
Suppose we have the following directory structure on the remote FTP server we
need to traverse and download files:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">/
+<pre class="code-java">
+/
/one
/one/two
/one/two/sub-a
@@ -26074,7 +26088,8 @@ There are other solutions to avoid consu
<h4><a shape="rect"
name="BookInOnePage-Usingstepwise%3Dtrue%28defaultmode%29"></a>Using
stepwise=true (default mode)</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">TYPE A
+<pre class="code-java">
+TYPE A
200 Type set to A
PWD
257 <span class="code-quote">"/"</span> is current directory.
@@ -26162,7 +26177,8 @@ disconnected.
<h4><a shape="rect" name="BookInOnePage-Usingstepwise%3Dfalse"></a>Using
stepwise=false</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">230 Logged on
+<pre class="code-java">
+230 Logged on
TYPE A
200 Type set to A
SYST
@@ -26232,7 +26248,8 @@ disconnected.
<p>And the route using Spring DSL:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><route></span>
+<pre class="code-xml">
+ <span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span
class="code-quote">"ftp://scott@localhost/public/reports?password=tiger&amp;binary=true&amp;delay=60000";</span>/></span>
<span class="code-tag"><to uri=<span
class="code-quote">"file://target/test-reports"</span>/></span>
<span class="code-tag"></route></span>
@@ -26241,7 +26258,8 @@ disconnected.
<h4><a shape="rect"
name="BookInOnePage-ConsumingaremoteFTPSserver%28implicitSSL%29andclientauthentication"></a>Consuming
a remote FTPS server (implicit SSL) and client authentication</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from("ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
+<pre class="code-java">
+from("ftps:<span class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
</span> &ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to(<span class="code-quote">"bean:foo"</span>);
@@ -26250,7 +26268,8 @@ disconnected.
<h4><a shape="rect"
name="BookInOnePage-ConsumingaremoteFTPSserver%28explicitTLS%29andacustomtruststoreconfiguration"></a>Consuming
a remote FTPS server (explicit TLS) and a custom trust store configuration</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
+<pre class="code-java">
+from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
</span> .to(<span class="code-quote">"bean:foo"</span>);
</pre>
</div></div>
@@ -26273,7 +26292,8 @@ disconnected.
<p>And then we can configure our route using the <b>filter</b> attribute to
reference our filter (using <tt>#</tt> notation) that we have defined in the
spring XML file:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><span
class="code-comment"><!-- define our sorter as a plain spring bean
--></span></span>
+<pre class="code-xml">
+ <span class="code-tag"><span class="code-comment"><!-- define our sorter
as a plain spring bean --></span></span>
<span class="code-tag"><bean id=<span
class="code-quote">"myFilter"</span> class=<span
class="code-quote">"com.mycompany.MyFileFilter"</span>/></span>
<span class="code-tag"><route></span>
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/ftp.html
==============================================================================
--- websites/production/camel/content/ftp.html (original)
+++ websites/production/camel/content/ftp.html Wed Apr 24 10:20:13 2013
@@ -81,7 +81,8 @@
<p>Maven users will need to add the following dependency to their
<tt>pom.xml</tt> for this component:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"><span class="code-tag"><dependency></span>
+<pre class="code-xml">
+<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.camel<span
class="code-tag"></groupId></span>
<span class="code-tag"><artifactId></span>camel-ftp<span
class="code-tag"></artifactId></span>
<span class="code-tag"><version></span>x.x.x<span
class="code-tag"></version></span>
@@ -97,7 +98,8 @@
<h3><a shape="rect" name="FTP-URIformat"></a>URI format</h3>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
+<pre class="code-java">
+ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>sftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>ftps:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]</span>
</pre>
@@ -140,13 +142,15 @@ FTPS (also known as FTP Secure) is an ex
<p>For example to set the <tt>setDataTimeout</tt> on the <tt>FTPClient</tt> to
30 seconds you can do:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
<p>You can mix and match and have use both prefixes, for example to configure
date format or timezones.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -159,7 +163,8 @@ And as well for <a shape="rect" class="e
<p>For example:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java"> <bean id=<span
class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
+<pre class="code-java">
+ <bean id=<span class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
<property name=<span class="code-quote">"lenientFutureDates"</span>
value=<span class="code-quote">"<span
class="code-keyword">true</span>"</span>/>
<property name=<span class="code-quote">"serverLanguageCode"</span>
value=<span class="code-quote">"fr"</span>/>
</bean>
@@ -168,7 +173,8 @@ And as well for <a shape="rect" class="e
<p>And then let Camel lookup this bean when you use the # notation in the
url.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -212,6 +218,12 @@ There are other solutions to avoid consu
</div>
</div>
+<p>In addition the FTP/FTPS consumer and producer will enrich the Camel
<tt>Message</tt> with the following headers</p>
+<div class="confluenceTableSmall"><div class="table-wrap">
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Header </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyCode</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
code (the type is a integer) </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyString</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
string </td></tr></tbody></table>
+</div>
+</div>
+
<h3><a shape="rect" name="FTP-Abouttimeouts"></a>About timeouts</h3>
<p>The two set of libraries (see top) has different API for setting timeout.
You can use the <tt>connectTimeout</tt> option for both of them to set a
timeout in millis to establish a network connection. An individual
<tt>soTimeout</tt> can also be set on the FTP/FTPS, which corresponds to using
<tt>ftpClient.soTimeout</tt>. Notice SFTP will automatically use
<tt>connectTimeout</tt> as its <tt>soTimeout</tt>. The <tt>timeout</tt> option
only applies for FTP/FTSP as the data timeout, which corresponds to the
<tt>ftpClient.dataTimeout</tt> value. All timeout values are in millis.</p>
@@ -225,7 +237,8 @@ There are other solutions to avoid consu
<p>So if you want to download files from a remote FTP server and store it as
files then you need to route to a file endpoint such as:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
</pre>
</div></div>
@@ -249,7 +262,8 @@ There are other solutions to avoid consu
<p>The difference between the two of them is best illustrated with an example.
Suppose we have the following directory structure on the remote FTP server we
need to traverse and download files:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">/
+<pre class="code-java">
+/
/one
/one/two
/one/two/sub-a
@@ -261,7 +275,8 @@ There are other solutions to avoid consu
<h4><a shape="rect" name="FTP-Usingstepwise%3Dtrue%28defaultmode%29"></a>Using
stepwise=true (default mode)</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">TYPE A
+<pre class="code-java">
+TYPE A
200 Type set to A
PWD
257 <span class="code-quote">"/"</span> is current directory.
@@ -349,7 +364,8 @@ disconnected.
<h4><a shape="rect" name="FTP-Usingstepwise%3Dfalse"></a>Using
stepwise=false</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">230 Logged on
+<pre class="code-java">
+230 Logged on
TYPE A
200 Type set to A
SYST
@@ -419,7 +435,8 @@ disconnected.
<p>And the route using Spring DSL:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><route></span>
+<pre class="code-xml">
+ <span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span
class="code-quote">"ftp://scott@localhost/public/reports?password=tiger&amp;binary=true&amp;delay=60000";</span>/></span>
<span class="code-tag"><to uri=<span
class="code-quote">"file://target/test-reports"</span>/></span>
<span class="code-tag"></route></span>
@@ -428,7 +445,8 @@ disconnected.
<h4><a shape="rect"
name="FTP-ConsumingaremoteFTPSserver%28implicitSSL%29andclientauthentication"></a>Consuming
a remote FTPS server (implicit SSL) and client authentication</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from("ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
+<pre class="code-java">
+from("ftps:<span class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
</span> &ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to(<span class="code-quote">"bean:foo"</span>);
@@ -437,7 +455,8 @@ disconnected.
<h4><a shape="rect"
name="FTP-ConsumingaremoteFTPSserver%28explicitTLS%29andacustomtruststoreconfiguration"></a>Consuming
a remote FTPS server (explicit TLS) and a custom trust store configuration</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
+<pre class="code-java">
+from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
</span> .to(<span class="code-quote">"bean:foo"</span>);
</pre>
</div></div>
@@ -460,7 +479,8 @@ disconnected.
<p>And then we can configure our route using the <b>filter</b> attribute to
reference our filter (using <tt>#</tt> notation) that we have defined in the
spring XML file:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><span
class="code-comment"><!-- define our sorter as a plain spring bean
--></span></span>
+<pre class="code-xml">
+ <span class="code-tag"><span class="code-comment"><!-- define our sorter
as a plain spring bean --></span></span>
<span class="code-tag"><bean id=<span
class="code-quote">"myFilter"</span> class=<span
class="code-quote">"com.mycompany.MyFileFilter"</span>/></span>
<span class="code-tag"><route></span>
Modified: websites/production/camel/content/ftp2.html
==============================================================================
--- websites/production/camel/content/ftp2.html (original)
+++ websites/production/camel/content/ftp2.html Wed Apr 24 10:20:13 2013
@@ -81,7 +81,8 @@
<p>Maven users will need to add the following dependency to their
<tt>pom.xml</tt> for this component:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"><span class="code-tag"><dependency></span>
+<pre class="code-xml">
+<span class="code-tag"><dependency></span>
<span class="code-tag"><groupId></span>org.apache.camel<span
class="code-tag"></groupId></span>
<span class="code-tag"><artifactId></span>camel-ftp<span
class="code-tag"></artifactId></span>
<span class="code-tag"><version></span>x.x.x<span
class="code-tag"></version></span>
@@ -97,7 +98,8 @@
<h3><a shape="rect" name="FTP2-URIformat"></a>URI format</h3>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
+<pre class="code-java">
+ftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>sftp:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]
</span>ftps:<span
class="code-comment">//[username@]hostname[:port]/directoryname[?options]</span>
</pre>
@@ -140,13 +142,15 @@ FTPS (also known as FTP Secure) is an ex
<p>For example to set the <tt>setDataTimeout</tt> on the <tt>FTPClient</tt> to
30 seconds you can do:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
<p>You can mix and match and have use both prefixes, for example to configure
date format or timezones.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -159,7 +163,8 @@ And as well for <a shape="rect" class="e
<p>For example:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java"> <bean id=<span
class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
+<pre class="code-java">
+ <bean id=<span class="code-quote">"myConfig"</span> class=<span
class="code-quote">"org.apache.commons.net.ftp.FTPClientConfig"</span>>
<property name=<span class="code-quote">"lenientFutureDates"</span>
value=<span class="code-quote">"<span
class="code-keyword">true</span>"</span>/>
<property name=<span class="code-quote">"serverLanguageCode"</span>
value=<span class="code-quote">"fr"</span>/>
</bean>
@@ -168,7 +173,8 @@ And as well for <a shape="rect" class="e
<p>And then let Camel lookup this bean when you use the # notation in the
url.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//foo@myserver?password=secret&ftpClientConfig=#myConfig"</span>).to(<span
class="code-quote">"bean:foo"</span>);</span>
</pre>
</div></div>
@@ -212,6 +218,12 @@ There are other solutions to avoid consu
</div>
</div>
+<p>In addition the FTP/FTPS consumer and producer will enrich the Camel
<tt>Message</tt> with the following headers</p>
+<div class="confluenceTableSmall"><div class="table-wrap">
+<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"> Header </th><th colspan="1" rowspan="1"
class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyCode</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
code (the type is a integer) </td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"> <tt>CamelFtpReplyString</tt> </td><td colspan="1"
rowspan="1" class="confluenceTd"> <b>Camel 2.11.1:</b> The FTP client reply
string </td></tr></tbody></table>
+</div>
+</div>
+
<h3><a shape="rect" name="FTP2-Abouttimeouts"></a>About timeouts</h3>
<p>The two set of libraries (see top) has different API for setting timeout.
You can use the <tt>connectTimeout</tt> option for both of them to set a
timeout in millis to establish a network connection. An individual
<tt>soTimeout</tt> can also be set on the FTP/FTPS, which corresponds to using
<tt>ftpClient.soTimeout</tt>. Notice SFTP will automatically use
<tt>connectTimeout</tt> as its <tt>soTimeout</tt>. The <tt>timeout</tt> option
only applies for FTP/FTSP as the data timeout, which corresponds to the
<tt>ftpClient.dataTimeout</tt> value. All timeout values are in millis.</p>
@@ -225,7 +237,8 @@ There are other solutions to avoid consu
<p>So if you want to download files from a remote FTP server and store it as
files then you need to route to a file endpoint such as:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
+<pre class="code-java">
+from(<span class="code-quote">"ftp:<span
class="code-comment">//[email protected]?password=secret&localWorkDirectory=/tmp"</span>).to(<span
class="code-quote">"file://inbox"</span>);</span>
</pre>
</div></div>
@@ -249,7 +262,8 @@ There are other solutions to avoid consu
<p>The difference between the two of them is best illustrated with an example.
Suppose we have the following directory structure on the remote FTP server we
need to traverse and download files:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">/
+<pre class="code-java">
+/
/one
/one/two
/one/two/sub-a
@@ -261,7 +275,8 @@ There are other solutions to avoid consu
<h4><a shape="rect"
name="FTP2-Usingstepwise%3Dtrue%28defaultmode%29"></a>Using stepwise=true
(default mode)</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">TYPE A
+<pre class="code-java">
+TYPE A
200 Type set to A
PWD
257 <span class="code-quote">"/"</span> is current directory.
@@ -349,7 +364,8 @@ disconnected.
<h4><a shape="rect" name="FTP2-Usingstepwise%3Dfalse"></a>Using
stepwise=false</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">230 Logged on
+<pre class="code-java">
+230 Logged on
TYPE A
200 Type set to A
SYST
@@ -419,7 +435,8 @@ disconnected.
<p>And the route using Spring DSL:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><route></span>
+<pre class="code-xml">
+ <span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span
class="code-quote">"ftp://scott@localhost/public/reports?password=tiger&amp;binary=true&amp;delay=60000";</span>/></span>
<span class="code-tag"><to uri=<span
class="code-quote">"file://target/test-reports"</span>/></span>
<span class="code-tag"></route></span>
@@ -428,7 +445,8 @@ disconnected.
<h4><a shape="rect"
name="FTP2-ConsumingaremoteFTPSserver%28implicitSSL%29andclientauthentication"></a>Consuming
a remote FTPS server (implicit SSL) and client authentication</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from("ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
+<pre class="code-java">
+from("ftps:<span class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&securityProtocol=SSL&isImplicit=<span
class="code-keyword">true</span>
</span> &ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to(<span class="code-quote">"bean:foo"</span>);
@@ -437,7 +455,8 @@ disconnected.
<h4><a shape="rect"
name="FTP2-ConsumingaremoteFTPSserver%28explicitTLS%29andacustomtruststoreconfiguration"></a>Consuming
a remote FTPS server (explicit TLS) and a custom trust store configuration</h4>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-java">from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
+<pre class="code-java">
+from(<span class="code-quote">"ftps:<span
class="code-comment">//admin@localhost:2222/<span
class="code-keyword">public</span>/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password"</span>)
</span> .to(<span class="code-quote">"bean:foo"</span>);
</pre>
</div></div>
@@ -460,7 +479,8 @@ disconnected.
<p>And then we can configure our route using the <b>filter</b> attribute to
reference our filter (using <tt>#</tt> notation) that we have defined in the
spring XML file:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
-<pre class="code-xml"> <span class="code-tag"><span
class="code-comment"><!-- define our sorter as a plain spring bean
--></span></span>
+<pre class="code-xml">
+ <span class="code-tag"><span class="code-comment"><!-- define our sorter
as a plain spring bean --></span></span>
<span class="code-tag"><bean id=<span
class="code-quote">"myFilter"</span> class=<span
class="code-quote">"com.mycompany.MyFileFilter"</span>/></span>
<span class="code-tag"><route></span>
