23. FTPS Source
从 FTPS 服务器接收数据。
23.1. FTPS Source Kamelet Description 复制链接链接已复制到粘贴板!
23.1.1. 身份验证 复制链接链接已复制到粘贴板!
此 Kamelet 需要用户名和密码身份验证才能访问 FTPS 服务器。FTPS 为安全文件传输提供带有 SSL/TLS 加密的 FTP。凭据通过 。
用户名和密码 属性进行配置
23.1.2. 配置 复制链接链接已复制到粘贴板!
FTPS Source Kamelet 支持以下配置:
- 连接主机 :FTPS 服务器的主机名或 IP 地址(必需)
- 连接端口 :FTPS 服务器的端口号(默认值:21)
- 用户名 :FTPS 身份验证的用户名(必需)
- 密码 :FTPS 身份验证的密码(必需)
- 目录名称 :FTPS 服务器上的起始目录路径(必需)
- 被动模式:对 FTPS 连接使用被动模式(默认为 false)
- 递归: 处理子目录中的文件(默认为 false)
- idempotent: Skip already-processed 文件(默认为 true)
- 二进制 :使用二进制传输模式而不是 ASCII (默认: false)
- 自动创建 :如果起始目录不存在,则自动创建其起始目录(默认值: true)
- 删除 :在成功处理后删除文件(默认:false)
23.1.3. 输出格式 复制链接链接已复制到粘贴板!
Kamelet 输出文件内容作为 InputStream,并设置带有文件信息的标头: - file: 处理的文件的名称 - ce-file: Cloud Events 兼容文件名标头
23.1.4. 安全性 复制链接链接已复制到粘贴板!
FTPS 通过使用 SSL/TLS 加密连接,提供通过标准 FTP 增强的安全性。这样可确保安全传输凭证和数据。
23.1.5. 使用示例 复制链接链接已复制到粘贴板!
- route:
from:
uri: "kamelet:ftps-source"
parameters:
connectionHost: "ftps.example.com"
connectionPort: "21"
username: "ftpsuser"
password: "ftpspass"
directoryName: "/secure-incoming"
steps:
- to:
uri: "kamelet:log-sink"
23.1.6. 带有 Passive mode 和 Binary Transfer 的示例 复制链接链接已复制到粘贴板!
- route:
from:
uri: "kamelet:ftps-source"
parameters:
connectionHost: "ftps.example.com"
connectionPort: "990"
username: "ftpsuser"
password: "ftpspass"
directoryName: "/data"
passiveMode: true
binary: true
recursive: true
steps:
- to:
uri: "kamelet:log-sink"
这个示例使用端口 990 (对于隐式 FTPS),启用被动模式、二进制传输和递归目录处理。
23.2. 配置选项 复制链接链接已复制到粘贴板!
下表总结了可用于 ftps-source Kamelet 的配置选项:
| 属性 | 名称 | 描述 | 类型 | 默认 | 示例 |
|---|---|---|---|---|---|
| connectionHost * | 连接主机 | FTPS 服务器的主机名。 | 字符串 | ||
| connectionPort * | 连接端口 | FTPS 服务器的端口。 | 字符串 | 21 | |
| directoryName * | 目录名称 | 起始目录。 | 字符串 | ||
| password * | 密码 | 用于访问 FTPS 服务器的密码。 | 字符串 | ||
| username * | 用户名 | 用于访问 FTPS 服务器的用户名。 | 字符串 | ||
| autoCreate | autocreate Missing directory | 自动创建起始目录。 | 布尔值 | True | |
| 二进制 | 二进制 | 指定文件传输模式 BINARY 或 ASCII。默认为 ASCII (false)。 | 布尔值 | False | |
| delete | 删除 | 如果为 true,则在成功处理后会删除该文件。 | 布尔值 | False | |
| idempotent | idempotency | 跳过已处理的文件。 | 布尔值 | True | |
| passiveMode | 被动模式 | 指定使用被动模式连接。 | 布尔值 | False | |
| 递归 | 递归 | 如果一个目录,也查找所有子目录中的文件。 | 布尔值 | False |
* = 标记为星号的字段 是必需的。
23.3. 依赖项 复制链接链接已复制到粘贴板!
在运行时,ftps-source Kamelet 依赖于以下依赖项:
<dependencies>
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifact>camel-quarkus-core</artifact>
</dependency>
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifact>camel-quarkus-ftp</artifact>
</dependency>
<dependency>
<groupId>org.apache.camel.quarkus</groupId>
<artifact>camel-quarkus-kamelet</artifact>
</dependency>
<dependency>
<groupId>org.apache.camel.kamelets</groupId>
<artifact>camel-kamelets-utils</artifact>
<version>{kamelets-utils-version}</version>
</dependency>
</dependencies>
23.4. kamelets 源文件 复制链接链接已复制到粘贴板!
https://github.com/apache/camel-kamelets/blob/4.14.x/kamelets/ftps-source.kamelet.yaml