camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From davscl...@apache.org
Subject [4/5] camel git commit: updated docs
Date Tue, 02 Aug 2016 08:48:05 GMT
updated docs


Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/8ba133ec
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/8ba133ec
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/8ba133ec

Branch: refs/heads/master
Commit: 8ba133ecbcfebcf1c4b0e729bfe8fa101048a012
Parents: d36d015
Author: Claus Ibsen <davsclaus@apache.org>
Authored: Tue Aug 2 10:35:25 2016 +0200
Committer: Claus Ibsen <davsclaus@apache.org>
Committed: Tue Aug 2 10:47:53 2016 +0200

----------------------------------------------------------------------
 components/camel-ftp/src/main/docs/ftp.adoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/camel/blob/8ba133ec/components/camel-ftp/src/main/docs/ftp.adoc
----------------------------------------------------------------------
diff --git a/components/camel-ftp/src/main/docs/ftp.adoc b/components/camel-ftp/src/main/docs/ftp.adoc
index 4afc4e6..c34451a 100644
--- a/components/camel-ftp/src/main/docs/ftp.adoc
+++ b/components/camel-ftp/src/main/docs/ftp.adoc
@@ -115,6 +115,7 @@ The FTP component has no options.
 
 
 
+
 // endpoint options: START
 The FTP component supports 103 endpoint options which are listed below:
 
@@ -129,6 +130,7 @@ The FTP component supports 103 endpoint options which are listed below:
 | charset | common |  | String | This option is used to specify the encoding of the file.
You can use this on the consumer to specify the encodings of the files which 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.
 | disconnect | common | false | boolean | Whether or not to disconnect from remote FTP server
right after use. Disconnect will only disconnect the current connection to the FTP server.
If you have a consumer which you want to stop then you need to stop the consumer/route instead.
 | disconnectOnBatchComplete | common | false | boolean | Whether or not to disconnect from
remote FTP server right after a Batch is complete. disconnectOnBatchComplete will only disconnect
the current connection to the FTP server. If you have a consumer which you want to stop then
you need to stop the consumer/route instead.
+| doneFileName | common |  | String | If provided then Camel will write a 2nd done file when
the original file has been written. The done 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 done file will always be written in the same folder as the original file. Only $file.name
and $file.name.noext is supported as dynamic placeholders.
 | download | common | false | boolean | Whether the FTP consumer should download the file.
If this option is set to false then the message body will be null but the consumer will still
trigger a Camel Exchange that has details about the file such as file name file size etc.
It's just that the file will not be downloaded.
 | fastExistsCheck | common | false | boolean | If set this option to be true camel-ftp will
use the list file directly to check if the file exists. Since some FTP server may not support
to list the file directly if the option is false camel-ftp will use the old way to list the
directory and check if the file exists. This option also influences readLock=changed to control
whether it performs a fast check to update file information or not. This can be used to speed
up the process if the FTP server has a lot of files.
 | fileName | common |  | String | Use Expression such as File Language 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 CamelFileName header.
(Note: The header itself can also be an Expression). The expression options support both String
and Expression types. If the expression is a String type it is always evaluated using the
File Language. If the expression is an Expression type the specified Expression type is used
- this allows you for instance to use OGNL expressions. For the consumer you can use it to
filter filenames so you can for instance consume today's file using the File Language syntax:
mydata-$date:now:yyyyMMdd.txt. The producers support the CamelOverruleFileName header which
takes precedence over any existing CamelFileName header; the CamelOverruleFileName is a header
that is used only once and makes it easier as this avoids to te
 mporary store CamelFileName and have to restore it afterwards.
@@ -155,7 +157,6 @@ The FTP component supports 103 endpoint options which are listed below:
 | receiveBufferSize | consumer (advanced) | 32768 | int | The receive (download) buffer size
Used only by FTPClient
 | startingDirectoryMustExist | consumer (advanced) | false | boolean | Whether the starting
directory must exist. Mind that the autoCreate option is default enabled which means the starting
directory is normally auto created if it doesn't exist. You can disable autoCreate and enable
this to ensure the starting directory must exist. Will thrown an exception if the directory
doesn't exist.
 | useList | consumer (advanced) | true | boolean | Whether to allow using LIST command when
downloading a file. Default is true. In some use cases you may want to download a specific
file and are not allowed to use the LIST command and therefore you can set this option to
false.
-| doneFileName | producer |  | String | If provided then Camel will write a 2nd done file
when the original file has been written. The done 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 done file will always be written in the same folder as the original file. Only $file.name
and $file.name.noext is supported as dynamic placeholders.
 | fileExist | producer | Override | GenericFileExist | What to do if a file already exists
with the same name. Override which is the default replaces the existing file. Append - adds
content to the existing file. Fail - throws a GenericFileOperationException indicating that
there is already an existing file. Ignore - silently ignores the problem and does not override
the existing file but assumes everything is okay. Move - option requires to use the moveExisting
option to be configured as well. The option eagerDeleteTargetFile 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 Move option will move any existing files before writing the target
file. TryRename Camel is only applicable if tempFileName option is in use. This allows to
try renaming the file from the temporary name to the actual name without doing any exists
check.This check may be faster on some file systems and especially FT
 P servers.
 | flatten | producer | false | boolean | 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 true on the producer enforces that any file name in
CamelFileName header will be stripped for any leading paths.
 | moveExisting | producer |  | String | Expression (such as File Language) used to compute
file name to use when fileExist=Move is configured. To move files into a backup subdirectory
just enter backup. This option only supports the following File Language 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 FTP component as the FTP component can only
move any existing files to a relative directory based on current dir as base.
@@ -235,6 +236,7 @@ The FTP component supports 103 endpoint options which are listed below:
 
 
 
+
 [Info]
 ====
 FTPS component default trust store


Mime
View raw message