5.15. Spring Boot Auto-Configuration
在将 aws2-s3 与 Spring Boot 搭配使用时，请确保使用以下 Maven 依赖项支持自动配置：
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-s3-starter</artifactId>
<version>{CamelSBProjectVersion}</version>
<!-- Use your Camel Spring Boot version -->
</dependency>组件支持 51 选项，如下所示。
| Name | 描述 | 默认 | 类型 |
|---|---|---|---|
| camel.component.aws2-s3.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-s3.amazon-s3-client | 引用 registry 中的 com.amazonaws.services.s3.AmazonS3。选项是软件.amazon.awssdk.services.s3.S3Client 类型。 | S3Client | |
| camel.component.aws2-s3.amazon-s3-presigner | 用于 Request 的 S3 预签名程序，它们主要用于 createDownloadLink 操作。选项是 software.amazon.awssdk.services.s3.presigner.S3Presigner 类型。 | S3Presigner | |
| camel.component.aws2-s3.auto-create-bucket | 设置 S3 存储桶 bucketName 的自动记录。如果启用了 moveAfterRead 选项，它将创建 destinationBucket（如果尚未存在）。 | false | 布尔值 |
| camel.component.aws2-s3.autoclose-body | 如果这个选项为 true，并且 includeBody 为 false，则在交换完成后会调用 S3Object.close（）方法。这个选项与 includeBody 选项相关。如果将 includeBody 设为 false，则会自动关闭Body 为 false，则最多可看到调用者关闭 S3Object 流。将 autocloseBody 设置为 true，将自动关闭 S3Object 流。 | true | 布尔值 |
| camel.component.aws2-s3.autowired-enabled | 是否启用自动。这用于自动自动自动选项（选项必须标记为 autowired），方法是在 registry 中查找是否有匹配的类型实例，然后在组件上进行配置。这可用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-s3.aws-k-m-s-key-id | 在启用 KMS 时，定义要使用的 KMS 密钥 ID。 | 字符串 | |
| camel.component.aws2-s3.batch-message-number | 以流上传模式生成批处理的消息数量。 | 10 | 整数 |
| camel.component.aws2-s3.batch-size | 流传输上传模式的批处理大小（以字节为单位）。 | 1000000 | 整数 |
| camel.component.aws2-s3.bridge-error-handler | 允许将消费者桥接到 Camel 路由 Error Handler，这意味着在消费者尝试获取传入的消息时发生任何异常，或像这样一样处理，消息现在将被作为消息进行处理，并由路由 Error Handler 处理。默认情况下，使用者将使用 org.apache.camel.spi.ExceptionHandler 处理异常，该处理程序将记录在 WARN 或 ERROR 级别并忽略。 | false | 布尔值 |
| camel.component.aws2-s3.configuration | 组件配置。选项是 org.apache.camel.component.aws2.s3.AWS2S3Configuration 类型。 | AWS2S3Configuration | |
| camel.component.aws2-s3.customer-algorithm | 定义启用了 CustomerKey 时要使用的客户算法。 | 字符串 | |
| camel.component.aws2-s3.customer-key-id | 在启用了 CustomerKey 时定义要使用的客户密钥 ID。 | 字符串 | |
| camel.component.aws2-s3.customer-key-m-d5 | 在启用了 customerKey 时定义要使用的客户密钥 MD5。 | 字符串 | |
| camel.component.aws2-s3.delete-after-read | 在检索了对象后，从 S3 中删除对象。只有提交 Exchange 时才会执行删除。如果进行回滚，则对象不会被删除。如果此选项为 false，则同一对象将会反复检索，并再次在轮询上再次进行。因此，您需要在路由中使用 Idempotent Consumer EIP 来过滤重复的。您可以使用 AWS2S3Constants#BUClKET_NAME 和 AWS2S3Constants#KEY 标头进行过滤，或者只有 AWS2S3Constants#KEY 标头进行过滤。 | true | 布尔值 |
| camel.component.aws2-s3.delete-after-write | 上传 S3 文件后删除文件对象。 | false | 布尔值 |
| camel.component.aws2-s3.delimiter | 在 com.amazonaws.services.s3.model.ListObjectsRequest 中使用的分隔符，仅使用我们感兴趣的对象。 | 字符串 | |
| camel.component.aws2-s3.destination-bucket | 定义在 moveAfterRead 设为 true 时对象必须移动的目标存储桶。 | 字符串 | |
| camel.component.aws2-s3.destination-bucket-prefix | 在对象必须移动并将 moveAfterRead 设置为 true 时，定义要使用的目的地存储桶前缀。 | 字符串 | |
| camel.component.aws2-s3.destination-bucket-suffix | 定义在对象必须移动并将 moveAfterRead 设置为 true 时要使用的目的地存储桶后缀。 | 字符串 | |
| camel.component.aws2-s3.done-file-name | 如果提供，Camel 仅会在文件存在时消耗文件。 | 字符串 | |
| camel.component.aws2-s3.enabled | 是否启用 aws2-s3 组件的自动配置。默认启用。 | 布尔值 | |
| camel.component.aws2-s3.file-name | 从具有所给文件名的存储桶中获取对象。 | 字符串 | |
| camel.component.aws2-s3.ignore-body | 若为 true，则整个 S3 对象正文将被完全忽略，如果将 S3 对象设置为 false，则将放置在正文中。把它设置为 true，将覆盖 includeBody 选项定义的任何行为。 | false | 布尔值 |
| camel.component.aws2-s3.include-body | 若为 true，则使用 S3Object 交换，并放入正文和关闭中。如果为 false，则 S3Object 流将原始数据放在正文中，标题将使用 S3 对象元数据来设置。这个选项与 autocloseBody 选项相关。如果设置 includeBody 为 true，因为 S3Object 流也会被使用，那么在 includeBody false 时，它将被关闭，然后是调用者以关闭 S3Object 流。但是，当 includeBody 为 false 时，将 autocloseBody 设置为 true，它将计划在交换完成后自动关闭 S3Object 流。 | true | 布尔值 |
| camel.component.aws2-s3.include-folders | 若为 true，则使用文件夹/目录。如果为 false，将忽略它们，不会为它们创建 Exchanges。 | true | 布尔值 |
| camel.component.aws2-s3.key-name | 通过 endpoint 参数设置 bucket 中元素的键名称。 | 字符串 | |
| camel.component.aws2-s3.lazy-start-producer | 制作者是否应该启动 lazy（在第一个消息上）。通过启动 lazy，您可以使用它来允许 CamelContext 和路由在启动期间启动，否则在启动期间出现问题，并导致路由启动失败。通过将这个启动延迟到 lazy 后，可以在通过 Camel 的路由错误处理程序路由消息期间处理启动失败。注意在处理第一个消息时，创建并启动制作者可能花费较少的时间，从而延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-s3.move-after-read | 在检索后，将对象从 S3 存储桶移到不同的存储桶。要完成此操作，必须设置 destinationBucket 选项。只有在 Exchange 被提交时，才会执行复制存储桶操作。如果进行回滚，则对象不会被移动。 | false | 布尔值 |
| camel.component.aws2-s3.multi-part-upload | 如果是 true，则 camel 将使用多部分格式上传该文件，部分大小由 partSize 选项决定。 | false | 布尔值 |
| camel.component.aws2-s3.naming-strategy | 在流传输上传模式中使用的命名策略。 | AWSS3NamingStrategyEnum | |
| camel.component.aws2-s3.operation | 当用户不想只进行上传时，要执行的操作。 | AWS2S3Operations | |
| camel.component.aws2-s3.override-endpoint | 设置覆盖端点的需求。这个选项必须与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-s3.part-size | 设置在多部分上传中使用的 partSize，默认大小为 25M。 | 26214400 | Long |
| camel.component.aws2-s3.pojo-request | 如果我们想要将 POJO 请求用作正文或非其要求。 | false | 布尔值 |
| camel.component.aws2-s3.policy | 此队列的策略在 com.amazonaws.services.s3.AmazonS3#setBucketPolicy（）方法中设置。 | 字符串 | |
| camel.component.aws2-s3.prefix | com.amazonaws.services.s3.model.ListObjectsRequest 中使用的前缀，仅用于消耗我们感兴趣的对象。 | 字符串 | |
| camel.component.aws2-s3.proxy-host | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-s3.proxy-port | 指定要在客户端定义中使用的代理端口。 | 整数 | |
| camel.component.aws2-s3.proxy-protocol | 在实例化 S3 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-s3.region | S3 客户端需要在其中工作的区域。使用此参数时，配置将预期区域的小写名称（例如 ap-east-1），您需要使用名称 Region.EU_WEST_1.id（）。 | 字符串 | |
| camel.component.aws2-s3.restarting-policy | 在流传输上传模式中使用的重启策略。 | AWSS3RestartingPolicyEnum | |
| camel.component.aws2-s3.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-s3.storage-class | 要在 com.amazonaws.services.s3.model.PutObjectRequest 请求中设置的存储类。 | 字符串 | |
| camel.component.aws2-s3.streaming-upload-mode | 当流模式为 true 时，将会在流中上传到存储桶。 | false | 布尔值 |
| camel.component.aws2-s3.streaming-upload-timeout | 当流传输上传模式为 true 时，这个选项会将超时设置为完成上传。 | Long | |
| camel.component.aws2-s3.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-s3.uri-endpoint-override | 设置覆盖 uri 端点。这个选项必须与 overrideEndpoint 选项一同使用。 | 字符串 | |
| camel.component.aws2-s3.use-aws-k-m-s | 定义是否必须使用 KMS。 | false | 布尔值 |
| camel.component.aws2-s3.use-customer-key | 定义是否必须使用客户密钥。 | false | 布尔值 |
| camel.component.aws2-s3.use-default-credentials-provider | 设置 S3 客户端是否应该通过默认凭证供应商加载凭证，或者希望传递静态凭证。 | false | 布尔值 |
