8.17. Spring Boot Auto-Configuration
当在 Spring Boot 中使用 aws2-sqs 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-sqs-starter</artifactId> </dependency>
组件支持 44 选项,如下所列。
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
camel.component.aws2-sqs.access-key | Amazon AWS 访问密钥. | 字符串 | |
camel.component.aws2-sqs.amazon-a-w-s-host | Amazon AWS 云的主机名。 | amazonaws.com | 字符串 |
camel.component.aws2-sqs.amazon-s-q-s-client | 将 AmazonSQS 用作客户端。选项是一个 software.amazon.awssdk.services.sqs.SqsClient 类型。 | SqsClient | |
camel.component.aws2-sqs.attribute-names | 在消费时要接收的属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
camel.component.aws2-sqs.auto-create-queue | 设置队列的自动创建. | false | 布尔值 |
camel.component.aws2-sqs.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
camel.component.aws2-sqs.batch-separator | 在传递 String 以发送批处理消息操作时,设置分隔符。 | , | 字符串 |
camel.component.aws2-sqs.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
camel.component.aws2-sqs.concurrent-consumers | 允许您使用多个线程轮询 sqs 队列来提高吞吐量。 | 1 | 整数 |
camel.component.aws2-sqs.configuration | AWS SQS 默认配置。选项是 org.apache.camel.component.aws2.sqs.Sqs2Configuration 类型。 | Sqs2Configuration | |
camel.component.aws2-sqs.default-visibility-timeout | 默认可见性超时(以秒为单位)。 | 整数 | |
camel.component.aws2-sqs.delay-queue | 定义您是否要将 delaySeconds 选项应用到队列或单个消息。 | false | 布尔值 |
camel.component.aws2-sqs.delay-seconds | 延迟发送消息的秒数。 | 整数 | |
camel.component.aws2-sqs.delete-after-read | 读取后,从 SQS 删除消息。 | true | 布尔值 |
camel.component.aws2-sqs.delete-if-filtered | 如果交换具有键 Sqs2Constants#SQS_DELETE_FILTERED (CamelAwsSqsDeleteFiltered),则是否将 DeleteMessage 发送到 SQS 队列。 | true | 布尔值 |
camel.component.aws2-sqs.enabled | 是否启用 aws2-sqs 组件的自动配置。这默认是启用的。 | 布尔值 | |
camel.component.aws2-sqs.extend-message-visibility | 如果启用,则调度的后台任务将在 SQS 上保持消息可见性。如果处理消息需要很长时间。如果设置为 true defaultVisibilityTimeout,则必须设置。详情请参阅 Amazon 文档。 | false | 布尔值 |
camel.component.aws2-sqs.kms-data-key-reuse-period-seconds | Amazon SQS 在再次调用 AWS KMS 之前,以便 Amazon SQS 可以重复使用或解密信息的时间长度(以秒为单位)。一个代表秒的整数,在 60 秒 (1 分钟) 和 86,400 秒 (24 小时)之间。默认:300 (5 分钟)。 | 整数 | |
camel.component.aws2-sqs.kms-master-key-id | Amazon SQS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
camel.component.aws2-sqs.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
camel.component.aws2-sqs.maximum-message-size | maximumMessageSize (以字节为单位)SQS 消息可以包含此队列。 | 整数 | |
camel.component.aws2-sqs.message-attribute-names | 在消费时要接收的消息属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
camel.component.aws2-sqs.message-deduplication-id-strategy | 仅适用于 FIFO 队列。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 | useExchangeId | 字符串 |
camel.component.aws2-sqs.message-group-id-strategy | 仅适用于 FIFO 队列。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 | 字符串 | |
camel.component.aws2-sqs.message-retention-period | SQS 为此队列保留一个消息的 messageRetentionPeriod (以秒为单位)。 | 整数 | |
camel.component.aws2-sqs.operation | 当用户不想发送消息时,要执行的操作。 | Sqs2Operations | |
camel.component.aws2-sqs.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
camel.component.aws2-sqs.policy | 此队列的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
camel.component.aws2-sqs.protocol | 用于与 SQS 通信的底层协议。 | https | 字符串 |
camel.component.aws2-sqs.proxy-host | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
camel.component.aws2-sqs.proxy-port | 在实例化 SQS 客户端时定义代理端口。 | 整数 | |
camel.component.aws2-sqs.proxy-protocol | 在实例化 SQS 客户端时定义代理协议。 | 协议 | |
camel.component.aws2-sqs.queue-owner-a-w-s-account-id | 当您需要将队列与不同的帐户所有者连接时,指定队列所有者 aws 帐户 ID。 | 字符串 | |
camel.component.aws2-sqs.queue-url | 明确定义 queueUrl:所有其他参数(会影响 queueUrl)将被忽略。这个参数被用来连接到 SQS 的模拟实施,用于测试。 | 字符串 | |
camel.component.aws2-sqs.receive-message-wait-time-seconds | 如果您没有在请求中指定 WaitTimeSeconds,则使用 queue 属性 ReceiveMessageWaitTimeSeconds 来确定要等待的时长。 | 整数 | |
camel.component.aws2-sqs.redrive-policy | 指定发送消息到 DeadLetter 队列的策略。请参阅 Amazon 文档的详情。 | 字符串 | |
camel.component.aws2-sqs.region | SQS 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
camel.component.aws2-sqs.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
camel.component.aws2-sqs.server-side-encryption-enabled | 定义是否在队列中启用服务器端加密。 | false | 布尔值 |
camel.component.aws2-sqs.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
camel.component.aws2-sqs.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
camel.component.aws2-sqs.use-default-credentials-provider | 设置 SQS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
camel.component.aws2-sqs.visibility-timeout | 在由 ReceiveMessage 请求检索后,收到的消息会被隐藏在 com.amazonaws.services.sqs.model.SetQueueAttributesRequest 中检索的持续时间(以秒为单位)。这只有在与 defaultVisibilityTimeout 不同时才有意义。它永久更改队列可见性超时属性。 | 整数 | |
camel.component.aws2-sqs.wait-time-seconds | ReceiveMessage 操作调用的持续时间(0 到 20)将等待直到队列中消息包含在响应中。 | 整数 |