第 111 章 FTP 组件
从 Camel 版本 1.1 开始提供
这个组件通过 FTP 和 SFTP 协议提供对远程文件系统的访问。
从远程 FTP 服务器消耗时,请确保在更 消耗文件时阅读标题为 Default 的部分,以了解与消耗文件相关的详细信息。
不支持 绝对路径。Camel 2.16 将修剪 目录名
中的所有前导斜杠,从而将绝对路径转换为相对路径。日志中会显示 WARN 消息。
Maven 用户需要将以下依赖项添加到此组件的 pom.xml
中:
<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-ftp</artifactId> <version>x.x.x</version>See the documentation of the Apache Commons <!-- use the same version as your Camel core version --> </dependency>
111.1. URI 格式
ftp://[username@]hostname[:port]/directoryname[?options] sftp://[username@]hostname[:port]/directoryname[?options] ftps://[username@]hostname[:port]/directoryname[?options]
其中 directoryname 代表底层目录。目录名称是相对路径。不支持 绝对路径。相对路径可以包含嵌套文件夹,如 /inbox/us。
对于 Camel 2.16 之前的 Camel 版本,directoryName 必须已经存在,因为此组件不支持 autoCreate
选项(文件组件确实这样做)。原因在于,其 FTP 管理员(FTP 服务器)任务用于正确设置用户帐户,以及具有适当文件权限的主目录。
对于 Camel 2.16,支持autoCreate
选项。当消费者启动时,在调度轮询前,执行额外的 FTP 操作来创建为端点配置的目录。autoCreate
的默认值为 true
。
如果没有提供 用户名,则尝试使用密码尝试 匿名
登录。
如果没有提供 端口号,Camel 将根据协议(ftp = 21, sftp = 22, ftps = 2222)提供默认值。
您可以使用以下格式在 URI 中附加查询选项 ?option=value& amp;option=value&…
此组件为实际 FTP 工作使用两个不同的库。FTP 和 FTPS 使用 Apache Commons Net,而 SFTP 使用 JCraft JSCH。
FTPS 组件仅适用于 Camel 2.2 或更新版本。
FTPS (也称为 FTP Secure)是 FTP 的扩展,它增加了对传输层安全(TLS)和安全套接字层(SSL)加密协议的支持。