Camel Spring Boot 参考
前言 复制链接链接已复制到粘贴板!
使开源包含更多
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
第 1 章 AMQP 复制链接链接已复制到粘贴板!
从 Camel 1.2 开始
支持生成者和消费者
AMQP 组件支持使用 AMQP 项目的 JMS Client API 支持 AMQP 1.0 协议。http://qpid.apache.org/
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-amqp</artifactId>
<version>${camel.version}</version> <!-- use the same version as your Camel core version -->
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-amqp</artifactId>
<version>${camel.version}</version> <!-- use the same version as your Camel core version -->
</dependency>
1.1. URI 格式 复制链接链接已复制到粘贴板!
amqp:[queue:|topic:]destinationName[?options]
amqp:[queue:|topic:]destinationName[?options]
1.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
1.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
1.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
1.3. 组件选项 复制链接链接已复制到粘贴板!
AMQP 组件支持 100 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clientId (common) | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| ConnectionFactory (common) | 要使用的连接工厂。必须在组件或端点上配置连接工厂。 | ConnectionFactory | |
| disableReplyTo (common) | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| durableSubscriptionName (common) | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| includeAmqpAnnotations (common) | 从 AMQP 到 Camel 消息映射时是否包含 AMQP 注解。把它设置为 true 会映射包含 JMS_AMQP_MA_ 前缀的 AMQP 消息注解到消息标头。由于 Apacheqpid JMS API 中的限制,当前交付注解将被忽略。 | false | 布尔值 |
| jmsMessageType (common) | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 Enum 值:
| JmsMessageType | |
| replyTo (common) | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| testConnectionOnStartup (common) | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| acknowledgementModeName (consumer) | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 Enum 值:
| AUTO_ACKNOWLEDGE | 字符串 |
| artemisConsumerPriority (consumer) | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | int | |
| asyncConsumer (consumer) | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| autoStartup (consumer) | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| cacheLevel (consumer) | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | int | |
| cacheLevelName (consumer) | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 Enum 值:
| CACHE_AUTO | 字符串 |
| concurrentConsumers (consumer) | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | int |
| maxConcurrentConsumers (consumer) | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | int | |
| replyToDeliveryPersistent (consumer) | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| selector (consumer) | 设置要使用的 JMS 选择器。 | 字符串 | |
| subscriptionDurable (consumer) | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| subscriptionName (consumer) | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| subscriptionShared (consumer) | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| acceptMessagesWhileStopping (consumer (advanced)) | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| allowReplyManagerQuickStop (consumer (advanced)) | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| consumerType (consumer (advanced)) | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| defaultTaskExecutorType (consumer (advanced)) | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 Enum 值:
| DefaultTaskExecutorType | |
| eagerLoadingOfProperties (consumer (advanced)) | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| eagerPoisonBody (consumer (advanced)) | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| exposeListenerSession (consumer (advanced)) | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| replyToConsumerType (consumer (advanced)) | 回复消费者的消费者类型(当执行请求/回复时),可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| replyToSameDestinationAllowed (consumer (advanced)) | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| taskExecutor (consumer (advanced)) | 允许您指定自定义任务执行器以使用消息。 | TaskExecutor | |
| deliveryDelay (producer) | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | long |
| deliveryMode (producer) | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 Enum 值:
| 整数 | |
| deliveryPersistent (producer) | 指定默认使用持久性交付。 | true | 布尔值 |
| explicitQosEnabled (producer) | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| formatDateHeadersToIso8601 (producer) | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| preserveMessageQos (producer) | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| priority (producer) | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 Enum 值:
| 4 | int |
| replyToConcurrentConsumers (producer) | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | int |
| replyToMaxConcurrentConsumers (producer) | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | int | |
| replyToOnTimeoutMaxConcurrentConsumers (producer) | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | int |
| replyToOverride (producer) | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| replyToType (producer) | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 Enum 值:
| ReplyToType | |
| requestTimeout (producer) | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。 | 20000 | long |
| timeToLive (producer) | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | long |
| allowAdditionalHeaders (producer (advanced)) | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| allowNullBody (producer (advanced)) | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| alwaysCopyMessage (producer (advanced)) | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| correlationProperty (producer (advanced)) | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| disableTimeToLive (producer (advanced)) | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| forceSendOriginalMessage (producer (advanced)) | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| includeSentJMSMessageID (producer (advanced)) | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| replyToCacheLevelName (producer (advanced)) | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 Enum 值:
| 字符串 | |
| replyToDestinationSelectorName (producer (advanced)) | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| streamMessageTypeEnabled (producer (advanced)) | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| allowAutoWiredConnectionFactory (advanced) | 如果没有配置连接工厂,是否从 registry 自动发现 ConnectionFactory。如果只找到一个 ConnectionFactory 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| allowAutoWiredDestinationResolver (advanced) | 如果没有配置目标解析器,是否从 registry 自动发现 DestinationResolver。如果只找到一个 DestinationResolver 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| allowSerializedHeaders (advanced) | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| artemisStreamingEnabled (advanced) | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| asyncStartListener (advanced) | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| asyncStopListener (advanced) | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| 配置 (高级) | 使用共享的 JMS 配置。 | JmsConfiguration | |
| destinationResolver (advanced) | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。 | DestinationResolver | |
| errorHandler (advanced) | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。 | ErrorHandler | |
| exceptionListener (advanced) | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。 | ExceptionListener | |
| idleConsumerLimit (advanced) | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | int |
| idleTaskExecutionLimit (advanced) | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | int |
| includeAllJMSXProperties (advanced) | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| jmsKeyFormatStrategy (advanced) | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 Enum 值:
| JmsKeyFormatStrategy | |
| mapJmsMessage (advanced) | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| maxMessagesPerTask (advanced) | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | int |
| messageConverter (advanced) | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。 | MessageConverter | |
| messageCreatedStrategy (advanced) | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。 | MessageCreatedStrategy | |
| messageIdEnabled (advanced) | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| messageListenerContainerFactory (advanced) | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。 | MessageListenerContainerFactory | |
| messageTimestampEnabled (advanced) | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| pubSubNoLocal (advanced) | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| queueBrowseStrategy (advanced) | 在浏览队列时使用自定义 QueueBrowseStrategy。 | QueueBrowseStrategy | |
| receiveTimeout (advanced) | 接收消息的超时时间(以毫秒为单位)。 | 1000 | long |
| recoveryInterval (advanced) | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。 | 5000 | long |
| requestTimeoutCheckerInterval (advanced) | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。 | 1000 | long |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| transferException (advanced) | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| transferExchange (advanced) | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| useMessageIDAsCorrelationID (advanced) | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| waitForProvisionCorrelationToBeUpdatedCounter (advanced) | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | int |
| waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced) | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。 | 100 | long |
| HeaderFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| errorHandlerLoggingLevel (logging) | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 Enum 值:
| WARN | LoggingLevel |
| errorHandlerLogStackTrace (logging) | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| 密码 (安全) | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| 用户名 (安全) | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| Transacted (transaction) | 指定是否使用转换模式。 | false | 布尔值 |
| TransactedInOut (transaction) | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| lazyCreateTransactionManager (transaction (advanced)) | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| transactionManager (transaction (advanced)) | 要使用的 Spring 事务管理器。 | PlatformTransactionManager | |
| transactionName (transaction (advanced)) | 要使用的事务的名称。 | 字符串 | |
| transactionTimeout (transaction (advanced)) | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | int |
1.4. 端点选项 复制链接链接已复制到粘贴板!
AMQP 端点使用 URI 语法进行配置:
amqp:destinationType:destinationName
amqp:destinationType:destinationName
使用以下路径和查询参数:
1.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| destinationType (common) | 要使用的目标种类。 Enum 值:
| queue | 字符串 |
| destinationName (common) | 用作目的地的队列或主题 所需的 名称。 | 字符串 |
1.4.2. 查询参数(96 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clientId (common) | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| ConnectionFactory (common) | 要使用的连接工厂。必须在组件或端点上配置连接工厂。 | ConnectionFactory | |
| disableReplyTo (common) | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| durableSubscriptionName (common) | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| jmsMessageType (common) | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 Enum 值:
| JmsMessageType | |
| replyTo (common) | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| testConnectionOnStartup (common) | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| acknowledgementModeName (consumer) | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 Enum 值:
| AUTO_ACKNOWLEDGE | 字符串 |
| artemisConsumerPriority (consumer) | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | int | |
| asyncConsumer (consumer) | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| autoStartup (consumer) | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| cacheLevel (consumer) | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | int | |
| cacheLevelName (consumer) | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 Enum 值:
| CACHE_AUTO | 字符串 |
| concurrentConsumers (consumer) | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | int |
| maxConcurrentConsumers (consumer) | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | int | |
| replyToDeliveryPersistent (consumer) | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| selector (consumer) | 设置要使用的 JMS 选择器。 | 字符串 | |
| subscriptionDurable (consumer) | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| subscriptionName (consumer) | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| subscriptionShared (consumer) | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| acceptMessagesWhileStopping (consumer (advanced)) | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| allowReplyManagerQuickStop (consumer (advanced)) | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| consumerType (consumer (advanced)) | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| defaultTaskExecutorType (consumer (advanced)) | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 Enum 值:
| DefaultTaskExecutorType | |
| eagerLoadingOfProperties (consumer (advanced)) | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| eagerPoisonBody (consumer (advanced)) | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| exposeListenerSession (consumer (advanced)) | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| replyToConsumerType (consumer (advanced)) | 回复消费者的消费者类型(当执行请求/回复时),可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| replyToSameDestinationAllowed (consumer (advanced)) | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| taskExecutor (consumer (advanced)) | 允许您指定自定义任务执行器以使用消息。 | TaskExecutor | |
| deliveryDelay (producer) | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | long |
| deliveryMode (producer) | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 Enum 值:
| 整数 | |
| deliveryPersistent (producer) | 指定默认使用持久性交付。 | true | 布尔值 |
| explicitQosEnabled (producer) | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| formatDateHeadersToIso8601 (producer) | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| preserveMessageQos (producer) | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| priority (producer) | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 Enum 值:
| 4 | int |
| replyToConcurrentConsumers (producer) | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | int |
| replyToMaxConcurrentConsumers (producer) | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | int | |
| replyToOnTimeoutMaxConcurrentConsumers (producer) | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | int |
| replyToOverride (producer) | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| replyToType (producer) | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 Enum 值:
| ReplyToType | |
| requestTimeout (producer) | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。 | 20000 | long |
| timeToLive (producer) | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | long |
| allowAdditionalHeaders (producer (advanced)) | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| allowNullBody (producer (advanced)) | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| alwaysCopyMessage (producer (advanced)) | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| correlationProperty (producer (advanced)) | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| disableTimeToLive (producer (advanced)) | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| forceSendOriginalMessage (producer (advanced)) | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| includeSentJMSMessageID (producer (advanced)) | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| replyToCacheLevelName (producer (advanced)) | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 Enum 值:
| 字符串 | |
| replyToDestinationSelectorName (producer (advanced)) | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| streamMessageTypeEnabled (producer (advanced)) | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| allowSerializedHeaders (advanced) | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| artemisStreamingEnabled (advanced) | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| asyncStartListener (advanced) | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| asyncStopListener (advanced) | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| destinationResolver (advanced) | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。 | DestinationResolver | |
| errorHandler (advanced) | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。 | ErrorHandler | |
| exceptionListener (advanced) | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。 | ExceptionListener | |
| HeaderFilterStrategy (advanced) | 使用自定义 HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| idleConsumerLimit (advanced) | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | int |
| idleTaskExecutionLimit (advanced) | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | int |
| includeAllJMSXProperties (advanced) | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| jmsKeyFormatStrategy (advanced) | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 Enum 值:
| JmsKeyFormatStrategy | |
| mapJmsMessage (advanced) | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| maxMessagesPerTask (advanced) | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | int |
| messageConverter (advanced) | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。 | MessageConverter | |
| messageCreatedStrategy (advanced) | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。 | MessageCreatedStrategy | |
| messageIdEnabled (advanced) | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| messageListenerContainerFactory (advanced) | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。 | MessageListenerContainerFactory | |
| messageTimestampEnabled (advanced) | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| pubSubNoLocal (advanced) | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| receiveTimeout (advanced) | 接收消息的超时时间(以毫秒为单位)。 | 1000 | long |
| recoveryInterval (advanced) | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。 | 5000 | long |
| requestTimeoutCheckerInterval (advanced) | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。 | 1000 | long |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| transferException (advanced) | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| transferExchange (advanced) | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| useMessageIDAsCorrelationID (advanced) | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| waitForProvisionCorrelationToBeUpdatedCounter (advanced) | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | int |
| waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced) | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。 | 100 | long |
| errorHandlerLoggingLevel (logging) | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 Enum 值:
| WARN | LoggingLevel |
| errorHandlerLogStackTrace (logging) | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| 密码 (安全) | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| 用户名 (安全) | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| Transacted (transaction) | 指定是否使用转换模式。 | false | 布尔值 |
| TransactedInOut (transaction) | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| lazyCreateTransactionManager (transaction (advanced)) | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| transactionManager (transaction (advanced)) | 要使用的 Spring 事务管理器。 | PlatformTransactionManager | |
| transactionName (transaction (advanced)) | 要使用的事务的名称。 | 字符串 | |
| transactionTimeout (transaction (advanced)) | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | int |
1.5. 使用方法 复制链接链接已复制到粘贴板!
当 AMQP 组件继承自 JMS 组件时,前者的使用与后者几乎相同:
使用 AMQP 组件
1.6. 配置 AMQP 组件 复制链接链接已复制到粘贴板!
创建 AMQP 1.0 组件
AMQPComponent amqp = AMQPComponent.amqpComponent("amqp://localhost:5672");
AMQPComponent authorizedAmqp = AMQPComponent.amqpComponent("amqp://localhost:5672", "user", "password");
AMQPComponent amqp = AMQPComponent.amqpComponent("amqp://localhost:5672");
AMQPComponent authorizedAmqp = AMQPComponent.amqpComponent("amqp://localhost:5672", "user", "password");
您还可以将 org.apache.camel.component.amqp.amqpConnectionDetails 的实例 添加到 registry 中,以便自动配置 AMQP 组件。例如,对于 Spring Boot,您只需要定义 bean:
AMQP 连接详情自动配置
同样,在使用 Camel-CDI 时也可以使用 CDI producer 方法
CDI 的 AMQP 连接详情自动配置
@Produces
AMQPConnectionDetails amqpConnection() {
return new AMQPConnectionDetails("amqp://localhost:5672");
}
@Produces
AMQPConnectionDetails amqpConnection() {
return new AMQPConnectionDetails("amqp://localhost:5672");
}
您还可以依赖 来读取 AMQP 连接详情。工厂方法 AMQPConnectionDetails.discoverAMQP () 会尝试以类似 Kubernetes 的约定读取 Camel 属性,如以下代码片段所示:
AMQP 连接详情自动配置
启用 AMQP 具体选项
例如,如果您需要启用 amqp.traceFrames,您可以将选项附加到 URI 中,如下例所示:
AMQPComponent amqp = AMQPComponent.amqpComponent("amqp://localhost:5672?amqp.traceFrames=true");
AMQPComponent amqp = AMQPComponent.amqpComponent("amqp://localhost:5672?amqp.traceFrames=true");
请参考 QPID JMS 客户端配置。
1.7. 使用主题 复制链接链接已复制到粘贴板!
要使用使用 camel-amqp 的主题,您需要将组件配置为使用 topic:// 作为主题前缀,如下所示:
请记住,AMQPComponent在ComponentamqpComponent () 方法和 AMQPConnectionDetails 都预先配置带有主题前缀的组件,因此您不必显式配置它。
1.8. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 amqp 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-amqp-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-amqp-starter</artifactId>
</dependency>
组件支持 101 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.amqp.accept-messages-while-stopping | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| camel.component.amqp.acknowledgement-mode-name | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 | AUTO_ACKNOWLEDGE | 字符串 |
| camel.component.amqp.allow-additional-headers | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| camel.component.amqp.allow-auto-wired-connection-factory | 如果没有配置连接工厂,是否从 registry 自动发现 ConnectionFactory。如果只找到一个 ConnectionFactory 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| camel.component.amqp.allow-auto-wired-destination-resolver | 如果没有配置目标解析器,是否从 registry 自动发现 DestinationResolver。如果只找到一个 DestinationResolver 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| camel.component.amqp.allow-null-body | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| camel.component.amqp.allow-reply-manager-quick-stop | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| camel.component.amqp.allow-serialized-headers | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| camel.component.amqp.always-copy-message | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| camel.component.amqp.artemis-consumer-priority | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | 整数 | |
| camel.component.amqp.artemis-streaming-enabled | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| camel.component.amqp.async-consumer | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| camel.component.amqp.async-start-listener | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| camel.component.amqp.async-stop-listener | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| camel.component.amqp.auto-startup | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| camel.component.amqp.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.amqp.cache-level | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | 整数 | |
| camel.component.amqp.cache-level-name | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 | CACHE_AUTO | 字符串 |
| camel.component.amqp.client-id | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| camel.component.amqp.concurrent-consumers | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | 整数 |
| camel.component.amqp.configuration | 使用共享的 JMS 配置。选项是 org.apache.camel.component.jms.JmsConfiguration 类型。 | JmsConfiguration | |
| camel.component.amqp.connection-factory | 要使用的连接工厂。必须在组件或端点上配置连接工厂。选项是 javax.jms.ConnectionFactory 类型。 | ConnectionFactory | |
| camel.component.amqp.consumer-type | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 | ConsumerType | |
| camel.component.amqp.correlation-property | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| camel.component.amqp.default-task-executor-type | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 | DefaultTaskExecutorType | |
| camel.component.amqp.delivery-delay | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | Long |
| camel.component.amqp.delivery-mode | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 | 整数 | |
| camel.component.amqp.delivery-persistent | 指定默认使用持久性交付。 | true | 布尔值 |
| camel.component.amqp.destination-resolver | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。选项是一个 org.springframework.jms.support.destination.DestinationResolver 类型。 | DestinationResolver | |
| camel.component.amqp.disable-reply-to | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| camel.component.amqp.disable-time-to-live | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| camel.component.amqp.durable-subscription-name | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| camel.component.amqp.eager-loading-of-properties | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| camel.component.amqp.eager-poison-body | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| camel.component.amqp.enabled | 是否启用 amqp 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.amqp.error-handler | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。选项是一个 org.springframework.util.ErrorHandler 类型。 | ErrorHandler | |
| camel.component.amqp.error-handler-log-stack-trace | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| camel.component.amqp.error-handler-logging-level | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 | LoggingLevel | |
| camel.component.amqp.exception-listener | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。选项是 javax.jms.ExceptionListener 类型。 | ExceptionListener | |
| camel.component.amqp.explicit-qos-enabled | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| camel.component.amqp.expose-listener-session | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| camel.component.amqp.force-send-original-message | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| camel.component.amqp.format-date-headers-to-iso8601 | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| camel.component.amqp.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.amqp.idle-consumer-limit | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | 整数 |
| camel.component.amqp.idle-task-execution-limit | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | 整数 |
| camel.component.amqp.include-all-jmsx-properties | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| camel.component.amqp.include-amqp-annotations | 从 AMQP 到 Camel 消息映射时是否包含 AMQP 注解。把它设置为 true 会映射包含 JMS_AMQP_MA_ 前缀的 AMQP 消息注解到消息标头。由于 Apacheqpid JMS API 中的限制,当前交付注解将被忽略。 | false | 布尔值 |
| camel.component.amqp.include-sent-jms-message-id | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| camel.component.amqp.jms-key-format-strategy | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 | JmsKeyFormatStrategy | |
| camel.component.amqp.jms-message-type | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 | JmsMessageType | |
| camel.component.amqp.lazy-create-transaction-manager | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| camel.component.amqp.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.amqp.map-jms-message | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| camel.component.amqp.max-concurrent-consumers | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 整数 | |
| camel.component.amqp.max-messages-per-task | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | 整数 |
| camel.component.amqp.message-converter | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。选项是一个 org.springframework.jms.support.converter.MessageConverter 类型。 | MessageConverter | |
| camel.component.amqp.message-created-strategy | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。选项是一个 org.apache.camel.component.jms.MessageCreatedStrategy 类型。 | MessageCreatedStrategy | |
| camel.component.amqp.message-id-enabled | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| camel.component.amqp.message-listener-container-factory | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。选项是 org.apache.camel.component.jms.MessageListenerContainerFactory 类型。 | MessageListenerContainerFactory | |
| camel.component.amqp.message-timestamp-enabled | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| camel.component.amqp.password | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| camel.component.amqp.preserve-message-qos | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| camel.component.amqp.priority | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 | 4 | 整数 |
| camel.component.amqp.pub-sub-no-local | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| camel.component.amqp.queue-browse-strategy | 在浏览队列时使用自定义 QueueBrowseStrategy。选项是一个 org.apache.camel.component.jms.QueueBrowseStrategy 类型。 | QueueBrowseStrategy | |
| camel.component.amqp.receive-timeout | 接收消息的超时时间(以毫秒为单位)。选项是一个长类型。 | 1000 | Long |
| camel.component.amqp.recovery-interval | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。选项是一个长类型。 | 5000 | Long |
| camel.component.amqp.reply-to | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| camel.component.amqp.reply-to-cache-level-name | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 | 字符串 | |
| camel.component.amqp.reply-to-concurrent-consumers | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | 整数 |
| camel.component.amqp.reply-to-consumer-type | 回复消费者的消费者类型(当执行请求/回复时),可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 | ConsumerType | |
| camel.component.amqp.reply-to-delivery-persistent | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| camel.component.amqp.reply-to-destination-selector-name | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| camel.component.amqp.reply-to-max-concurrent-consumers | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 整数 | |
| camel.component.amqp.reply-to-on-timeout-max-concurrent-consumers | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | 整数 |
| camel.component.amqp.reply-to-override | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| camel.component.amqp.reply-to-same-destination-allowed | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| camel.component.amqp.reply-to-type | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 | ReplyToType | |
| camel.component.amqp.request-timeout | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。选项是一个长类型。 | 20000 | Long |
| camel.component.amqp.request-timeout-checker-interval | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。选项是一个长类型。 | 1000 | Long |
| camel.component.amqp.selector | 设置要使用的 JMS 选择器。 | 字符串 | |
| camel.component.amqp.stream-message-type-enabled | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| camel.component.amqp.subscription-durable | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| camel.component.amqp.subscription-name | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| camel.component.amqp.subscription-shared | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| camel.component.amqp.synchronous | 设置是否应严格使用同步处理。 | false | 布尔值 |
| camel.component.amqp.task-executor | 允许您指定自定义任务执行器以使用消息。选项是一个 org.springframework.core.task.TaskExecutor 类型。 | TaskExecutor | |
| camel.component.amqp.test-connection-on-startup | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| camel.component.amqp.time-to-live | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | Long |
| camel.component.amqp.transacted | 指定是否使用转换模式。 | false | 布尔值 |
| camel.component.amqp.transacted-in-out | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| camel.component.amqp.transaction-manager | 要使用的 Spring 事务管理器。选项是一个 org.springframework.transaction.platformTransactionManager 类型。 | PlatformTransactionManager | |
| camel.component.amqp.transaction-name | 要使用的事务的名称。 | 字符串 | |
| camel.component.amqp.transaction-timeout | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | 整数 |
| camel.component.amqp.transfer-exception | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| camel.component.amqp.transfer-exchange | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| camel.component.amqp.use-message-id-as-correlation-id | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| camel.component.amqp.username | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| camel.component.amqp.wait-for-provision-correlation-to-be-updated-counter | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | 整数 |
| camel.component.amqp.wait-for-provision-correlation-to-be-updated-thread-sleeping-time | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。选项是一个长类型。 | 100 | Long |
第 2 章 AWS CloudWatch 复制链接链接已复制到粘贴板!
仅支持生成者
AWS2 Cloudwatch 组件允许消息发送到 Amazon CloudWatch 指标。Amazon API 的实现由 AWS SDK 提供。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并有权使用 Amazon CloudWatch。如需更多信息,请参阅 Amazon CloudWatch。
2.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-cw://namespace[?options]
aws2-cw://namespace[?options]
如果指标不存在,则会创建它们。您可以将查询选项附加到 URI 中,格式为 ?options=value&option2=value&…
2.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
2.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
2.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
2.3. 组件选项 复制链接链接已复制到粘贴板!
AWS CloudWatch 组件支持 18 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonCwClient (生成者) | Autowired 使用 AmazonCloudWatch 作为客户端。 | CloudWatchClient | |
| 配置 (生成者) | 组件配置。 | Cw2Configuration | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| name (producer) | 指标名称。 | 字符串 | |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (producer) | 在实例化 CW 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | 在实例化 CW 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (producer) | 在实例化 CW 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (producer) | CW 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| timestamp (producer) | 指标时间戳。 | instant | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| unit (producer) | 指标单元。 | 字符串 | |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| value (producer) | 指标值。 | å�Œ | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
2.4. 端点选项 复制链接链接已复制到粘贴板!
AWS CloudWatch 端点使用 URI 语法进行配置:
aws2-cw:namespace
aws2-cw:namespace
使用以下路径和查询参数:
2.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| namespace (producer) | 必需的 指标命名空间。 | 字符串 |
2.4.2. 查询参数 (16 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonCwClient (生成者) | Autowired 使用 AmazonCloudWatch 作为客户端。 | CloudWatchClient | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| name (producer) | 指标名称。 | 字符串 | |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (producer) | 在实例化 CW 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | 在实例化 CW 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (producer) | 在实例化 CW 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (producer) | CW 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| timestamp (producer) | 指标时间戳。 | instant | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| unit (producer) | 指标单元。 | 字符串 | |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| value (producer) | 指标值。 | å�Œ | |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 CW 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 amazonCwClient,才能访问 Amazon 的 CloudWatch。
2.5. 使用方法 复制链接链接已复制到粘贴板!
2.5.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
2.5.2. 由 CW producer 评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| Amazon CW 指标名称。 |
|
|
| Amazon CW 指标值。 |
|
|
| Amazon CW 指标单元。 |
|
|
| Amazon CW 指标命名空间。 |
|
|
| Amazon CW 指标时间戳。 |
|
|
| Amazon CW 指标维度名称。 |
|
|
| Amazon CW 指标维度值。 |
|
|
| 维度名称和维度值的映射. |
2.5.3. 高级 CloudWatchClient 配置 复制链接链接已复制到粘贴板!
如果您需要对 CloudWatchClient 实例配置进行更多控制,您可以创建自己的实例并从 URI 引用它:
from("direct:start")
.to("aws2-cw://namespace?amazonCwClient=#client");
from("direct:start")
.to("aws2-cw://namespace?amazonCwClient=#client");
#client 指的是 Registry 中的一个 CloudWatchClient。
2.6. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-cw</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-cw</artifactId>
<version>${camel-version}</version>
</dependency>
其中 {camel-version} 必须替换为 Camel 的实际版本。
2.7. 例子 复制链接链接已复制到粘贴板!
2.7.1. 生成者示例 复制链接链接已复制到粘贴板!
from("direct:start")
.to("aws2-cw://http://camel.apache.org/aws-cw");
from("direct:start")
.to("aws2-cw://http://camel.apache.org/aws-cw");
发送类似内容
exchange.getIn().setHeader(Cw2Constants.METRIC_NAME, "ExchangesCompleted"); exchange.getIn().setHeader(Cw2Constants.METRIC_VALUE, "2.0"); exchange.getIn().setHeader(Cw2Constants.METRIC_UNIT, "Count");
exchange.getIn().setHeader(Cw2Constants.METRIC_NAME, "ExchangesCompleted");
exchange.getIn().setHeader(Cw2Constants.METRIC_VALUE, "2.0");
exchange.getIn().setHeader(Cw2Constants.METRIC_UNIT, "Count");
2.8. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-cw 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-cw-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-cw-starter</artifactId>
</dependency>
组件支持 19 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-cw.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-cw.amazon-cw-client | 将 AmazonCloudWatch 用作客户端。选项是一个 software.amazon.awssdk.services.cloudwatch.CloudWatchClient 类型。 | CloudWatchClient | |
| camel.component.aws2-cw.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-cw.configuration | 组件配置。选项是 org.apache.camel.component.aws2.cw.Cw2Configuration 类型。 | Cw2Configuration | |
| camel.component.aws2-cw.enabled | 是否启用 aws2-cw 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-cw.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-cw.name | 指标名称。 | 字符串 | |
| camel.component.aws2-cw.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-cw.proxy-host | 在实例化 CW 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-cw.proxy-port | 在实例化 CW 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-cw.proxy-protocol | 在实例化 CW 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-cw.region | CW 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| camel.component.aws2-cw.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-cw.timestamp | 指标时间戳。选项是一个 java.time.Instant 类型。 | instant | |
| camel.component.aws2-cw.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-cw.unit | 指标单元。 | 字符串 | |
| camel.component.aws2-cw.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-cw.use-default-credentials-provider | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| camel.component.aws2-cw.value | 指标值。 | å�Œ |
第 3 章 AWS DynamoDB 复制链接链接已复制到粘贴板!
仅支持生成者
AWS2 DynamoDB 组件支持从/向服务存储和检索数据。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并签名以使用 Amazon DynamoDB。如需更多信息,请参阅 Amazon DynamoDB。
3.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-ddb://domainName[?options]
aws2-ddb://domainName[?options]
您可以将查询选项附加到 URI 中,格式为 ?options=value&option2=value&…
3.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
3.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
3.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
3.3. 组件选项 复制链接链接已复制到粘贴板!
AWS DynamoDB 组件支持 22 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonDDBClient (producer) | Autowired 使用 AmazonDynamoDB 作为客户端。 | DynamoDbClient | |
| 配置 (生成者) | 组件配置。 | Ddb2Configuration | |
| consistentRead (producer) | 决定在读取数据时是否应强制执行强一致性。 | false | 布尔值 |
| enabledInitialDescribeTable (producer) | 设置 DDB 端点中是否必须完成的初始 Describe 表操作,还是不完成。 | true | 布尔值 |
| keyAttributeName (producer) | 创建表时的属性名称。 | 字符串 | |
| keyAttributeType (producer) | 创建表时的属性类型。 | 字符串 | |
| keyScalarType (producer) | key scalar 类型,可以是 S (字符串)、N (数字) 和 B (字节)。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 要执行的操作。 Enum 值:
| PutItem | Ddb2Operations |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (producer) | 在实例化 DDB 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | DynamoDB 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 整数 | |
| proxyProtocol (producer) | 在实例化 DDB 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| readCapacity (producer) | 要从您的表中读取资源的置备吞吐量。 | Long | |
| region (producer) | DDB 客户端需要工作的区域。 | 字符串 | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| writeCapacity (producer) | 为向表写入资源而保留置备的吞吐量。 | Long | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
3.4. 端点选项 复制链接链接已复制到粘贴板!
AWS DynamoDB 端点使用 URI 语法进行配置:
aws2-ddb:tableName
aws2-ddb:tableName
使用以下路径和查询参数:
3.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| tableName (producer) | 需要 当前有效的表的名称。 | 字符串 |
3.4.2. 查询参数 (20 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonDDBClient (producer) | Autowired 使用 AmazonDynamoDB 作为客户端。 | DynamoDbClient | |
| consistentRead (producer) | 决定在读取数据时是否应强制执行强一致性。 | false | 布尔值 |
| enabledInitialDescribeTable (producer) | 设置 DDB 端点中是否必须完成的初始 Describe 表操作,还是不完成。 | true | 布尔值 |
| keyAttributeName (producer) | 创建表时的属性名称。 | 字符串 | |
| keyAttributeType (producer) | 创建表时的属性类型。 | 字符串 | |
| keyScalarType (producer) | key scalar 类型,可以是 S (字符串)、N (数字) 和 B (字节)。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 要执行的操作。 Enum 值:
| PutItem | Ddb2Operations |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (producer) | 在实例化 DDB 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | DynamoDB 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 整数 | |
| proxyProtocol (producer) | 在实例化 DDB 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| readCapacity (producer) | 要从您的表中读取资源的置备吞吐量。 | Long | |
| region (producer) | DDB 客户端需要工作的区域。 | 字符串 | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| writeCapacity (producer) | 为向表写入资源而保留置备的吞吐量。 | Long | |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 DDB 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 amazonDDBClient,才能访问 Amazon 的 DynamoDB。
3.5. 使用方法 复制链接链接已复制到粘贴板!
3.5.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
3.5.2. 由 DDB producer 评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 表名称和对应项目的映射,由主密钥获取。 |
|
|
| 此操作的表名称。 |
|
|
| 唯一标识表中的每个项目的主要键。 |
|
|
| 如果您要在修改前或之后获取属性 name-value 对(NONE, ALL_OLD, UPDATED_OLD, ALL_NEW, UPDATED_NEW),则使用此参数。 |
|
|
| 为条件修改指定属性。 |
|
|
| 如果没有指定属性名称,则返回所有属性。 |
|
|
| 如果设置为 true,则会发出一致的读取,否则最终会使用一致性。 |
|
|
| 如果设置将用作查询操作的 Secondary Index。 |
|
|
| 项目的属性映射,必须包含定义项目的主要键值。 |
|
|
| 如果设置为 true,Amazon DynamoDB 会返回与查询参数匹配的项目总数,而不是匹配的项目及其属性的列表。 |
|
|
| 此标头指定查询的选择条件,并合并两个旧的标头 CamelAwsDdbHashKeyValue 和 CamelAwsDdbScanRangeKeyCondition |
|
|
| 项目的主密钥,以便从中继续之前的查询。 |
|
|
| 复合主密钥的 hash 组件的值。 |
|
|
| 要返回的项目的最大数量。 |
|
|
| 用于查询的属性值和比较运算符的容器。 |
|
|
| 指定索引的正向和反向遍历。 |
|
|
| 评估扫描结果,仅返回所需的值。 |
|
|
| 将属性名称映射到更新的新值和操作。 |
3.5.3. 在 BatchGetItems 操作过程中设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 表名称以及对应的项目属性。 |
|
|
| 包含表映射及其对应的键,这些键没有使用当前响应进行处理。 |
3.5.4. 在 DeleteItem 操作过程中设置消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
3.5.5. 在 DeleteTable 操作过程中设置消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
| ||
|
| 此表的 ProvisionedThroughput 属性的值 | |
|
|
| 此表的创建 DateTime。 |
|
|
| 此表的项目数。 |
|
|
| 标识此表的主键的 KeySchema。在 Camel 2.16.0 中,此标头的类型是 List<KeySchemaElement> 而不是 KeySchema |
|
|
| 表名称。 |
|
|
| 表大小(以字节为单位)。 |
|
|
| 表的状态:CREATING, UPDATING, DELETING, ACTIVE |
3.5.6. 在 DescribeTable 操作过程中设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
| \{{ProvisionedThroughputDescription}} | 此表的 ProvisionedThroughput 属性的值 |
|
|
| 此表的创建 DateTime。 |
|
|
| 此表的项目数。 |
|
| \{{KeySchema}} | 标识此表的主键的 KeySchema。 |
|
|
| 表名称。 |
|
|
| 表大小(以字节为单位)。 |
|
|
| 表的状态:CREATING, UPDATING, DELETING, ACTIVE |
|
|
| 此表的 ReadCapacityUnits 属性。 |
|
|
| 此表的 WriteCapacityUnits 属性。 |
3.5.7. 在 GetItem 操作过程中设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
3.5.8. 在 PutItem 操作过程中设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
3.5.9. 在 Query 操作过程中设置消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
|
|
| 查询操作停止的项目的主要键,其中包含上一个结果集。 |
|
|
| 操作期间消耗的表的置备吞吐量数。 |
|
|
| 响应中的项目数。 |
3.5.10. 扫描操作期间设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
|
|
| 查询操作停止的项目的主要键,其中包含上一个结果集。 |
|
|
| 操作期间消耗的表的置备吞吐量数。 |
|
|
| 响应中的项目数。 |
|
|
| 应用任何过滤器前,完成扫描中的项目数。 |
3.5.11. 在 UpdateItem 操作过程中设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 操作返回的属性列表。 |
3.5.12. 高级 AmazonDynamoDB 配置 复制链接链接已复制到粘贴板!
如果您需要对 AmazonDynamoDB 实例配置进行更多控制,您可以创建自己的实例并从 URI 引用它:
from("direct:start")
.to("aws2-ddb://domainName?amazonDDBClient=#client");
from("direct:start")
.to("aws2-ddb://domainName?amazonDDBClient=#client");
#client 指的是 Registry 中的 DynamoDbClient。
3.6. 支持的制作者操作 复制链接链接已复制到粘贴板!
- BatchGetItems
- DeleteItem
- DeleteTable
- DescribeTable
- GetItem
- PutItem
- 查询
- 扫描
- UpdateItem
- UpdateTable
3.7. 例子 复制链接链接已复制到粘贴板!
3.7.1. 生成者示例 复制链接链接已复制到粘贴板!
- PutItem:此操作将在 DynamoDB 中创建一个条目
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-ddb</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-ddb</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
3.8. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-ddb 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-ddb-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-ddb-starter</artifactId>
</dependency>
组件支持 40 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-ddb.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-ddb.amazon-d-d-b-client | 使用 AmazonDynamoDB 作为客户端。选项是一个 software.amazon.awssdk.services.dynamodb.DynamoDbClient 类型。 | DynamoDbClient | |
| camel.component.aws2-ddb.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-ddb.configuration | 组件配置。选项是 org.apache.camel.component.aws2.ddb.Ddb2Configuration 类型。 | Ddb2Configuration | |
| camel.component.aws2-ddb.consistent-read | 决定在读取数据时是否应强制执行强一致性。 | false | 布尔值 |
| camel.component.aws2-ddb.enabled | 是否启用 aws2-ddb 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-ddb.enabled-initial-describe-table | 设置 DDB 端点中是否必须完成的初始 Describe 表操作,还是不完成。 | true | 布尔值 |
| camel.component.aws2-ddb.key-attribute-name | 创建表时的属性名称。 | 字符串 | |
| camel.component.aws2-ddb.key-attribute-type | 创建表时的属性类型。 | 字符串 | |
| camel.component.aws2-ddb.key-scalar-type | key scalar 类型,可以是 S (字符串)、N (数字) 和 B (字节)。 | 字符串 | |
| camel.component.aws2-ddb.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-ddb.operation | 要执行的操作。 | Ddb2Operations | |
| camel.component.aws2-ddb.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-ddb.proxy-host | 在实例化 DDB 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-ddb.proxy-port | DynamoDB 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 整数 | |
| camel.component.aws2-ddb.proxy-protocol | 在实例化 DDB 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-ddb.read-capacity | 要从您的表中读取资源的置备吞吐量。 | Long | |
| camel.component.aws2-ddb.region | DDB 客户端需要工作的区域。 | 字符串 | |
| camel.component.aws2-ddb.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-ddb.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-ddb.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-ddb.use-default-credentials-provider | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| camel.component.aws2-ddb.write-capacity | 为向表写入资源而保留置备的吞吐量。 | Long | |
| camel.component.aws2-ddbstream.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-ddbstream.amazon-dynamo-db-streams-client | 用于此端点的所有请求的 Amazon DynamoDB 客户端。选项是一个 software.amazon.awssdk.services.dynamodb.streams.DynamoDbStreamsClient 类型。 | DynamoDbStreamsClient | |
| camel.component.aws2-ddbstream.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-ddbstream.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.aws2-ddbstream.configuration | 组件配置。选项是 org.apache.camel.component.aws2.ddbstream.Ddb2StreamConfiguration 类型。 | Ddb2StreamConfiguration | |
| camel.component.aws2-ddbstream.enabled | 是否启用 aws2-ddbstream 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-ddbstream.max-results-per-request | 每次轮询中将获取的最大记录数。 | 整数 | |
| camel.component.aws2-ddbstream.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-ddbstream.proxy-host | 在实例化 DDBStreams 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-ddbstream.proxy-port | 在实例化 DDBStreams 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-ddbstream.proxy-protocol | 在实例化 DDBStreams 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-ddbstream.region | DDBStreams 客户端需要工作的区域。 | 字符串 | |
| camel.component.aws2-ddbstream.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-ddbstream.stream-iterator-type | 定义 DynamoDB 流中开始获取记录的位置。请注意,使用 FROM_START 可能会导致流及时出现大量延迟。 | Ddb2StreamConfiguration$StreamIteratorType | |
| camel.component.aws2-ddbstream.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-ddbstream.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-ddbstream.use-default-credentials-provider | 设置 DynamoDB Streams 客户端是否应该预期通过默认凭据提供商加载凭据,或希望传递静态凭据。 | false | 布尔值 |
第 4 章 AWS Kinesis 复制链接链接已复制到粘贴板!
支持生成者和消费者
AWS2 Kinesis 组件支持接收来自 Amazon Kinesis (不支持 Batch)服务的信息。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并使用 Amazon Kinesis 注册。如需更多信息,请参阅 AWS Kinesis。
4.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-kinesis://stream-name[?options]
aws2-kinesis://stream-name[?options]
需要在使用前创建流。您可以将查询选项附加到 URI 中,格式为 ?options=value&option2=value&…
4.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
4.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
4.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
4.3. 组件选项 复制链接链接已复制到粘贴板!
AWS Kinesis 组件支持 22 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonKinesisClient (common) | Autowired Amazon Kinesis 客户端用于此端点的所有请求。 | KinesisClient | |
| cborEnabled (common) | 此选项将在执行期间设置 CBOR_ENABLED 属性。 | true | 布尔值 |
| configuration (common) | 组件配置. | Kinesis2Configuration | |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (common) | 在实例化 Kinesis 客户端时定义代理主机。 | 字符串 | |
| proxyPort (common) | 在实例化 Kinesis 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (common) | 在实例化 Kinesis 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (common) | Kinesis Firehose 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 Kinesis 客户端是否应该希望通过默认凭证提供程序加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| iteratorType (consumer) | 定义在 Kinesis 流中开始获取记录的位置。 Enum 值:
| TRIM_HORIZON | ShardIteratorType |
| maxResultsPerRequest (consumer) | 每次轮询中将获取的最大记录数。 | 1 | int |
| resumeStrategy (consumer) | 为 AWS Kinesis 定义恢复策略。如果提供,默认策略将读取 sequenceNumber。 | KinesisUserConfigurationResumeStrategy | KinesisResumeStrategy |
| sequenceNumber (consumer) | 开始轮询的序列号。如果 iteratorType 设置为 AFTER_SEQUENCE_NUMBER 或 AT_SEQUENCE_NUMBER,则需要此项。 | 字符串 | |
| shardClosed (consumer) | 定义在分片关闭时的行为是什么。可能的值有 ignore, silent 和 fail。如果忽略了消息,并且消费者将从开始重新启动,如果为 silent,则消费者将从开始记录。如果开始,消费者将引发故障关闭状态异常。 Enum 值:
| ignore | Kinesis2ShardClosedStrategyEnum |
| shardId (consumer) | 定义 Kinesis 流中要从哪些分片 ID 获取记录。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
4.4. 端点选项 复制链接链接已复制到粘贴板!
AWS Kinesis 端点使用 URI 语法进行配置:
aws2-kinesis:streamName
aws2-kinesis:streamName
使用以下路径和查询参数:
4.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| streamName (common) | 流必需的名称。 | 字符串 |
4.4.2. 查询参数 (38 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonKinesisClient (common) | Autowired Amazon Kinesis 客户端用于此端点的所有请求。 | KinesisClient | |
| cborEnabled (common) | 此选项将在执行期间设置 CBOR_ENABLED 属性。 | true | 布尔值 |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| proxyHost (common) | 在实例化 Kinesis 客户端时定义代理主机。 | 字符串 | |
| proxyPort (common) | 在实例化 Kinesis 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (common) | 在实例化 Kinesis 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (common) | Kinesis Firehose 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 Kinesis 客户端是否应该希望通过默认凭证提供程序加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| iteratorType (consumer) | 定义在 Kinesis 流中开始获取记录的位置。 Enum 值:
| TRIM_HORIZON | ShardIteratorType |
| maxResultsPerRequest (consumer) | 每次轮询中将获取的最大记录数。 | 1 | int |
| resumeStrategy (consumer) | 为 AWS Kinesis 定义恢复策略。如果提供,默认策略将读取 sequenceNumber。 | KinesisUserConfigurationResumeStrategy | KinesisResumeStrategy |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| sequenceNumber (consumer) | 开始轮询的序列号。如果 iteratorType 设置为 AFTER_SEQUENCE_NUMBER 或 AT_SEQUENCE_NUMBER,则需要此项。 | 字符串 | |
| shardClosed (consumer) | 定义在分片关闭时的行为是什么。可能的值有 ignore, silent 和 fail。如果忽略了消息,并且消费者将从开始重新启动,如果为 silent,则消费者将从开始记录。如果开始,消费者将引发故障关闭状态异常。 Enum 值:
| ignore | Kinesis2ShardClosedStrategyEnum |
| shardId (consumer) | 定义 Kinesis 流中要从哪些分片 ID 获取记录。 | 字符串 | |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 Kinesis 组件选项
您必须在 Registry 中提供 KinesisClient,并配置了代理和相关凭证。
4.5. Batch Consumer 复制链接链接已复制到粘贴板!
这个组件实现了 Batch Consumer。
这样,您可以让实例知道此批处理中存在多少个消息,而实例则让聚合器聚合此消息数量。
4.6. 使用方法 复制链接链接已复制到粘贴板!
4.6.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
4.6.2. 由 Kinesis consumer 设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 记录的序列号。这表示为一个字符串,因为它的大小不是由 API 定义。如果要将它用作数字类型,则使用 |
|
|
| 为记录的 arrival 时间分配的时间 AWS。 |
|
|
| 标识数据记录的流中分配给的分片。 |
4.6.3. AmazonKinesis 配置 复制链接链接已复制到粘贴板!
然后,您必须在 amazonKinesisClient URI 选项中引用 KinesisClientClient。
from("aws2-kinesis://mykinesisstream?amazonKinesisClient=#kinesisClient")
.to("log:out?showAll=true");
from("aws2-kinesis://mykinesisstream?amazonKinesisClient=#kinesisClient")
.to("log:out?showAll=true");
4.6.4. 提供 AWS 凭证 复制链接链接已复制到粘贴板!
建议您使用 DefaultAWSCredentialsProviderChain 获取凭证,这是创建新 ClientConfiguration 实例时的默认设置,但在调用 createClient (…)时可以指定不同的 AWSCredentialsProvider。
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 要传递给 Kinesis 来存储此记录的 PartitionKey。 |
|
|
| 可选参数以指示此记录的序列号。 |
4.6.6. 在记录成功存储时由 Kinesis producer 设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 记录的序列号,如 Response Syntax中定义的 |
|
|
| 存储记录的分片 ID |
4.7. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-kinesis</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-kinesis</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
4.8. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-kinesis 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-kinesis-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-kinesis-starter</artifactId>
</dependency>
组件支持 40 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-kinesis-firehose.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-kinesis-firehose.amazon-kinesis-firehose-client | Amazon Kinesis Firehose 客户端用于此端点的所有请求。选项是一个 software.amazon.awssdk.services.firehose.FirehoseClient 类型。 | FirehoseClient | |
| camel.component.aws2-kinesis-firehose.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-kinesis-firehose.cbor-enabled | 此选项将在执行期间设置 CBOR_ENABLED 属性。 | true | 布尔值 |
| camel.component.aws2-kinesis-firehose.configuration | 组件配置.选项是 org.apache.camel.component.aws2.firehose.KinesisFirehose2Configuration 类型。 | KinesisFirehose2Configuration | |
| camel.component.aws2-kinesis-firehose.enabled | 是否启用 aws2-kinesis-firehose 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-kinesis-firehose.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-kinesis-firehose.operation | 当用户不希望只发送记录时,要执行的操作。 | KinesisFirehose2Operations | |
| camel.component.aws2-kinesis-firehose.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-kinesis-firehose.proxy-host | 在实例化 Kinesis Firehose 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-kinesis-firehose.proxy-port | 在实例化 Kinesis Firehose 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-kinesis-firehose.proxy-protocol | 在实例化 Kinesis Firehose 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-kinesis-firehose.region | Kinesis Firehose 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| camel.component.aws2-kinesis-firehose.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-kinesis-firehose.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-kinesis-firehose.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-kinesis-firehose.use-default-credentials-provider | 设置 Kinesis Firehose 客户端是否应该通过默认凭据提供商加载凭据,还是希望传递静态凭据。 | false | 布尔值 |
| camel.component.aws2-kinesis.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-kinesis.amazon-kinesis-client | Amazon Kinesis 客户端用于此端点的所有请求。选项是一个 software.amazon.awssdk.services.kinesis.KinesisClient 类型。 | KinesisClient | |
| camel.component.aws2-kinesis.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-kinesis.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.aws2-kinesis.cbor-enabled | 此选项将在执行期间设置 CBOR_ENABLED 属性。 | true | 布尔值 |
| camel.component.aws2-kinesis.configuration | 组件配置.选项是 org.apache.camel.component.aws2.kinesis.Kinesis2Configuration 类型。 | Kinesis2Configuration | |
| camel.component.aws2-kinesis.enabled | 是否启用 aws2-kinesis 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-kinesis.iterator-type | 定义在 Kinesis 流中开始获取记录的位置。 | ShardIteratorType | |
| camel.component.aws2-kinesis.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-kinesis.max-results-per-request | 每次轮询中将获取的最大记录数。 | 1 | 整数 |
| camel.component.aws2-kinesis.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-kinesis.proxy-host | 在实例化 Kinesis 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-kinesis.proxy-port | 在实例化 Kinesis 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-kinesis.proxy-protocol | 在实例化 Kinesis 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-kinesis.region | Kinesis Firehose 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| camel.component.aws2-kinesis.resume-strategy | 为 AWS Kinesis 定义恢复策略。如果提供,默认策略将读取 sequenceNumber。选项是一个 org.apache.camel.component.aws2.kinesis.consumer.KinesisResumeStrategy 类型。 | KinesisResumeStrategy | |
| camel.component.aws2-kinesis.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-kinesis.sequence-number | 开始轮询的序列号。如果 iteratorType 设置为 AFTER_SEQUENCE_NUMBER 或 AT_SEQUENCE_NUMBER,则需要此项。 | 字符串 | |
| camel.component.aws2-kinesis.shard-closed | 定义在分片关闭时的行为是什么。可能的值有 ignore, silent 和 fail。如果忽略了消息,并且消费者将从开始重新启动,如果为 silent,则消费者将从开始记录。如果开始,消费者将引发故障关闭状态异常。 | Kinesis2ShardClosedStrategyEnum | |
| camel.component.aws2-kinesis.shard-id | 定义 Kinesis 流中要从哪些分片 ID 获取记录。 | 字符串 | |
| camel.component.aws2-kinesis.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-kinesis.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-kinesis.use-default-credentials-provider | 设置 Kinesis 客户端是否应该希望通过默认凭证提供程序加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
第 5 章 AWS 2 Lambda 复制链接链接已复制到粘贴板!
仅支持生成者
AWS2 Lambda 组件支持 create, get, list, delete 和 invoke AWS Lambda 函数。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并使用 Amazon Lambda 注册。如需更多信息,请参阅 AWS Lambda。
在创建 Lambda 功能时,您需要指定一个 IAM 角色,该角色至少附加了 AWSLambdaBasicExecuteRole 策略。
5.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-lambda://functionName[?options]
aws2-lambda://functionName[?options]
您可以将查询选项附加到 URI 中,格式为 options=value&option2=value&…
5.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
5.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
5.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
5.3. 组件选项 复制链接链接已复制到粘贴板!
AWS Lambda 组件支持 16 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| 配置 (生成者) | 组件配置. | Lambda2Configuration | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 要执行的操作。它可以是 listFunctions、getFunction、createFunction、deleteFunction 或 invokeFunction。 Enum 值:
| invokeFunction | Lambda2Operations |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| pojoRequest (producer) | 如果您想要将 POJO 请求用作正文。 | false | 布尔值 |
| region (producer) | Lambda 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 Lambda 客户端是否应该预期通过默认凭据提供商加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| awsLambdaClient (advanced) | Autowired 使用现有配置的 AwsLambdaClient 作为客户端。 | LambdaClient | |
| proxyHost (proxy) | 在实例化 Lambda 客户端时定义代理主机。 | 字符串 | |
| proxyPort (proxy) | 在实例化 Lambda 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (proxy) | 在实例化 Lambda 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
5.4. 端点选项 复制链接链接已复制到粘贴板!
AWS Lambda 端点使用 URI 语法进行配置:
aws2-lambda:function
aws2-lambda:function
使用以下路径和查询参数:
5.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| function (producer) | Lambda 函数必需的名称。 | 字符串 |
5.4.2. 查询参数 (14 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 要执行的操作。它可以是 listFunctions、getFunction、createFunction、deleteFunction 或 invokeFunction。 Enum 值:
| invokeFunction | Lambda2Operations |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| pojoRequest (producer) | 如果您想要将 POJO 请求用作正文。 | false | 布尔值 |
| region (producer) | Lambda 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 Lambda 客户端是否应该预期通过默认凭据提供商加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
| awsLambdaClient (advanced) | Autowired 使用现有配置的 AwsLambdaClient 作为客户端。 | LambdaClient | |
| proxyHost (proxy) | 在实例化 Lambda 客户端时定义代理主机。 | 字符串 | |
| proxyPort (proxy) | 在实例化 Lambda 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (proxy) | 在实例化 Lambda 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 Lambda 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 awsLambdaClient,以访问 Amazon Lambda 服务。
5.5. 使用方法 复制链接链接已复制到粘贴板!
5.5.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
5.5.2. 由 Lambda producer 评估的消息标头 复制链接链接已复制到粘贴板!
| 操作 | 标头 | 类型 | 描述 | 必填 |
|---|---|---|---|---|
| All |
|
| 我们要执行的操作。覆盖作为查询参数传递的操作 | 是 |
| createFunction |
|
| 存储包含部署软件包的 .zip 文件的 Amazon S3 bucket 名称。此存储桶必须位于您要创建 Lambda 功能的同一 AWS 区域。 | 否 |
| createFunction |
|
| 要上传的 Amazon S3 对象(部署软件包)密钥名称。 | 否 |
| createFunction |
| 字符串 | 要上传的 Amazon S3 对象(部署软件包)版本。 | 否 |
| createFunction |
|
| zip 文件的本地路径(部署软件包)。zip 文件的内容也可以放在消息正文中。 | 否 |
| createFunction |
|
| 当执行您的功能来访问任何其他 Amazon Web Services (AWS)资源时,Larmbda 假定 IAM 角色的 Amazon Resource Name (ARN)。 | 是 |
| createFunction |
| 字符串 | 您上传的 Lambda 功能的运行时环境。(nodejs, nodejs4.3, nodejs6.10, java8, python2.7, python3.6, dotnetcore1.0, odejs4.3-edge) | 是 |
| createFunction |
|
| Lambda 调用的代码中的功能,开始执行。对于 Node.js,它是您的函数中的 module-name.export 值。对于 Java,它可以是 package.class-name::handler 或 package.class-name。 | 是 |
| createFunction |
|
| 用户提供的描述。 | 否 |
| createFunction |
|
| 包含 Amazon SQS 队列或 Amazon SNS 主题的目标 ARN (Amazon Resource Name) 的父对象。 | 否 |
| createFunction |
|
| 为该功能配置的内存大小(以 MB 为单位)。必须是 64 MB 的倍数。 | 否 |
| createFunction |
|
| 用于加密功能环境变量的 KMS 密钥的 Amazon 资源名称(ARN)。如果没有提供,AWS Lambda 将使用默认服务密钥。 | 否 |
| createFunction |
|
| 此布尔值参数可用于请求 AWS Lambda 来创建 Lambda 功能,并将版本作为原子操作发布。 | 否 |
| createFunction |
|
| Lambda 应该终止函数的功能执行时间。默认值为 3 秒。 | 否 |
| createFunction |
|
| 您功能的追踪设置(活跃或传递)。 | 否 |
| createFunction |
|
| 代表您的环境配置设置的键值对。 | 否 |
| createFunction |
|
| 分配给新功能的标签(键值对)列表。 | 否 |
| createFunction |
|
| 如果您的 Lambda 功能访问 VPC 中的资源,则 VPC 中的一个或多个安全组 ID 列表。 | 否 |
| createFunction |
|
| 如果您的 Lambda 功能访问 VPC 中的资源,则 VPC 中的一个或多个子网 ID 列表。 | 否 |
| createAlias |
|
| 在别名中设置的功能版本 | 是 |
| createAlias |
|
| 在别名中设置的函数名称 | 是 |
| createAlias |
|
| 在别名中设置的函数描述 | 否 |
| deleteAlias |
|
| 别名的功能名称 | 是 |
| getAlias |
|
| 别名的功能名称 | 是 |
| listAliases |
|
| 在别名中设置的功能版本 | 否 |
5.6. 可运行的操作列表 复制链接链接已复制到粘贴板!
- listFunctions
- getFunction
- createFunction
- deleteFunction
- invokeFunction
- updateFunction
- createEventSourceMapping
- deleteEventSourceMapping
- listEventSourceMapping
- listTags
- tagResource
- untagResource
- publishVersion
- listVersions
- createAlias
- deleteAlias
- getAlias
- listAliases
5.7. 例子 复制链接链接已复制到粘贴板!
5.7.1. 生成者示例 复制链接链接已复制到粘贴板!
要完全了解组件的工作方式,您可以参阅这些 集成测试。
5.7.2. 生成者示例 复制链接链接已复制到粘贴板!
- CreateFunction:此操作将在 AWS Lambda 中为您创建一个功能
from("direct:createFunction").to("aws2-lambda://GetHelloWithName?operation=createFunction").to("mock:result");
from("direct:createFunction").to("aws2-lambda://GetHelloWithName?operation=createFunction").to("mock:result");
并通过发送
5.8. 使用 POJO 作为正文 复制链接链接已复制到粘贴板!
由于多个选项,有时构建 AWS Request 可能会很复杂。我们介绍可能将 POJO 用作正文。在 AWS Lambda 中,您可以提交多个操作,如 Get Function 请求,您可以执行以下操作:
from("direct:getFunction")
.setBody(GetFunctionRequest.builder().functionName("test").build())
.to("aws2-lambda://GetHelloWithName?awsLambdaClient=#awsLambdaClient&operation=getFunction&pojoRequest=true")
from("direct:getFunction")
.setBody(GetFunctionRequest.builder().functionName("test").build())
.to("aws2-lambda://GetHelloWithName?awsLambdaClient=#awsLambdaClient&operation=getFunction&pojoRequest=true")
这样,您将直接传递请求,而无需专门传递与此操作相关的标头和选项。
5.9. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-lambda</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-lambda</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
5.10. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-lambda 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-lambda-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-lambda-starter</artifactId>
</dependency>
组件支持 17 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-lambda.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-lambda.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-lambda.aws-lambda-client | 使用现有配置的 AwsLambdaClient 作为客户端。选项是一个 software.amazon.awssdk.services.lambda.LambdaClient 类型。 | LambdaClient | |
| camel.component.aws2-lambda.configuration | 组件配置.选项是 org.apache.camel.component.aws2.lambda.Lambda2Configuration 类型。 | Lambda2Configuration | |
| camel.component.aws2-lambda.enabled | 是否启用 aws2-lambda 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-lambda.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-lambda.operation | 要执行的操作。它可以是 listFunctions、getFunction、createFunction、deleteFunction 或 invokeFunction。 | Lambda2Operations | |
| camel.component.aws2-lambda.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-lambda.pojo-request | 如果您想要将 POJO 请求用作正文。 | false | 布尔值 |
| camel.component.aws2-lambda.proxy-host | 在实例化 Lambda 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-lambda.proxy-port | 在实例化 Lambda 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-lambda.proxy-protocol | 在实例化 Lambda 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-lambda.region | Lambda 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| camel.component.aws2-lambda.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-lambda.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-lambda.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-lambda.use-default-credentials-provider | 设置 Lambda 客户端是否应该预期通过默认凭据提供商加载凭证,或者希望传递静态凭证。 | false | 布尔值 |
第 6 章 AWS S3 Storage Service 复制链接链接已复制到粘贴板!
支持生成者和消费者
AWS2 S3 组件支持从/到 Amazon 的 S3 服务存储和检索对象。
先决条件
您必须拥有有效的 Amazon Web Services 开发人员帐户,并有权限使用 Amazon S3。如需更多信息,请访问 link:https://aws.amazon.com/s3 [Amazon S3]。
6.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-s3://bucketNameOrArn[?options]
aws2-s3://bucketNameOrArn[?options]
如果存储桶不存在,则会创建存储桶。您可以以以下格式将查询选项附加到 URI 中,
options=value&option2=value&…
6.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
6.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
6.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
6.3. 组件选项 复制链接链接已复制到粘贴板!
AWS S3 Storage Service 组件支持 50 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonS3Client (common) | 对 registry 中的 com.amazonaws.services.s3.AmazonS3 的 Autowired Reference。 | S3Client | |
| amazonS3Presigner (common) | Autowired 一个用于请求的 S3 Presigner,主要在 createDownloadLink 操作中使用。 | S3Presigner | |
| autoCreateBucket (common) | 设置 S3 存储桶自动创建的 bucketName。如果启用了 moveAfterRead 选项,则也会应用它,如果尚未存在 moveAfterRead 选项,它将创建 destinationBucket。 | false | 布尔值 |
| configuration (common) | 组件配置。 | AWS2S3Configuration | |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| pojoRequest (common) | 如果您想要将 POJO 请求用作正文。 | false | 布尔值 |
| policy (common) | 此队列的策略在 com.amazonaws.services.s3.AmazonS3#setBucketPolicy() 方法中设置。 | 字符串 | |
| proxyHost (common) | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (common) | 指定要在客户端定义中使用的代理端口。 | 整数 | |
| proxyProtocol (common) | 在实例化 S3 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (common) | S3 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| customerAlgorithm (common (advanced)) | 定义在启用了 CustomerKey 时要使用的客户算法。 | 字符串 | |
| customerKeyId (common (advanced)) | 定义在启用 CustomerKey 时要使用的 Customer key 的 id。 | 字符串 | |
| customerKeyMD5 (common (advanced)) | 定义在启用 CustomerKey 时要使用的客户密钥的 MD5。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| deleteAfterRead (consumer) | 在检索后,从 S3 删除对象。只有在提交 Exchange 时,才会执行删除。如果进行回滚,则对象不会被删除。如果此选项为 false,则同一对象将被通过并再次在轮询上检索。因此,您需要使用路由中的 Idempotent Consumer EIP 来过滤重复项。您可以使用 AWS2S3Constants#BUCKET_NAME 和 AWS2S3Constants#KEY 标头过滤,或者只过滤 AWS2S3Constants#KEY 标头。 | true | 布尔值 |
| delimiter (consumer) | com.amazonaws.services.s3.model.ListObjectsRequest 中使用的分隔符仅消耗我们感兴趣的对象。 | 字符串 | |
| destinationBucket (consumer) | 定义当 moveAfterRead 设置为 true 时必须移动对象的目标存储桶。 | 字符串 | |
| destinationBucketPrefix (consumer) | 定义在必须移动对象并将 moveAfterRead 设置为 true 时使用的目标存储桶前缀。 | 字符串 | |
| destinationBucketSuffix (consumer) | 定义在必须移动对象并将 moveAfterRead 设置为 true 时使用的目标存储桶后缀。 | 字符串 | |
| doneFileName (consumer) | 如果提供,Camel 仅在文件存在时使用文件。 | 字符串 | |
| fileName (consumer) | 要从具有给定文件名的存储桶获取对象。 | 字符串 | |
| ignoreBody (consumer) | 如果为 true,则 S3 对象正文将完全忽略,如果设为 false,则 S3 对象将放入正文中。把它设置为 true,将覆盖 includeBody 选项定义的任何行为。 | false | 布尔值 |
| includeBody (consumer) | 如果为 true,则 S3Object Exchange 将被使用并放入正文和关闭中。如果为 false,S3Object 流将原始放在正文中,标头将使用 S3 对象元数据设置。这个选项与 autocloseBody 选项密切相关。如果将 includeBody 设为 true,因为 S3Object 流将被消耗,然后也会关闭它,而在 includeBody false 时,它将是关闭 S3Object 流的调用者。但是,当 includeBody 为 false 时,将 autocloseBody 设置为 true,它将在交换完成时自动关闭 S3Object 流。 | true | 布尔值 |
| includeFolders (consumer) | 如果为 true,将消费的文件夹/目录。如果是 false,则忽略它们,且不会为那些交换创建。 | true | 布尔值 |
| moveAfterRead (consumer) | 在检索后,将对象从 S3 存储桶移到不同的存储桶。要完成操作,必须设置 destinationBucket 选项。仅当 Exchange 提交时,才会执行复制存储桶操作。如果进行回滚,则对象不会被移动。 | false | 布尔值 |
| prefix (consumer) | com.amazonaws.services.s3.model.ListObjectsRequest 中使用的前缀,仅用于消费我们感兴趣的对象。 | 字符串 | |
| autocloseBody (consumer (advanced)) | 如果此选项为 true,且 includeBody 为 false,则在交换完成时调用 S3Object.close() 方法。此选项与 includeBody 选项密切相关。如果将 includeBody 设为 false,autocloseBody 设为 false,它将是关闭 S3Object 流的调用者。将 autocloseBody 设置为 true,将自动关闭 S3Object 流。 | true | 布尔值 |
| batchMessageNumber (producer) | 在流传输上传模式中制作批处理的消息数量。 | 10 | int |
| batchSize (producer) | 流上传模式的批处理大小(以字节为单位)。 | 1000000 | int |
| deleteAfterWrite (producer) | 在 S3 文件上传后删除文件对象。 | false | 布尔值 |
| KeyName (producer) | 通过端点参数在存储桶中设置元素的密钥名称。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| multiPartUpload (producer) | 如果为 true,则 camel 将上传带有多部分格式的文件,由 partSize 选项决定部分大小。 | false | 布尔值 |
| namingStrategy (producer) | 在流上传模式中使用的命名策略。 Enum 值:
| progressive | AWSS3NamingStrategyEnum |
| operation (producer) | 当用户不希望只进行上传时,要执行的操作。 Enum 值:
| AWS2S3Operations | |
| partSize (producer) | 设置多部分上传中使用的 partSize,默认大小为 25M。 | 26214400 | long |
| restartingPolicy (producer) | 在流上传模式中使用的重启策略。 Enum 值:
| override | AWSS3RestartingPolicyEnum |
| storageClass (producer) | 在 com.amazonaws.services.s3.model.PutObjectRequest 请求中设置的存储类。 | 字符串 | |
| streamingUploadMode (producer) | 当流模式为 true 时,上传到存储桶将以流传输方式进行。 | false | 布尔值 |
| streamingUploadTimeout (producer) | 在流上传模式为 true 时,此选项会将超时设置为完成上传。 | long | |
| awsKMSKeyId (producer (advanced)) | 定义在启用 KMS 时要使用的 KMS 密钥 ID。 | 字符串 | |
| useAwsKMS (producer (advanced)) | 定义是否必须使用 KMS。 | false | 布尔值 |
| useCustomerKey (producer (advanced)) | 定义是否需要使用客户密钥。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
6.4. 端点选项 复制链接链接已复制到粘贴板!
AWS S3 Storage Service 端点使用 URI 语法进行配置:
aws2-s3://bucketNameOrArn
aws2-s3://bucketNameOrArn
使用以下路径和查询参数:
6.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bucketNameOrArn (common) | 所需的 Bucket 名称或 ARN。 | 字符串 |
6.4.2. 查询参数 (68 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonS3Client (common) | 对 registry 中的 com.amazonaws.services.s3.AmazonS3 的 Autowired Reference。 | S3Client | |
| amazonS3Presigner (common) | Autowired 一个用于请求的 S3 Presigner,主要在 createDownloadLink 操作中使用。 | S3Presigner | |
| autoCreateBucket (common) | 设置 S3 存储桶自动创建的 bucketName。如果启用了 moveAfterRead 选项,则也会应用它,如果尚未存在 moveAfterRead 选项,它将创建 destinationBucket。 | false | 布尔值 |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| pojoRequest (common) | 如果您想要将 POJO 请求用作正文。 | false | 布尔值 |
| policy (common) | 此队列的策略在 com.amazonaws.services.s3.AmazonS3#setBucketPolicy() 方法中设置。 | 字符串 | |
| proxyHost (common) | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (common) | 指定要在客户端定义中使用的代理端口。 | 整数 | |
| proxyProtocol (common) | 在实例化 S3 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| region (common) | S3 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 S3 客户端是否应该希望通过默认凭据提供程序加载凭据,或者希望传递静态凭据。 | false | 布尔值 |
| customerAlgorithm (common (advanced)) | 定义在启用了 CustomerKey 时要使用的客户算法。 | 字符串 | |
| customerKeyId (common (advanced)) | 定义在启用 CustomerKey 时要使用的 Customer key 的 id。 | 字符串 | |
| customerKeyMD5 (common (advanced)) | 定义在启用 CustomerKey 时要使用的客户密钥的 MD5。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| deleteAfterRead (consumer) | 在检索后,从 S3 删除对象。只有在提交 Exchange 时,才会执行删除。如果进行回滚,则对象不会被删除。如果此选项为 false,则同一对象将被通过并再次在轮询上检索。因此,您需要使用路由中的 Idempotent Consumer EIP 来过滤重复项。您可以使用 AWS2S3Constants#BUCKET_NAME 和 AWS2S3Constants#KEY 标头过滤,或者只过滤 AWS2S3Constants#KEY 标头。 | true | 布尔值 |
| delimiter (consumer) | com.amazonaws.services.s3.model.ListObjectsRequest 中使用的分隔符仅消耗我们感兴趣的对象。 | 字符串 | |
| destinationBucket (consumer) | 定义当 moveAfterRead 设置为 true 时必须移动对象的目标存储桶。 | 字符串 | |
| destinationBucketPrefix (consumer) | 定义在必须移动对象并将 moveAfterRead 设置为 true 时使用的目标存储桶前缀。 | 字符串 | |
| destinationBucketSuffix (consumer) | 定义在必须移动对象并将 moveAfterRead 设置为 true 时使用的目标存储桶后缀。 | 字符串 | |
| doneFileName (consumer) | 如果提供,Camel 仅在文件存在时使用文件。 | 字符串 | |
| fileName (consumer) | 要从具有给定文件名的存储桶获取对象。 | 字符串 | |
| ignoreBody (consumer) | 如果为 true,则 S3 对象正文将完全忽略,如果设为 false,则 S3 对象将放入正文中。把它设置为 true,将覆盖 includeBody 选项定义的任何行为。 | false | 布尔值 |
| includeBody (consumer) | 如果为 true,则 S3Object Exchange 将被使用并放入正文和关闭中。如果为 false,S3Object 流将原始放在正文中,标头将使用 S3 对象元数据设置。这个选项与 autocloseBody 选项密切相关。如果将 includeBody 设为 true,因为 S3Object 流将被消耗,然后也会关闭它,而在 includeBody false 时,它将是关闭 S3Object 流的调用者。但是,当 includeBody 为 false 时,将 autocloseBody 设置为 true,它将在交换完成时自动关闭 S3Object 流。 | true | 布尔值 |
| includeFolders (consumer) | 如果为 true,将消费的文件夹/目录。如果是 false,则忽略它们,且不会为那些交换创建。 | true | 布尔值 |
| maxConnections (consumer) | 在 S3 客户端配置中设置 maxConnections 参数。 | 60 | int |
| maxMessagesPerPoll (consumer) | 获取最大消息数,作为每次轮询轮询的限制。获取最大消息数,作为每次轮询轮询的限制。默认值为 10。使用 0 或负数设置为无限。 | 10 | int |
| moveAfterRead (consumer) | 在检索后,将对象从 S3 存储桶移到不同的存储桶。要完成操作,必须设置 destinationBucket 选项。仅当 Exchange 提交时,才会执行复制存储桶操作。如果进行回滚,则对象不会被移动。 | false | 布尔值 |
| prefix (consumer) | com.amazonaws.services.s3.model.ListObjectsRequest 中使用的前缀,仅用于消费我们感兴趣的对象。 | 字符串 | |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| autocloseBody (consumer (advanced)) | 如果此选项为 true,且 includeBody 为 false,则在交换完成时调用 S3Object.close() 方法。此选项与 includeBody 选项密切相关。如果将 includeBody 设为 false,autocloseBody 设为 false,它将是关闭 S3Object 流的调用者。将 autocloseBody 设置为 true,将自动关闭 S3Object 流。 | true | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| batchMessageNumber (producer) | 在流传输上传模式中制作批处理的消息数量。 | 10 | int |
| batchSize (producer) | 流上传模式的批处理大小(以字节为单位)。 | 1000000 | int |
| deleteAfterWrite (producer) | 在 S3 文件上传后删除文件对象。 | false | 布尔值 |
| KeyName (producer) | 通过端点参数在存储桶中设置元素的密钥名称。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| multiPartUpload (producer) | 如果为 true,则 camel 将上传带有多部分格式的文件,由 partSize 选项决定部分大小。 | false | 布尔值 |
| namingStrategy (producer) | 在流上传模式中使用的命名策略。 Enum 值:
| progressive | AWSS3NamingStrategyEnum |
| operation (producer) | 当用户不希望只进行上传时,要执行的操作。 Enum 值:
| AWS2S3Operations | |
| partSize (producer) | 设置多部分上传中使用的 partSize,默认大小为 25M。 | 26214400 | long |
| restartingPolicy (producer) | 在流上传模式中使用的重启策略。 Enum 值:
| override | AWSS3RestartingPolicyEnum |
| storageClass (producer) | 在 com.amazonaws.services.s3.model.PutObjectRequest 请求中设置的存储类。 | 字符串 | |
| streamingUploadMode (producer) | 当流模式为 true 时,上传到存储桶将以流传输方式进行。 | false | 布尔值 |
| streamingUploadTimeout (producer) | 在流上传模式为 true 时,此选项会将超时设置为完成上传。 | long | |
| awsKMSKeyId (producer (advanced)) | 定义在启用 KMS 时要使用的 KMS 密钥 ID。 | 字符串 | |
| useAwsKMS (producer (advanced)) | 定义是否必须使用 KMS。 | false | 布尔值 |
| useCustomerKey (producer (advanced)) | 定义是否需要使用客户密钥。 | false | 布尔值 |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 S3 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 amazonS3Client,才能访问 Amazon 的 S3。
6.5. Batch Consumer 复制链接链接已复制到粘贴板!
这个组件实现了 Batch Consumer。
这样,您可以让实例知道此批处理中存在多少个消息,而实例则让聚合器聚合此消息数量。
6.6. 使用方法 复制链接链接已复制到粘贴板!
例如,要从存储桶 helloBucket 读取文件 hello.txt,请使用以下片断:
from("aws2-s3://helloBucket?accessKey=yourAccessKey&secretKey=yourSecretKey&prefix=hello.txt")
.to("file:/var/downloaded");
from("aws2-s3://helloBucket?accessKey=yourAccessKey&secretKey=yourSecretKey&prefix=hello.txt")
.to("file:/var/downloaded");
6.6.1. S3 producer 评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 此对象的 bucket 名称将存储或用于当前操作 |
|
|
| 用于当前操作的存储桶目标名称 |
|
|
| 此对象的内容长度。 |
|
|
| 此对象的内容类型。 |
|
|
| 此对象的内容控制。 |
|
|
| 此对象的内容分布。 |
|
|
| 此对象的内容编码。 |
|
|
| 此对象的 md5 checksum。 |
|
|
| 用于当前操作的 Destination 键 |
|
|
| 此对象将存储或用于当前操作的密钥 |
|
|
| 此对象的最后修改的时间戳。 |
|
|
| 要执行的操作。允许的值有 copyObject, deleteObject, listBuckets, deleteBucket, listObjects |
|
|
| 此对象的存储类。 |
|
|
|
将应用于对象的 canned acl。请参阅 |
|
|
|
一个精心构建的 Amazon S3 Access Control List 对象。请参阅 |
|
| 字符串 | 在使用 AWS 管理的密钥加密对象时设置服务器端加密算法。例如,使用 AES256。 |
|
|
| 要存储或从当前操作返回的对象的版本 Id |
|
|
| 要与 S3 中对象存储的元数据映射。有关元数据的更多详细信息。 |
6.6.2. S3 producer 设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 新上传对象的 ETag 值。 |
|
|
| 新上传对象的可选版本 ID。 |
6.6.3. S3 使用者设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 存储此对象的密钥。 |
|
|
| 包含此对象的存储桶的名称。 |
|
|
| 根据 RFC 1864,对相关对象的十六进制编码的 128 位 MD5 摘要。此数据用作完整性检查,以验证调用者收到的数据是否与 Amazon S3 发送的数据相同。 |
|
|
| Last-Modified 标头的值,指示 Amazon S3 最后记录对关联对象的修改的日期和时间。 |
|
|
| 关联的 Amazon S3 对象的版本 ID (如果可用)。只有当对象上传到启用了对象版本控制的 Amazon S3 存储桶时,才会将版本 ID 分配给对象。 |
|
|
| Content-Type HTTP 标头,它表示存储在关联对象中的内容类型。此标头的值是标准 MIME 类型。 |
|
|
| 根据 RFC 1864,使用 base64 编码的相关对象(content - 不包括标头)的 base64 编码的 128 位 MD5 摘要。此数据用作消息完整性检查,以验证 Amazon S3 收到的数据是否与调用者发送的数据相同。 |
|
|
| Content-Length HTTP 标头表示关联对象的大小(以字节为单位)。 |
|
|
| 可选的 Content-Encoding HTTP 标头指定将什么内容编码应用到对象,必须应用哪些解码机制来获取 Content-Type 字段引用的 media-type。 |
|
|
| 可选的 Content-Disposition HTTP 标头,它指定要保存的对象的建议文件名等。 |
|
|
| 可选的 Cache-Control HTTP 标头,允许用户在 HTTP 请求/恢复链中指定缓存行为。 |
|
| 字符串 | 使用 AWS 管理的密钥加密对象时的服务器端加密算法。 |
|
|
| 与 S3 中对象存储的元数据映射。有关元数据的更多详细信息。 |
6.6.4. S3 Producer 操作 复制链接链接已复制到粘贴板!
Camel-AWS2-S3 组件在生成者端提供以下操作:
- copyObject
- deleteObject
- listBuckets
- deleteBucket
- listObjects
- GetObject (这将返回 S3Object 实例)
- getObjectRange (这将返回 S3Object 实例)
- createDownloadLink
如果您没有显式指定生成者将执行的操作: - 单个文件上传 - 如果启用了 multiPartUpload 选项,则多部分上传。
6.6.5. 高级 AmazonS3 配置 复制链接链接已复制到粘贴板!
如果您的 Camel 应用程序在防火墙后面运行,或者需要对 S3Client 实例配置拥有更多控制,您可以创建自己的实例,并在 Camel aws2-s3 组件配置中引用它:
from("aws2-s3://MyBucket?amazonS3Client=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
from("aws2-s3://MyBucket?amazonS3Client=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
6.6.6. 将 KMS 与 S3 组件一起使用 复制链接链接已复制到粘贴板!
要使用 AWS KMS 加密/解密数据,您可以使用 2.21.x 中引入的选项,如下例所示
from("file:tmp/test?fileName=test.txt")
.setHeader(S3Constants.KEY, constant("testFile"))
.to("aws2-s3://mybucket?amazonS3Client=#client&useAwsKMS=true&awsKMSKeyId=3f0637ad-296a-3dfe-a796-e60654fb128c");
from("file:tmp/test?fileName=test.txt")
.setHeader(S3Constants.KEY, constant("testFile"))
.to("aws2-s3://mybucket?amazonS3Client=#client&useAwsKMS=true&awsKMSKeyId=3f0637ad-296a-3dfe-a796-e60654fb128c");
这样,您将要求 S3 使用 KMS 密钥 3f0637ad-296a-3dfe-a796-e60654fb128c 来加密文件 test.txt。当您要求下载该文件时,将在下载前直接进行解密。
6.6.7. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
6.6.8. S3 Producer 操作示例 复制链接链接已复制到粘贴板!
- 单上传:此操作将根据正文内容上传文件到 S3
此操作将上传文件 camel.txt,其内容为 mycamelbucket bucket 中的内容 "Camel rocks!"
- 多部分上传:此操作将根据正文内容执行文件的多部分上传到 S3
此操作将执行文件 empty.txt 的多部分上传,它基于 mycamelbucket bucket 中文件 src/empty.txt 的内容
- CopyObject:此操作将对象从一个存储桶复制到不同的存储桶
此操作会将带有标头 camelDestinationKey 中的名称的对象复制到 Bucket mycamelbucket 中的 camelDestinationBucket 存储桶。
- DeleteObject:此操作从存储桶中删除对象
此操作将从 bucket mycamelbucket 中删除对象 camelKey。
- ListBuckets:此操作列出了此区域中此帐户的存储桶
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listBuckets")
.to("mock:result");
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listBuckets")
.to("mock:result");
此操作将列出此帐户的存储桶
- DeleteBucket:此操作删除指定为 URI 参数或标头的存储桶
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=deleteBucket")
.to("mock:result");
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=deleteBucket")
.to("mock:result");
此操作将删除存储桶 mycamelbucket
- ListObjects :此操作列表在特定存储桶中的对象
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listObjects")
.to("mock:result");
from("direct:start")
.to("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&operation=listObjects")
.to("mock:result");
此操作将列出 mycamelbucket bucket 中的对象
- GetObject:此操作获取特定存储桶中的单个对象
此操作将返回与 mycamelbucket bucket 中 camelKey 对象相关的 S3Object 实例。
- GetObjectRange:此操作获得特定存储桶中的单个对象范围
此操作将返回与 mycamelbucket bucket 中 camelKey 对象相关的 S3Object 实例,其中包含从 0 到 9 的字节数。
- CreateDownloadLink:此操作将通过 S3 Presigner 返回下载链接
此操作将返回存储桶 mycamelbucket 和 region 区域中的 camel-key 文件的下载链接 url
6.7. 流上传模式 复制链接链接已复制到粘贴板!
启用流模式后,用户可以通过多部分上传将数据上传到 S3,而无需提前了解数据维度的时间。上传将在完成后完成: batchSize 已完成,或者达到 batchMessageNumber。有两个可能的命名策略:
progressive
使用 progressive 策略,每个文件的名称都由 keyName 选项和一个 progressive 计数器组成,最终文件扩展名(若有)
random。
使用随机策略时,将在 keyName 后添加 UUID,最终会附加文件扩展名。
例如:
批处理的默认大小为 1 Mb,但您可以根据您的要求进行调整。
当您停止生成者路由时,生成者将负责刷新剩余的缓冲消息,并完成上传。
在流上传中,您将能够从离开的时间点重新启动生成者。务必要注意,只有在使用进度命名策略时,此功能才至关重要。
通过将 restartPolicy 设置为 lastPart,您将重启从制作者左侧最后一个部分编号上传文件和内容。
示例
- 使用 progressive naming strategy 和 keyname 等于 camel.txt 来启动路由,batchMessageNumber 等于 20,restartPolicy 等于 lastPart - Send 70 消息。
- 停止路由
在您的 S3 存储桶中,您现在应该看到 4 个文件:* camel.txt
- camel-1.txt
- camel-2.txt
camel-3.txt
前三个消息将有 20 个消息,而最后一个消息仅有 10 个。
- 重新启动路由。
- 发送 25 个消息。
- 停止路由。
- 您的存储桶中现在有 2 个其他文件: camel-5.txt 和 camel-6.txt,第一个带有 20 个消息,第二个文件为 5 个信息。
- 继续
使用随机命名策略时不需要这样做。
相反,您可以指定覆盖重启策略。在这种情况下,您可以覆盖您在存储桶上之前(用于该特定 keyName)写入的任何内容。
在流上传模式中,将考虑的唯一 keyName 选项是端点选项。使用标头将抛出 NPE,这由设计完成。设置标头意味着可能会更改每个交换上的文件名,这针对流上传制作者的动画。keyName 需要修复和静态。所选命名策略将执行其余工作。
另一个可能是使用 batchMessageNumber 和 batchSize 选项指定 streamingUploadTimeout。使用此选项时,用户可以在特定时间通过后完成文件上传。这样,上传完成将在三个层上传递:超时、消息数和批处理大小。
例如:
from(kafka("topic1").brokers("localhost:9092"))
.log("Kafka Message is: ${body}")
.to(aws2S3("camel-bucket").streamingUploadMode(true).batchMessageNumber(25).streamingUploadTimeout(10000).namingStrategy(AWS2S3EndpointBuilderFactory.AWSS3NamingStrategyEnum.progressive).keyName("{{kafkaTopic1}}/{{kafkaTopic1}}.txt"));
from(kafka("topic1").brokers("localhost:9092"))
.log("Kafka Message is: ${body}")
.to(aws2S3("camel-bucket").streamingUploadMode(true).batchMessageNumber(25).streamingUploadTimeout(10000).namingStrategy(AWS2S3EndpointBuilderFactory.AWSS3NamingStrategyEnum.progressive).keyName("{{kafkaTopic1}}/{{kafkaTopic1}}.txt"));
在这种情况下,上传将在 10 秒后完成。
6.8. bucket 自动创建 复制链接链接已复制到粘贴板!
使用选项 autoCreateBucket 用户可以在 S3 Bucket 不存在时避免自动创建。此选项的默认值是 true。如果设置为 false 对 AWS 中不存在的存储桶的操作,则不会成功,并返回错误。
6.9. 在存储桶和其他存储桶间移动操作 复制链接链接已复制到粘贴板!
有些用户(如从存储桶中消耗大量),并在不同的中移动内容,而无需使用这个组件的 copyObject 功能。如果是这样,请不要忘记从消费者的传入交换中删除 bucketName 标头,否则该文件将始终覆盖同一原始存储桶。
6.10. MoveAfterRead consumer 选项 复制链接链接已复制到粘贴板!
除了 deleteAfterRead 外,还添加了另一个选项 moveAfterRead。启用此选项后,消耗的对象将移到目标 destinationBucket 中,而不是只被删除。这将需要指定 destinationBucket 选项。例如:
from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket")
.to("mock:result");
from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket")
.to("mock:result");
在这种情况下,消耗的对象将移到 myothercamelbucket bucket,并从原始存储桶中删除(因为 deleteAfterRead 设置为 true )。
您还可以在将文件移动到其他存储桶时使用密钥前缀/suffix。这些选项是 destinationBucketPrefix 和 destinationBucketSuffix。
使用以上示例,您可以执行以下操作:
from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket&destinationBucketPrefix=RAW(pre-)&destinationBucketSuffix=RAW(-suff)")
.to("mock:result");
from("aws2-s3://mycamelbucket?amazonS3Client=#amazonS3Client&moveAfterRead=true&destinationBucket=myothercamelbucket&destinationBucketPrefix=RAW(pre-)&destinationBucketSuffix=RAW(-suff)")
.to("mock:result");
在这种情况下,消耗的对象将移到 myothercamelbucket bucket,并从原始存储桶中删除(因为 deleteAfterRead 设置为 true )。
因此,如果文件名是 test,在 myothercamelbucket 中,您应该会看到一个名为 pre-test-suff 的文件。
6.11. 使用客户密钥加密 复制链接链接已复制到粘贴板!
我们还引入了客户密钥支持(使用 KMS 的替代方案)。以下代码显示了一个示例。
6.12. 使用 POJO 作为正文 复制链接链接已复制到粘贴板!
由于多个选项,有时构建 AWS Request 可能会很复杂。我们介绍可能将 POJO 用作正文。在 AWS S3 中,您可以提交多个操作,作为 List 代理请求示例,您可以执行以下操作:
from("direct:aws2-s3")
.setBody(ListObjectsRequest.builder().bucket(bucketName).build())
.to("aws2-s3://test?amazonS3Client=#amazonS3Client&operation=listObjects&pojoRequest=true")
from("direct:aws2-s3")
.setBody(ListObjectsRequest.builder().bucket(bucketName).build())
.to("aws2-s3://test?amazonS3Client=#amazonS3Client&operation=listObjects&pojoRequest=true")
这样,您将直接传递请求,而无需专门传递与此操作相关的标头和选项。
6.13. 创建 S3 客户端并在 registry 中添加组件 复制链接链接已复制到粘贴板!
有时,您要使用 AWS2S3Configuration 执行一些高级配置,这还允许设置 S3 客户端。您可以在组件配置中创建和设置 S3 客户端,如下例所示
现在,您可以配置 S3 组件(使用上面创建的配置对象),并在路由初始化前将其添加到配置方法中的 registry 中。
AWS2S3Component s3Component = new AWS2S3Component(getContext());
s3Component.setConfiguration(configuration);
s3Component.setLazyStartProducer(true);
camelContext.addComponent("aws2-s3", s3Component);
AWS2S3Component s3Component = new AWS2S3Component(getContext());
s3Component.setConfiguration(configuration);
s3Component.setLazyStartProducer(true);
camelContext.addComponent("aws2-s3", s3Component);
现在,您的组件将用于在 camel 路由中实施的所有操作。
6.14. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-s3</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-s3</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
6.15. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-s3 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-s3-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-s3-starter</artifactId>
</dependency>
组件支持 51 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-s3.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-s3.amazon-s3-client | 对 registry 中的 com.amazonaws.services.s3.AmazonS3 的引用。选项是一个 software.amazon.awssdk.services.s3.S3Client 类型。 | S3Client | |
| camel.component.aws2-s3.amazon-s3-presigner | 用于 Request 的 S3 Presigner 主要在 createDownloadLink 操作中使用。选项是一个 software.amazon.awssdk.services.s3.presigner.S3Presigner 类型。 | S3Presigner | |
| camel.component.aws2-s3.auto-create-bucket | 设置 S3 存储桶自动创建的 bucketName。如果启用了 moveAfterRead 选项,则也会应用它,如果尚未存在 moveAfterRead 选项,它将创建 destinationBucket。 | false | 布尔值 |
| camel.component.aws2-s3.autoclose-body | 如果此选项为 true,且 includeBody 为 false,则在交换完成时调用 S3Object.close() 方法。此选项与 includeBody 选项密切相关。如果将 includeBody 设为 false,autocloseBody 设为 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 处理。默认情况下,使用者将使用 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 时要使用的 Customer key 的 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 对象正文将完全忽略,如果设为 false,则 S3 对象将放入正文中。把它设置为 true,将覆盖 includeBody 选项定义的任何行为。 | false | 布尔值 |
| camel.component.aws2-s3.include-body | 如果为 true,则 S3Object Exchange 将被使用并放入正文和关闭中。如果为 false,S3Object 流将原始放在正文中,标头将使用 S3 对象元数据设置。这个选项与 autocloseBody 选项密切相关。如果将 includeBody 设为 true,因为 S3Object 流将被消耗,然后也会关闭它,而在 includeBody false 时,它将是关闭 S3Object 流的调用者。但是,当 includeBody 为 false 时,将 autocloseBody 设置为 true,它将在交换完成时自动关闭 S3Object 流。 | true | 布尔值 |
| camel.component.aws2-s3.include-folders | 如果为 true,将消费的文件夹/目录。如果是 false,则忽略它们,且不会为那些交换创建。 | true | 布尔值 |
| camel.component.aws2-s3.key-name | 通过端点参数在存储桶中设置元素的密钥名称。 | 字符串 | |
| camel.component.aws2-s3.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 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 | 布尔值 |
第 7 章 AWS Simple Notification System (SNS) 复制链接链接已复制到粘贴板!
仅支持生成者
AWS2 SNS 组件允许消息发送到 Amazon Simple Notification 主题。Amazon API 的实现由 AWS SDK 提供。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并签名以使用 Amazon SNS。如需更多信息,请参阅 Amazon SNS。
7.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-sns://topicNameOrArn[?options]
aws2-sns://topicNameOrArn[?options]
如果主题不存在,则会创建它们。您可以将查询选项附加到 URI 中,格式为 ?options=value&option2=value&…
7.2. URI 选项 复制链接链接已复制到粘贴板!
7.2.1. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
7.2.1.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
7.2.1.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
7.3. 组件选项 复制链接链接已复制到粘贴板!
AWS Simple Notification System (SNS) 组件支持 24 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonSNSClient (producer) | Autowired 使用 AmazonSNS 作为客户端。 | SnsClient | |
| autoCreateTopic (producer) | 设置主题的自动创建。 | false | 布尔值 |
| 配置 (生成者) | 组件配置. | Sns2Configuration | |
| kmsMasterKeyId (producer) | 用于 Amazon SNS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| messageDeduplicationIdStrategy (producer) | 仅适用于 FIFO 主题。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 Enum 值:
| useExchangeId | 字符串 |
| messageGroupIdStrategy (producer) | 仅适用于 FIFO 主题。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 Enum 值:
| 字符串 | |
| messageStructure (producer) | 使用 json 的消息结构。 | 字符串 | |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| policy (producer) | 本主题的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| proxyHost (producer) | 在实例化 SNS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | 在实例化 SNS 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (producer) | 在实例化 SNS 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| queueUrl (producer) | 要订阅的 queueUrl。 | 字符串 | |
| region (producer) | SNS 客户端需要在其中工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| serverSideEncryptionEnabled (producer) | 定义是否在主题中启用 Server Side Encryption。 | false | 布尔值 |
| subject (producer) | 如果邮件标头 'CamelAwsSnsSubject' 不存在,则使用主题。 | 字符串 | |
| subscribeSNStoSQS (producer) | 定义 SNS 主题和 SQS 之间的订阅是否必须完成。 | false | 布尔值 |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 SNS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
7.4. 端点选项 复制链接链接已复制到粘贴板!
AWS Simple Notification System (SNS) 端点使用 URI 语法进行配置:
aws2-sns:topicNameOrArn
aws2-sns:topicNameOrArn
使用以下路径和查询参数:
7.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| topicNameOrArn (producer) | 所需的 主题名称或 ARN。 | 字符串 |
7.4.2. 查询参数(23 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonSNSClient (producer) | Autowired 使用 AmazonSNS 作为客户端。 | SnsClient | |
| autoCreateTopic (producer) | 设置主题的自动创建。 | false | 布尔值 |
| headerFilterStrategy (producer) | 使用自定义 HeaderFilterStrategy 将标头映射到/来自 Camel。 | HeaderFilterStrategy | |
| kmsMasterKeyId (producer) | 用于 Amazon SNS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| messageDeduplicationIdStrategy (producer) | 仅适用于 FIFO 主题。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 Enum 值:
| useExchangeId | 字符串 |
| messageGroupIdStrategy (producer) | 仅适用于 FIFO 主题。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 Enum 值:
| 字符串 | |
| messageStructure (producer) | 使用 json 的消息结构。 | 字符串 | |
| overrideEndpoint (producer) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| policy (producer) | 本主题的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| proxyHost (producer) | 在实例化 SNS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (producer) | 在实例化 SNS 客户端时定义代理端口。 | 整数 | |
| proxyProtocol (producer) | 在实例化 SNS 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| queueUrl (producer) | 要订阅的 queueUrl。 | 字符串 | |
| region (producer) | SNS 客户端需要在其中工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| serverSideEncryptionEnabled (producer) | 定义是否在主题中启用 Server Side Encryption。 | false | 布尔值 |
| subject (producer) | 如果邮件标头 'CamelAwsSnsSubject' 不存在,则使用主题。 | 字符串 | |
| subscribeSNStoSQS (producer) | 定义 SNS 主题和 SQS 之间的订阅是否必须完成。 | false | 布尔值 |
| trustAllCertificates (producer) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (producer) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (producer) | 设置 SNS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 SNS 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 amazonSNSClient,才能访问 Amazon 的 SNS。
7.5. 使用方法 复制链接链接已复制到粘贴板!
7.5.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
- Java 系统属性 - aws.accessKeyId 和 aws.secretKey
- 环境变量 - AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
- Amazon ECS 容器凭证 - 如果设置了环境变量 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。
- Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档。
7.5.2. 由 SNS producer 评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
|
Amazon SNS 消息主题。如果没有设置,则使用 |
7.5.3. SNS producer 设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| Amazon SNS 消息 ID。 |
7.5.4. 高级 AmazonSNS 配置 复制链接链接已复制到粘贴板!
如果需要对 SnsClient 实例配置进行更多控制,您可以创建自己的实例,并从 URI 引用它:
from("direct:start")
.to("aws2-sns://MyTopic?amazonSNSClient=#client");
from("direct:start")
.to("aws2-sns://MyTopic?amazonSNSClient=#client");
#client 指的是 Registry 中的 AmazonSNS。
7.5.5. 在 AWS SNS 主题和 AWS SQS Queue 之间创建订阅 复制链接链接已复制到粘贴板!
您可以创建一个 SQS Queue 订阅到 SNS 主题:
from("direct:start")
.to("aws2-sns://test-camel-sns1?amazonSNSClient=#amazonSNSClient&subscribeSNStoSQS=true&queueUrl=https://sqs.eu-central-1.amazonaws.com/780410022472/test-camel");
from("direct:start")
.to("aws2-sns://test-camel-sns1?amazonSNSClient=#amazonSNSClient&subscribeSNStoSQS=true&queueUrl=https://sqs.eu-central-1.amazonaws.com/780410022472/test-camel");
#amazonSNSClient 是指 Registry 中的 SnsClient。通过将 subscribeSNStoSQS 指定为 true,并且指定现有 SQS 队列的 queueUrl,您可以将 SQS Queue 订阅到您的 SNS 主题。
此时,您可以通过 SQS Queue 使用来自 SNS 主题的消息
from("aws2-sqs://test-camel?amazonSQSClient=#amazonSQSClient&delay=50&maxMessagesPerPoll=5")
.to(...);
from("aws2-sqs://test-camel?amazonSQSClient=#amazonSQSClient&delay=50&maxMessagesPerPoll=5")
.to(...);
7.6. Topic Autocreation 复制链接链接已复制到粘贴板!
通过选项 autoCreateTopic 用户,如果 SNS Topic 不存在,可以避免自动创建它。此选项的默认值是 true。如果设置为 false 任何对 AWS 中不存在的主题的操作,则不会成功,并返回错误。
7.7. SNS FIFO 复制链接链接已复制到粘贴板!
支持 SNS FIFO。在创建 SQS 队列时,您将订阅 SNS 主题,需要记住,您需要让 SNS Topic 发送消息到 SQS Queue。
示例
假设您创建一个名为 Order.fifo 的 SNS FIFO 主题,以及一个名为 QueueSub.fifo 的 SQS Queue。
在 QueueSub.fifo 的访问策略中,您应该提交如下内容:
这是使订阅正常工作的关键步骤。
向 FIFO 主题发送一些时,您需要始终设置消息组 Id 策略。
如果 SNS Fifo 主题上启用了基于内容的消息 deduplication,则不需要设置消息 deduplication id 策略,否则您必须对其进行设置。
7.8. 例子 复制链接链接已复制到粘贴板!
7.8.1. 生成者示例 复制链接链接已复制到粘贴板!
发送到主题
from("direct:start")
.to("aws2-sns://camel-topic?subject=The+subject+message&autoCreateTopic=true");
from("direct:start")
.to("aws2-sns://camel-topic?subject=The+subject+message&autoCreateTopic=true");
7.9. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-sns</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-sns</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
7.10. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 aws2-sns 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-aws2-sns-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-aws2-sns-starter</artifactId>
</dependency>
组件支持 25 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.aws2-sns.access-key | Amazon AWS 访问密钥. | 字符串 | |
| camel.component.aws2-sns.amazon-s-n-s-client | 将 AmazonSNS 用作客户端。选项是一个 software.amazon.awssdk.services.sns.SnsClient 类型。 | SnsClient | |
| camel.component.aws2-sns.auto-create-topic | 设置主题的自动创建。 | false | 布尔值 |
| camel.component.aws2-sns.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.aws2-sns.configuration | 组件配置.选项是 org.apache.camel.component.aws2.sns.Sns2Configuration 类型。 | Sns2Configuration | |
| camel.component.aws2-sns.enabled | 是否启用 aws2-sns 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.aws2-sns.kms-master-key-id | 用于 Amazon SNS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
| camel.component.aws2-sns.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.aws2-sns.message-deduplication-id-strategy | 仅适用于 FIFO 主题。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 | useExchangeId | 字符串 |
| camel.component.aws2-sns.message-group-id-strategy | 仅适用于 FIFO 主题。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 | 字符串 | |
| camel.component.aws2-sns.message-structure | 使用 json 的消息结构。 | 字符串 | |
| camel.component.aws2-sns.override-endpoint | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| camel.component.aws2-sns.policy | 本主题的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| camel.component.aws2-sns.proxy-host | 在实例化 SNS 客户端时定义代理主机。 | 字符串 | |
| camel.component.aws2-sns.proxy-port | 在实例化 SNS 客户端时定义代理端口。 | 整数 | |
| camel.component.aws2-sns.proxy-protocol | 在实例化 SNS 客户端时定义代理协议。 | 协议 | |
| camel.component.aws2-sns.queue-url | 要订阅的 queueUrl。 | 字符串 | |
| camel.component.aws2-sns.region | SNS 客户端需要在其中工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| camel.component.aws2-sns.secret-key | Amazon AWS Secret 密钥。 | 字符串 | |
| camel.component.aws2-sns.server-side-encryption-enabled | 定义是否在主题中启用 Server Side Encryption。 | false | 布尔值 |
| camel.component.aws2-sns.subject | 如果邮件标头 'CamelAwsSnsSubject' 不存在,则使用主题。 | 字符串 | |
| camel.component.aws2-sns.subscribe-s-n-sto-s-q-s | 定义 SNS 主题和 SQS 之间的订阅是否必须完成。 | false | 布尔值 |
| camel.component.aws2-sns.trust-all-certificates | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| camel.component.aws2-sns.uri-endpoint-override | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| camel.component.aws2-sns.use-default-credentials-provider | 设置 SNS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
第 8 章 AWS Simple Queue Service (SQS) 复制链接链接已复制到粘贴板!
支持生成者和消费者
AWS2 SQS 组件支持向 Amazon 的 SQS 服务发送和接收信息。
先决条件
您必须有一个有效的 Amazon Web Services 开发人员帐户,并签名以使用 Amazon SQS。如需更多信息,请参阅 Amazon SQS。
8.1. URI 格式 复制链接链接已复制到粘贴板!
aws2-sqs://queueNameOrArn[?options]
aws2-sqs://queueNameOrArn[?options]
如果队列不存在,将创建队列。您可以以以下格式将查询选项附加到 URI 中,
?options=value&option2=value&…
8.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
8.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
8.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
8.3. 组件选项 复制链接链接已复制到粘贴板!
AWS Simple Queue Service (SQS) 组件支持 43 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonAWSHost (common) | Amazon AWS 云的主机名。 | amazonaws.com | 字符串 |
| amazonSQSClient (common) | Autowired 以将 AmazonSQS 用作客户端。 | SqsClient | |
| autoCreateQueue (common) | 设置队列的自动创建. | false | 布尔值 |
| configuration (common) | AWS SQS 默认配置。 | Sqs2Configuration | |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| protocol (common) | 用于与 SQS 通信的底层协议。 | https | 字符串 |
| proxyProtocol (common) | 在实例化 SQS 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| queueOwnerAWSAccountId (common) | 当您需要将队列与不同的帐户所有者连接时,指定队列所有者 aws 帐户 ID。 | 字符串 | |
| region (common) | SQS 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 SQS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
| attributeNames (consumer) | 在消费时要接收的属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| concurrentConsumers (consumer) | 允许您使用多个线程轮询 sqs 队列来提高吞吐量。 | 1 | int |
| defaultVisibilityTimeout (consumer) | 默认可见性超时(以秒为单位)。 | 整数 | |
| deleteAfterRead (consumer) | 读取后,从 SQS 删除消息。 | true | 布尔值 |
| deleteIfFiltered (consumer) | 如果交换具有键 Sqs2Constants#SQS_DELETE_FILTERED (CamelAwsSqsDeleteFiltered),则是否将 DeleteMessage 发送到 SQS 队列。 | true | 布尔值 |
| extendMessageVisibility (consumer) | 如果启用,则调度的后台任务将在 SQS 上保持消息可见性。如果处理消息需要很长时间。如果设置为 true defaultVisibilityTimeout,则必须设置。 | false | 布尔值 |
| kmsDataKeyReusePeriodSeconds (consumer) | Amazon SQS 在再次调用 AWS KMS 之前,以便 Amazon SQS 可以重复使用或解密信息的时间长度(以秒为单位)。一个代表秒的整数,在 60 秒 (1 分钟) 和 86,400 秒 (24 小时)之间。默认:300 (5 分钟)。 | 整数 | |
| kmsMasterKeyId (consumer) | Amazon SQS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
| messageAttributeNames (consumer) | 在消费时要接收的消息属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
| serverSideEncryptionEnabled (consumer) | 定义是否在队列中启用服务器端加密。 | false | 布尔值 |
| visibilityTimeout (consumer) | 在由 ReceiveMessage 请求检索后,收到的消息会被隐藏在 com.amazonaws.services.sqs.model.SetQueueAttributesRequest 中检索的持续时间(以秒为单位)。这只有在与 defaultVisibilityTimeout 不同时才有意义。它永久更改队列可见性超时属性。 | 整数 | |
| waitTimeSeconds (consumer) | ReceiveMessage 操作调用的持续时间(0 到 20)将等待直到队列中消息包含在响应中。 | 整数 | |
| batchSeparator (producer) | 在传递 String 以发送批处理消息操作时,设置分隔符。 | , | 字符串 |
| delaySeconds (producer) | 延迟发送消息的秒数。 | 整数 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| messageDeduplicationIdStrategy (producer) | 仅适用于 FIFO 队列。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 Enum 值:
| useExchangeId | 字符串 |
| messageGroupIdStrategy (producer) | 仅适用于 FIFO 队列。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 Enum 值:
| 字符串 | |
| operation (producer) | 当用户不想发送消息时,要执行的操作。 Enum 值:
| Sqs2Operations | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| delayQueue (advanced) | 定义您是否要将 delaySeconds 选项应用到队列或单个消息。 | false | 布尔值 |
| queueUrl (advanced) | 明确定义 queueUrl:所有其他参数(会影响 queueUrl)将被忽略。这个参数被用来连接到 SQS 的模拟实施,用于测试。 | 字符串 | |
| proxyHost (proxy) | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (proxy) | 在实例化 SQS 客户端时定义代理端口。 | 整数 | |
| maximumMessageSize (queue) | maximumMessageSize (以字节为单位)SQS 消息可以包含此队列。 | 整数 | |
| messageRetentionPeriod (queue) | SQS 为此队列保留一个消息的 messageRetentionPeriod (以秒为单位)。 | 整数 | |
| policy (queue) | 此队列的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| receiveMessageWaitTimeSeconds (queue) | 如果您没有在请求中指定 WaitTimeSeconds,则使用 queue 属性 ReceiveMessageWaitTimeSeconds 来确定要等待的时长。 | 整数 | |
| redrivePolicy (queue) | 指定发送消息到 DeadLetter 队列的策略。请参阅 Amazon 文档的详情。 | 字符串 | |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
8.4. 端点选项 复制链接链接已复制到粘贴板!
AWS Simple Queue Service (SQS)端点使用 URI 语法进行配置:
aws2-sqs:queueNameOrArn
aws2-sqs:queueNameOrArn
使用以下路径和查询参数:
8.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| queueNameOrArn (common) | 所需的 Queue name 或 ARN。 | 字符串 |
8.4.2. 查询参数(61 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amazonAWSHost (common) | Amazon AWS 云的主机名。 | amazonaws.com | 字符串 |
| amazonSQSClient (common) | Autowired 以将 AmazonSQS 用作客户端。 | SqsClient | |
| autoCreateQueue (common) | 设置队列的自动创建. | false | 布尔值 |
| HeaderFilterStrategy (common) | 使用自定义 HeaderFilterStrategy 将标头映射到/来自 Camel。 | HeaderFilterStrategy | |
| overrideEndpoint (common) | 设置覆盖端点的需要。这个选项需要与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
| protocol (common) | 用于与 SQS 通信的底层协议。 | https | 字符串 |
| proxyProtocol (common) | 在实例化 SQS 客户端时定义代理协议。 Enum 值:
| HTTPS | 协议 |
| queueOwnerAWSAccountId (common) | 当您需要将队列与不同的帐户所有者连接时,指定队列所有者 aws 帐户 ID。 | 字符串 | |
| region (common) | SQS 客户端需要工作的区域。使用此参数时,配置将预期区域(如 ap-east-1)的小写名称,您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
| trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
| uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项需要与 overrideEndpoint 选项结合使用。 | 字符串 | |
| useDefaultCredentialsProvider (common) | 设置 SQS 客户端是否应该预期在 AWS infra 实例上加载凭证,或希望传递静态凭证。 | false | 布尔值 |
| attributeNames (consumer) | 在消费时要接收的属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| concurrentConsumers (consumer) | 允许您使用多个线程轮询 sqs 队列来提高吞吐量。 | 1 | int |
| defaultVisibilityTimeout (consumer) | 默认可见性超时(以秒为单位)。 | 整数 | |
| deleteAfterRead (consumer) | 读取后,从 SQS 删除消息。 | true | 布尔值 |
| deleteIfFiltered (consumer) | 如果交换具有键 Sqs2Constants#SQS_DELETE_FILTERED (CamelAwsSqsDeleteFiltered),则是否将 DeleteMessage 发送到 SQS 队列。 | true | 布尔值 |
| extendMessageVisibility (consumer) | 如果启用,则调度的后台任务将在 SQS 上保持消息可见性。如果处理消息需要很长时间。如果设置为 true defaultVisibilityTimeout,则必须设置。详情请参阅 Amazon 文档。 | false | 布尔值 |
| kmsDataKeyReusePeriodSeconds (consumer) | Amazon SQS 在再次调用 AWS KMS 之前,以便 Amazon SQS 可以重复使用或解密信息的时间长度(以秒为单位)。一个代表秒的整数,在 60 秒 (1 分钟) 和 86,400 秒 (24 小时)之间。默认:300 (5 分钟)。 | 整数 | |
| kmsMasterKeyId (consumer) | Amazon SQS 或自定义 CMK 的 AWS 管理的客户主密钥 (CMK) 的 ID。 | 字符串 | |
| maxMessagesPerPoll (consumer) | 获取最大消息数,作为每次轮询轮询的限制。默认无限,但使用 0 或负数来禁用它(无限)。 | int | |
| messageAttributeNames (consumer) | 在消费时要接收的消息属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| serverSideEncryptionEnabled (consumer) | 定义是否在队列中启用服务器端加密。 | false | 布尔值 |
| visibilityTimeout (consumer) | 在由 ReceiveMessage 请求检索后,收到的消息会被隐藏在 com.amazonaws.services.sqs.model.SetQueueAttributesRequest 中检索的持续时间(以秒为单位)。这只有在与 defaultVisibilityTimeout 不同时才有意义。它永久更改队列可见性超时属性。 | 整数 | |
| waitTimeSeconds (consumer) | ReceiveMessage 操作调用的持续时间(0 到 20)将等待直到队列中消息包含在响应中。 | 整数 | |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| batchSeparator (producer) | 在传递 String 以发送批处理消息操作时,设置分隔符。 | , | 字符串 |
| delaySeconds (producer) | 延迟发送消息的秒数。 | 整数 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| messageDeduplicationIdStrategy (producer) | 仅适用于 FIFO 队列。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一:useExchangeId, useContentBasedDeduplication.对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 Enum 值:
| useExchangeId | 字符串 |
| messageGroupIdStrategy (producer) | 仅适用于 FIFO 队列。在消息上设置 messageGroupId 的策略。可以是以下选项之一:useConstant, useExchangeId, usePropertyValue.对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId 的值。 Enum 值:
| 字符串 | |
| operation (producer) | 当用户不想发送消息时,要执行的操作。 Enum 值:
| Sqs2Operations | |
| delayQueue (advanced) | 定义您是否要将 delaySeconds 选项应用到队列或单个消息。 | false | 布尔值 |
| queueUrl (advanced) | 明确定义 queueUrl:所有其他参数(会影响 queueUrl)将被忽略。这个参数被用来连接到 SQS 的模拟实施,用于测试。 | 字符串 | |
| proxyHost (proxy) | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
| proxyPort (proxy) | 在实例化 SQS 客户端时定义代理端口。 | 整数 | |
| maximumMessageSize (queue) | maximumMessageSize (以字节为单位)SQS 消息可以包含此队列。 | 整数 | |
| messageRetentionPeriod (queue) | SQS 为此队列保留一个消息的 messageRetentionPeriod (以秒为单位)。 | 整数 | |
| policy (queue) | 此队列的策略。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| receiveMessageWaitTimeSeconds (queue) | 如果您没有在请求中指定 WaitTimeSeconds,则使用 queue 属性 ReceiveMessageWaitTimeSeconds 来确定要等待的时长。 | 整数 | |
| redrivePolicy (queue) | 指定发送消息到 DeadLetter 队列的策略。请参阅 Amazon 文档的详情。 | 字符串 | |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessKey (security) | Amazon AWS 访问密钥. | 字符串 | |
| secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |
所需的 SQS 组件选项
您必须在 Registry 或 accessKey 和 secretKey 中提供 amazonSQSClient,才能访问 Amazon 的 SQS。
8.5. Batch Consumer 复制链接链接已复制到粘贴板!
这个组件实现了 Batch Consumer。
这样,您可以让实例知道此批处理中存在多少个消息,而实例则让聚合器聚合此消息数量。
8.6. 使用方法 复制链接链接已复制到粘贴板!
8.6.1. 静态凭证和默认凭证提供程序 复制链接链接已复制到粘贴板!
您可以通过指定 useDefaultCredentialsProvider 选项并将其设置为 true 来避免使用显式静态凭证。
-
Java system properties -
aws.accessKeyIdandaws.secretKey -
环境变量 -
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。 - AWS STS 的 Web Identity Token。
- 共享凭证和配置文件。
-
Amazon ECS 容器凭证 - 如果设置了环境变量
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI,则从 Amazon ECS 加载。 - Amazon EC2 实例配置集凭据。
有关此信息的更多信息,您可以查看 AWS 凭证文档
8.6.2. SQS producer 设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| Amazon SQS 消息的 MD5 checksum。 |
|
|
| Amazon SQS 消息 ID。 |
|
|
| Amazon SQS 消息可以被其他人查看的延迟秒数。 |
8.6.3. SQS 使用者设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| Amazon SQS 消息的 MD5 checksum。 |
|
|
| Amazon SQS 消息 ID。 |
|
|
| Amazon SQS 消息接收处理。 |
|
|
| Amazon SQS 消息属性。 |
8.6.4. 高级 AmazonSQS 配置 复制链接链接已复制到粘贴板!
如果您的 Camel 应用程序在防火墙后面运行,或者需要对 SqsClient 实例配置拥有更多控制,您可以创建自己的实例:
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
8.6.5. 创建或更新 SQS 队列 复制链接链接已复制到粘贴板!
在 SQS 组件中,当端点启动时,将执行检查以获取有关队列是否存在的信息。您可以使用 SQSConfiguration 选项通过 QueueAttributeName 映射自定义创建。
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
from("aws2-sqs://MyQueue?amazonSQSClient=#client&delay=5000&maxMessagesPerPoll=5")
.to("mock:result");
在本例中,如果 AWS 上尚未创建 MyQueue 队列(将 autoCreateQueue 选项设置为 true),它将使用 SQS 配置中的默认参数创建。如果它已在 AWS 上启动,则 SQS 配置选项将用于覆盖现有的 AWS 配置。
8.6.6. DelayQueue VS Delay 用于 Single 信息 复制链接链接已复制到粘贴板!
当选项 delayQueue 设为 true 时,SQS Queue 将是一个 DelayQueue,带有 DelaySeconds 选项作为延迟。有关 DelayQueue 的更多信息,请参阅 AWS SQS 文档。要考虑的重要信息如下:
- 对于标准队列,每个队列延迟设置不会重新更改设置不会影响队列中已经的信息的延迟。
- 对于 FIFO 队列,每个队列延迟设置是重新引入的,该设置会影响队列中已存在于的消息的延迟。
如官方文档中所述。如果要在单个消息上指定延迟,可以忽略 delayQueue 选项,同时如果您需要向所有消息添加固定延迟,则可以将这个选项设置为 true。
8.6.7. 服务器同级加密 复制链接链接已复制到粘贴板!
为队列有一组 Server Side Encryption 属性。相关的选项包括 serverSideEncryptionEnabled,keyMasterKeyId 和 kmsDataKeyReusePeriod。SSE 默认禁用。您需要明确将选项设置为 true,并将相关参数设置为 queue 属性。
8.7. JMS 风格的 Selectors 复制链接链接已复制到粘贴板!
SQS 不允许选择器,但您可以使用 Camel Filter EIP 并设置适当的 visibilityTimeout。当 SQS 分配消息时,它将等待可见超时,然后尝试将消息发送到不同的消费者,除非收到 DeleteMessage。默认情况下,Camel 始终会在路由末尾发送 DeleteMessage,除非路由失败。要实现适当的过滤,在成功完成路由时也不会发送 DeleteMessage,请使用 Filter:
from("aws2-sqs://MyQueue?amazonSQSClient=#client&defaultVisibilityTimeout=5000&deleteIfFiltered=false&deleteAfterRead=false")
.filter("${header.login} == true")
.setProperty(Sqs2Constants.SQS_DELETE_FILTERED, constant(true))
.to("mock:filter");
from("aws2-sqs://MyQueue?amazonSQSClient=#client&defaultVisibilityTimeout=5000&deleteIfFiltered=false&deleteAfterRead=false")
.filter("${header.login} == true")
.setProperty(Sqs2Constants.SQS_DELETE_FILTERED, constant(true))
.to("mock:filter");
在上面的代码中,如果交换没有适当的标头,则不会通过过滤器 AND 进行它,也不会从 SQS 队列中删除。5000 毫秒后,消息对其他消费者可见。
请注意,必须将属性 Sqs2Constants.SQS_DELETE_FILTERED 设置为 true,以指示 Camel 发送 DeleteMessage (如果过滤)。
8.8. 可用的 Producer 操作 复制链接链接已复制到粘贴板!
- 单条消息(默认)
- sendBatchMessage
- deleteMessage
- listQueues
8.9. 发送消息 复制链接链接已复制到粘贴板!
您可以设置 SendMessageBatchRequest 或 Iterable
from("direct:start")
.setBody(constant("Camel rocks!"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
from("direct:start")
.setBody(constant("Camel rocks!"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
8.10. 发送批处理消息 复制链接链接已复制到粘贴板!
您可以设置 SendMessageBatchRequest 或 Iterable
因此,您将获得一个包含 SendMessageBatchResponse 实例的交换,您可以评估来检查哪些消息成功,以及什么信息不成功。批处理的每个消息上设置的 id 将是一个随机 UUID。
8.11. 删除单个消息 复制链接链接已复制到粘贴板!
使用 deleteMessage 操作删除单个消息。您需要为您要删除的消息设置接收句柄标头。
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("deleteMessage"))
.setHeader(SqsConstants.RECEIPT_HANDLE, constant("123456"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("deleteMessage"))
.setHeader(SqsConstants.RECEIPT_HANDLE, constant("123456"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
因此,您将获得一个包含 DeleteMessageResponse 实例的交换,您可以使用它来检查消息是否已被删除。
8.12. List Queues 复制链接链接已复制到粘贴板!
使用 listQueues 操作列出队列。
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("listQueues"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("listQueues"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
因此,您将获得一个包含 ListQueuesResponse 实例的交换,您可以检查实际队列。
8.13. 清除队列 复制链接链接已复制到粘贴板!
使用 purgeQueue 操作清除队列。
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("purgeQueue"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
from("direct:start")
.setHeader(SqsConstants.SQS_OPERATION, constant("purgeQueue"))
.to("aws2-sqs://camel-1?accessKey=RAW(xxx)&secretKey=RAW(xxx)®ion=eu-west-1");
因此,您将获得一个包含 PurgeQueueResponse 实例的交换。
8.14. 队列自动创建 复制链接链接已复制到粘贴板!
使用选项 autoCreateQueue 用户可以在 SQS Queue 不存在时避免自动创建。此选项的默认值是 true。如果设置为 false 对 AWS 中不存在队列的操作,则不会成功,并返回错误。
8.15. 发送批处理消息和消息重复数据删除策略 复制链接链接已复制到粘贴板!
如果您使用 SendBatchMessage Operation,您可以设置两种不同类型的消息重复数据删除策略: - useExchangeId - useContentBasedDeduplication
第一个将使用 ExchangeIdMessageDeduplicationIdStrategy,它将使用 Exchange ID 作为参数,另一个将使用 NullMessageDeduplicationIdStrategy,它将使用 body 作为 deduplication 元素。
如果是发送批处理消息操作,您需要使用 useContentBasedDeduplication 和 Queue,您需要 启用基于内容的 deduplication 选项。
8.16. 依赖项 复制链接链接已复制到粘贴板!
Maven 用户需要将以下依赖项添加到其 pom.xml 中:
pom.xml
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-sqs</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws2-sqs</artifactId>
<version>${camel-version}</version>
</dependency>
其中 3.18.3 必须替换为 Camel 的实际版本。
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>
<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)将等待直到队列中消息包含在响应中。 | 整数 |
第 9 章 Azure ServiceBus 复制链接链接已复制到粘贴板!
从 Camel 3.12 开始
支持生成者和消费者
集成 Azure ServiceBus 的 azure-servicebus 组件。Azure ServiceBus 是一个完全托管的企业集成消息代理。服务总线可以分离应用程序和服务。服务总线提供了一个可靠安全平台,用于异步传输数据和状态。使用消息在不同的应用程序和服务间传输数据。
先决条件
您必须有一个有效的 Windows Azure Storage 帐户。如需更多信息,请参阅 Azure 文档门户。
将以下依赖项添加到此组件的 pom.xml 中:
9.1. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
9.1.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
9.1.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
9.2. 组件选项 复制链接链接已复制到粘贴板!
Azure ServiceBus 组件支持 25 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amqpRetryOptions (common) | 为服务总线客户端设置重试选项。如果没有指定,则使用默认的重试选项。 | AmqpRetryOptions | |
| amqpTransportType (common) | 设置发生与 Azure Service Bus 的所有通信的传输类型。默认值为 AmqpTransportType114AMQP。 Enum 值:
| AMQP | AmqpTransportType |
| clientOptions (common) | 设置要从这个构建器构建的客户端发送的 ClientOptions,启用自定义某些属性,并支持添加自定义标头信息。如需更多信息,请参阅 ClientOptions 文档。 | ClientOptions | |
| configuration (common) | 组件配置。 | ServiceBusConfiguration | |
| proxyOptions (common) | 设置用于 ServiceBusSenderAsyncClient 的代理配置。配置代理后,必须将 AmqpTransportTypetransAMQP_WEB_SOCKETS 用于传输类型。 | ProxyOptions | |
| serviceBusType (common) | 需要执行 服务总线类型的连接类型。队列用于典型的队列选项,以及基于订阅模型的主题。 Enum 值:
| queue | ServiceBusType |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| consumerOperation (consumer) | 设置要在消费者中使用的所需操作。 Enum 值:
| receiveMessages | ServiceBusConsumerOperationDefinition |
| disableAutoComplete (consumer) | 禁用收到消息的自动完成和自动启用。默认情况下,成功处理的消息为 \\{link ServiceBusReceiverAsyncClientöcomplete (ServiceBusReceivedMessage) completed}。如果在处理消息时发生错误,它将是 \\{link ServiceBusReceiverAsyncClientöabandon (ServiceBusReceivedMessage) abandoned}。 | false | 布尔值 |
| maxAutoLockRenewDuration (consumer) | 设置继续自动更新锁定的时间。设置 Duration114ZERO 或 null 可禁用自动续订。对于 \\{link ServiceBusReceiveModeCEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,禁用自动续订。 | 5m | Duration |
| peekNumMaxMessages (consumer) | 设置在 peek 操作期间要显示的最大消息数。 | 整数 | |
| prefetchCount (consumer) | 设置接收方的 prefetch 计数。对于 \\{link ServiceBusReceiveModeHQPEEK_LOCK PEEK_LOCK} 和 \\{link ServiceBusReceiveModeDSRECEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,默认值为 1。Prefetch 通过模拟在应用使用 ServiceBusReceiverAsyncClient receiveMessages ()请求一个消息之前,为本地检索提供消息流速度。设置非零值将预先获取该消息的数量。将值设为零关闭。 | int | |
| receiverAsyncClient (consumer) | Autowired 设置 receiverAsyncClient,以便消耗消费者的消息。 | ServiceBusReceiverAsyncClient | |
| serviceBusReceiveMode (consumer) | 为接收方设置接收模式。 Enum 值:
| PEEK_LOCK | ServiceBusReceiveMode |
| subQueue (consumer) | 设置要连接的 SubQueue 的类型。 Enum 值:
| SubQueue | |
| subscriptionName (consumer) | 设置主题中的订阅名称,以侦听。还必须设置 topicOrQueueName 和 serviceBusType=topic。如果 serviceBusType=topic 和使用使用者,则需要此属性。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| producerOperation (producer) | 设置要在制作者中使用的所需操作。 Enum 值:
| sendMessages | ServiceBusProducerOperationDefinition |
| scheduledEnqueueTime (producer) | 设置 OffsetDateTime,其中消息应出现在服务总线队列或主题中。 | OffsetDateTime | |
| senderAsyncClient (producer) | Autowired 设置在制作者中使用的 SenderAsyncClient。 | ServiceBusSenderAsyncClient | |
| serviceBusTransactionContext (producer) | 代表服务中的事务。此对象仅包含事务 ID。 | ServiceBusTransactionContext | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| connectionString (security) | 为服务总线命名空间或特定服务总线资源设置连接字符串。 | 字符串 | |
| fullyQualifiedNamespace (security) | 服务总线的完全限定域名。 | 字符串 | |
| tokenCredential (security) | 用于 Azure AD 身份验证的 TokenCredential,在 com.azure.identity 中实现。 | TokenCredential |
9.3. 端点选项 复制链接链接已复制到粘贴板!
Azure ServiceBus 端点使用 URI 语法进行配置:
azure-servicebus:topicOrQueueName
azure-servicebus:topicOrQueueName
使用以下路径和查询参数:
9.3.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| topicOrQueueName (common) | 所选主题名称或队列名称,具体取决于 serviceBusType 配置。例如,如果 serviceBusType=queue,则这是队列名称,如果 serviceBusType=topic,则这是主题名称。 | 字符串 |
9.3.2. 查询参数(25 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| amqpRetryOptions (common) | 为服务总线客户端设置重试选项。如果没有指定,则使用默认的重试选项。 | AmqpRetryOptions | |
| amqpTransportType (common) | 设置发生与 Azure Service Bus 的所有通信的传输类型。默认值为 AmqpTransportType114AMQP。 Enum 值:
| AMQP | AmqpTransportType |
| clientOptions (common) | 设置要从这个构建器构建的客户端发送的 ClientOptions,启用自定义某些属性,并支持添加自定义标头信息。如需更多信息,请参阅 ClientOptions 文档。 | ClientOptions | |
| proxyOptions (common) | 设置用于 ServiceBusSenderAsyncClient 的代理配置。配置代理后,必须将 AmqpTransportTypetransAMQP_WEB_SOCKETS 用于传输类型。 | ProxyOptions | |
| serviceBusType (common) | 需要执行 服务总线类型的连接类型。队列用于典型的队列选项,以及基于订阅模型的主题。 Enum 值:
| queue | ServiceBusType |
| consumerOperation (consumer) | 设置要在消费者中使用的所需操作。 Enum 值:
| receiveMessages | ServiceBusConsumerOperationDefinition |
| disableAutoComplete (consumer) | 禁用收到消息的自动完成和自动启用。默认情况下,成功处理的消息为 \\{link ServiceBusReceiverAsyncClientöcomplete (ServiceBusReceivedMessage) completed}。如果在处理消息时发生错误,它将是 \\{link ServiceBusReceiverAsyncClientöabandon (ServiceBusReceivedMessage) abandoned}。 | false | 布尔值 |
| maxAutoLockRenewDuration (consumer) | 设置继续自动更新锁定的时间。设置 Duration114ZERO 或 null 可禁用自动续订。对于 \\{link ServiceBusReceiveModeCEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,禁用自动续订。 | 5m | Duration |
| peekNumMaxMessages (consumer) | 设置在 peek 操作期间要显示的最大消息数。 | 整数 | |
| prefetchCount (consumer) | 设置接收方的 prefetch 计数。对于 \\{link ServiceBusReceiveModeHQPEEK_LOCK PEEK_LOCK} 和 \\{link ServiceBusReceiveModeDSRECEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,默认值为 1。Prefetch 通过模拟在应用使用 ServiceBusReceiverAsyncClient receiveMessages ()请求一个消息之前,为本地检索提供消息流速度。设置非零值将预先获取该消息的数量。将值设为零关闭。 | int | |
| receiverAsyncClient (consumer) | Autowired 设置 receiverAsyncClient,以便消耗消费者的消息。 | ServiceBusReceiverAsyncClient | |
| serviceBusReceiveMode (consumer) | 为接收方设置接收模式。 Enum 值:
| PEEK_LOCK | ServiceBusReceiveMode |
| subQueue (consumer) | 设置要连接的 SubQueue 的类型。 Enum 值:
| SubQueue | |
| subscriptionName (consumer) | 设置主题中的订阅名称,以侦听。还必须设置 topicOrQueueName 和 serviceBusType=topic。如果 serviceBusType=topic 和使用使用者,则需要此属性。 | 字符串 | |
| bridgeErrorHandler (consumer (advanced)) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| producerOperation (producer) | 设置要在制作者中使用的所需操作。 Enum 值:
| sendMessages | ServiceBusProducerOperationDefinition |
| scheduledEnqueueTime (producer) | 设置 OffsetDateTime,其中消息应出现在服务总线队列或主题中。 | OffsetDateTime | |
| senderAsyncClient (producer) | Autowired 设置在制作者中使用的 SenderAsyncClient。 | ServiceBusSenderAsyncClient | |
| serviceBusTransactionContext (producer) | 代表服务中的事务。此对象仅包含事务 ID。 | ServiceBusTransactionContext | |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| connectionString (security) | 为服务总线命名空间或特定服务总线资源设置连接字符串。 | 字符串 | |
| fullyQualifiedNamespace (security) | 服务总线的完全限定域名。 | 字符串 | |
| tokenCredential (security) | 用于 Azure AD 身份验证的 TokenCredential,在 com.azure.identity 中实现。 | TokenCredential |
9.4. async Consumer 和 Producer 复制链接链接已复制到粘贴板!
此组件实现了 async Consumer 和 producer。这允许 camel 路由异步使用和生成事件,而不阻断任何线程。
9.5. 消息标头 复制链接链接已复制到粘贴板!
Azure ServiceBus 组件支持 25 个消息标头,如下所列:
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| CamelAzureServiceBusApplicationProperties (common) | 生成者和消费者发送和接收的消息应用属性(也称为自定义属性)。 | Map | |
| CamelAzureServiceBusContentType (consumer) 常量: CONTENT_TYPE | 获取消息的内容类型。 | 字符串 | |
| CamelAzureServiceBusCorrelationId (consumer) 常量: CORRELATION_ID | 获取关联标识符。 | 字符串 | |
| CamelAzureServiceBusDeadLetterErrorDescription (consumer) | 获取已死字母消息的描述。 | 字符串 | |
| CamelAzureServiceBusDeadLetterReason (consumer) | 获取消息被死字母的原因。 | 字符串 | |
| CamelAzureServiceBusDeadLetterSource (consumer) | 在消息被排队之前,获取此消息排队的队列或订阅的名称。 | 字符串 | |
| CamelAzureServiceBusDeliveryCount (consumer) 常量:DEL IVERY_COUNT | 获取此消息传送到客户端的次数。 | long | |
| CamelAzureServiceBusEnqueuedSequenceNumber (consumer) | 获取由服务总线分配给消息的排队序列号。 | long | |
| CamelAzureServiceBusEnqueuedTime (consumer) 常数: ENQUEUED_TIME | 获取此消息在 Azure Service Bus 中排队的日期。 | OffsetDateTime | |
| CamelAzureServiceBusExpiresAt (consumer) 常数: EXPIRES_AT | 获取此消息将过期的日期。 | OffsetDateTime | |
| CamelAzureServiceBusLockToken (consumer) 常数: LOCK_TOKEN | 获取当前消息的锁定令牌。 | 字符串 | |
| CamelAzureServiceBusLockedUntil (consumer) 常数: LOCKED_UNTIL | 获取此消息的锁定过期的日期。 | OffsetDateTime | |
| CamelAzureServiceBusMessageId (consumer) 常量: MESSAGE_ID | 获取消息的标识符。 | 字符串 | |
| CamelAzureServiceBusPartitionKey (consumer) 常量: PARTITION_KEY | 获取向分区实体发送消息的分区密钥。 | 字符串 | |
| CamelAzureServiceBusRawAmqpMessage (consumer) 常量: RAW_AMQP_MESSAGE | AMQP 协议定义的消息表示。 | AmqpAnnotatedMessage | |
| CamelAzureServiceBusReplyTo (consumer) 常数: REPLY_TO | 获取要发送回复的实体地址。 | 字符串 | |
| CamelAzureServiceBusReplyToSessionId (consumer) | 获取或设置增加 ReplyTo 地址的会话标识符。 | 字符串 | |
| CamelAzureServiceBusSequenceNumber (consumer) 常数: SEQUENCE_NUMBER | 获取由服务总线分配给消息的唯一数字。 | long | |
| CamelAzureServiceBusSessionId (consumer) 常数: SESSION_ID | 获取消息的会话 ID。 | 字符串 | |
| CamelAzureServiceBusSubject (consumer) 常量:SUB JECT | 获取邮件的主题。 | 字符串 | |
| CamelAzureServiceBusTimeToLive (consumer) 常数: TIME_TO_LIVE | 获得此消息过期前的持续时间。 | Duration | |
| CamelAzureServiceBusTo (consumer) 常数: TO | 获取地址。 | 字符串 | |
| CamelAzureServiceBusScheduledEnqueueTime (common) | (producer)覆盖 OffsetDateTime,其中消息应出现在服务总线队列或主题中。(consumer)获取此消息的调度队列时间。 | OffsetDateTime | |
| CamelAzureServiceBusServiceBusTransactionContext (producer) | 覆盖服务中的事务。此对象仅包含事务 ID。 | ServiceBusTransactionContext | |
| CamelAzureServiceBusProducerOperation (producer) | 覆盖要在制作者中使用的所需操作。 Enum 值:
| ServiceBusProducerOperationDefinition |
9.5.1. 消息正文 复制链接链接已复制到粘贴板!
在制作者中,此组件接受 String type 或 List<String> 的消息正文来发送批处理消息。
在消费者中,返回的消息正文将是 'String。
9.5.2. Azure ServiceBus Producer 操作 复制链接链接已复制到粘贴板!
| 操作 | 描述 |
|---|---|
|
| 使用批处理方法向服务总线队列或主题发送一组消息。 |
|
| 向此发送者连接的 Azure Service Bus 实体发送调度的消息。调度的消息已排队,且仅在调度的 enqueue 时间提供给接收器。 |
9.5.3. Azure ServiceBus Consumer 操作 复制链接链接已复制到粘贴板!
| 操作 | 描述 |
|---|---|
|
| 接收来自 Service Bus 实体的 <b>infinite</b> 流。 |
|
| 在不更改接收器或消息源的状态的情况下读取下一个活动消息批处理。 |
9.5.3.1. 例子 复制链接链接已复制到粘贴板!
-
sendMessages
-
scheduleMessages
-
receiveMessages
from("azure-servicebus:test//?connectionString=test")
.log("${body}")
.to("mock:result");
from("azure-servicebus:test//?connectionString=test")
.log("${body}")
.to("mock:result");
-
peekMessages
from("azure-servicebus:test//?connectionString=test&consumerOperation=peekMessages&peekNumMaxMessages=3")
.log("${body}")
.to("mock:result");
from("azure-servicebus:test//?connectionString=test&consumerOperation=peekMessages&peekNumMaxMessages=3")
.log("${body}")
.to("mock:result");
9.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 azure-servicebus 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-azure-servicebus-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-azure-servicebus-starter</artifactId>
</dependency>
组件支持 26 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.azure-servicebus.amqp-retry-options | 为服务总线客户端设置重试选项。如果没有指定,则使用默认的重试选项。选项是一个 com.azure.core.amqp.AmqpRetryOptions 类型。 | AmqpRetryOptions | |
| camel.component.azure-servicebus.amqp-transport-type | 设置发生与 Azure Service Bus 的所有通信的传输类型。默认值为 AmqpTransportType114AMQP。 | AmqpTransportType | |
| camel.component.azure-servicebus.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.azure-servicebus.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.azure-servicebus.client-options | 设置要从这个构建器构建的客户端发送的 ClientOptions,启用自定义某些属性,并支持添加自定义标头信息。如需更多信息,请参阅 ClientOptions 文档。选项是一个 com.azure.core.util.ClientOptions 类型。 | ClientOptions | |
| camel.component.azure-servicebus.configuration | 组件配置。选项是一个 org.apache.camel.component.azure.servicebus.ServiceBusConfiguration 类型。 | ServiceBusConfiguration | |
| camel.component.azure-servicebus.connection-string | 为服务总线命名空间或特定服务总线资源设置连接字符串。 | 字符串 | |
| camel.component.azure-servicebus.consumer-operation | 设置要在消费者中使用的所需操作。 | ServiceBusConsumerOperationDefinition | |
| camel.component.azure-servicebus.disable-auto-complete | 禁用收到消息的自动完成和自动启用。默认情况下,成功处理的消息为 \\{link ServiceBusReceiverAsyncClientöcomplete (ServiceBusReceivedMessage) completed}。如果在处理消息时发生错误,它将是 \\{link ServiceBusReceiverAsyncClientöabandon (ServiceBusReceivedMessage) abandoned}。 | false | 布尔值 |
| camel.component.azure-servicebus.enabled | 是否启用 azure-servicebus 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.azure-servicebus.fully-qualified-namespace | 服务总线的完全限定域名。 | 字符串 | |
| camel.component.azure-servicebus.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.azure-servicebus.max-auto-lock-renew-duration | 设置继续自动更新锁定的时间。设置 Duration114ZERO 或 null 可禁用自动续订。对于 \\{link ServiceBusReceiveModeCEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,禁用自动续订。选项是一个 java.time.Duration 类型。 | Duration | |
| camel.component.azure-servicebus.peek-num-max-messages | 设置在 peek 操作期间要显示的最大消息数。 | 整数 | |
| camel.component.azure-servicebus.prefetch-count | 设置接收方的 prefetch 计数。对于 \\{link ServiceBusReceiveModeHQPEEK_LOCK PEEK_LOCK} 和 \\{link ServiceBusReceiveModeDSRECEIVE_AND_DELETE RECEIVE_AND_DELETE} 模式,默认值为 1。Prefetch 通过模拟在应用使用 ServiceBusReceiverAsyncClient receiveMessages ()请求一个消息之前,为本地检索提供消息流速度。设置非零值将预先获取该消息的数量。将值设为零关闭。 | 整数 | |
| camel.component.azure-servicebus.producer-operation | 设置要在制作者中使用的所需操作。 | ServiceBusProducerOperationDefinition | |
| camel.component.azure-servicebus.proxy-options | 设置用于 ServiceBusSenderAsyncClient 的代理配置。配置代理后,必须将 AmqpTransportTypetransAMQP_WEB_SOCKETS 用于传输类型。选项是一个 com.azure.core.amqp.ProxyOptions 类型。 | ProxyOptions | |
| camel.component.azure-servicebus.receiver-async-client | 设置 receiverAsyncClient,以便消费者使用消息。选项是一个 com.azure.messaging.servicebus.ServiceBusReceiverAsyncClient 类型。 | ServiceBusReceiverAsyncClient | |
| camel.component.azure-servicebus.scheduled-enqueue-time | 设置 OffsetDateTime,其中消息应出现在服务总线队列或主题中。选项是一个 java.time.OffsetDateTime 类型。 | OffsetDateTime | |
| camel.component.azure-servicebus.sender-async-client | 设置在制作者中使用的 SenderAsyncClient。选项是一个 com.azure.messaging.servicebus.ServiceBusSenderAsyncClient 类型。 | ServiceBusSenderAsyncClient | |
| camel.component.azure-servicebus.service-bus-receive-mode | 为接收方设置接收模式。 | ServiceBusReceiveMode | |
| camel.component.azure-servicebus.service-bus-transaction-context | 代表服务中的事务。此对象仅包含事务 ID。选项是一个 com.azure.messaging.servicebus.ServiceBusTransactionContext 类型。 | ServiceBusTransactionContext | |
| camel.component.azure-servicebus.service-bus-type | 要执行的连接类型。队列用于典型的队列选项,以及基于订阅模型的主题。 | ServiceBusType | |
| camel.component.azure-servicebus.sub-queue | 设置要连接的 SubQueue 的类型。 | SubQueue | |
| camel.component.azure-servicebus.subscription-name | 设置主题中的订阅名称,以侦听。还必须设置 topicOrQueueName 和 serviceBusType=topic。如果 serviceBusType=topic 和使用使用者,则需要此属性。 | 字符串 | |
| camel.component.azure-servicebus.token-credential | 用于 Azure AD 身份验证的 TokenCredential,在 com.azure.identity 中实现。选项是一个 com.azure.core.credential.TokenCredential 类型。 | TokenCredential |
第 10 章 Azure Storage Blob Service 复制链接链接已复制到粘贴板!
支持生成者和消费者
Azure Storage Blob 组件用于使用 Azure API v12 从 Azure Storage Blob Service 存储和检索 Blob。但是,如果版本 v12,我们会看到此组件是否可以根据有问题的更改量而采用这些更改。
先决条件
您必须有一个有效的 Windows Azure Storage 帐户。如需更多信息,请参阅 Azure 文档门户。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
10.1. URI 格式 复制链接链接已复制到粘贴板!
azure-storage-blob://accountName[/containerName][?options]
azure-storage-blob://accountName[/containerName][?options]
如果是使用者,则需要 accountName。如果是生成者,它取决于请求的操作,例如,如果操作位于容器级别上,例如: createContainer、accountName 和 containerName 只需要,但如果 blob 级别请求操作,例如 getBlob、accountName、containerName 和 blobName。
如果 blob 尚不存在,则会创建它。您可以以以下格式将查询选项附加到 URI 中,
?options=value&option2=value&…
10.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
10.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
10.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
10.3. 组件选项 复制链接链接已复制到粘贴板!
Azure Storage Blob Service 组件支持 31 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| blobName (common) | blob 名称,使用容器中的特定 blob。但是,在制作者上,只有 blob 级别上的操作才需要。 | 字符串 | |
| blobOffset (common) | 为上传或下载操作设置 blob 偏移,默认为 0。 | 0 | long |
| blobType (common) | blob 类型,为每个 blob 类型启动适当的设置。 Enum 值:
| blockblob | BlobType |
| closeStreamAfterRead (common) | 在读取或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| configuration (common) | 组件配置。 | BlobConfiguration | |
| credentials (common) | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。 | StorageSharedKeyCredential | |
| dataCount (common) | 范围内的字节数。如果指定,则必须大于或等于 0。 | Long | |
| fileDir (common) | 下载的 Blob 保存到的文件的目录,这可用于生成者和消费者。 | 字符串 | |
| maxResultsPerPage (common) | 指定要返回的 Blob 数量上限,包括所有 BlobPrefix 元素。如果请求没有指定 maxResultsPerPage 或指定大于 5,000 的值,服务器将返回最多 5,000 个项目。 | 整数 | |
| maxRetryRequests (common) | 指定从响应正文读取数据时将要进行的额外 HTTP 获取请求的最大数量。 | 0 | int |
| prefix (common) | 过滤结果,以仅返回名称以指定前缀开头的 Blob。可以是 null,以返回所有 Blob。 | 字符串 | |
| regex (common) | 过滤结果,以仅返回名称与指定正则表达式匹配的 Blob。如果同时设置了 prefix 和 regex,则正则表达式 可能是 null,则忽略 priority 和 prefix。 | 字符串 | |
| serviceClient (common) | Autowired Client 到存储帐户。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。它还可用于将 URL 构造到 blob 和容器。此客户端包含服务帐户的操作。容器的操作可在 BlobContainerClient via BlobServiceClient114getBlobContainerClient (String)上提供,并且 blob 上的操作可以通过 BlobContainerClient114getBlobClient (String)在 BlobClient 上提供。 | BlobServiceClient | |
| timeout (common) | 可选的超时值,超过 RuntimeException 会被引发。 | Duration | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| blobSequenceNumber (producer) | 用户控制的值,可用于跟踪请求。序列号的值必须在 0 到 263 到 1 之间。默认值为 0。 | 0 | Long |
| blockListType (producer) | 指定要返回的块类型。 Enum 值:
| 已提交 | BlockListType |
| changeFeedContext (producer) | 在使用 getChangeFeed producer 操作时,这提供了在服务调用期间通过 Http 管道传递的额外上下文。 | Context | |
| changeFeedEndTime (producer) | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在结束时间前返回事件。注: 也可以返回属于下一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回小时中的所有事件,以一小时结束时间。 | OffsetDateTime | |
| changeFeedStartTime (producer) | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在开始时间后大约返回事件。注: 也可以返回属于上一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回来自小时的所有事件,按一小时循环开始时间。 | OffsetDateTime | |
| closeStreamAfterWrite (producer) | 在写或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| commitBlockListLater (producer) | 当设置为 true 时,暂存块不会直接提交。 | true | 布尔值 |
| createAppendBlob (producer) | 当设置为 true 时,在提交附加块时将创建附加块。 | true | 布尔值 |
| createPageBlob (producer) | 当设置为 true 时,上传页面 Blob 时将创建页面 blob。 | true | 布尔值 |
| downloadLinkExpiration (producer) | 覆盖 URL 下载链接的默认过期时间(millis)。 | Long | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 可在制作者上与这个组件一起使用的 blob 操作。 Enum 值:
| listBlobContainers | BlobOperationsDefinition |
| pageBlobSize (producer) | 指定页面 blob 的最大大小,最多 8 TB。页面 blob 大小必须与 512 字节边界一致。 | 512 | Long |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| accessKey (security) | 用于连接 azure 帐户名称的访问密钥,用于使用 azure blob 服务进行身份验证。 | 字符串 | |
| sourceBlobAccessKey (security) | source Blob Access Key: 对于复制blob 操作,我们需要为源 Blob 有一个 accessKey,我们需要复制 accessKey 作为标头,因此我们可以设置为密钥。 | 字符串 |
10.4. 端点选项 复制链接链接已复制到粘贴板!
Azure Storage Blob Service 端点使用 URI 语法进行配置:
azure-storage-blob:accountName/containerName
azure-storage-blob:accountName/containerName
使用以下路径和查询参数:
10.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| accountName (common) | 用于使用 azure blob 服务进行身份验证的 Azure 帐户名称。 | 字符串 | |
| containerName (common) | blob 容器名称。 | 字符串 |
10.4.2. 查询参数(48 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| blobName (common) | blob 名称,使用容器中的特定 blob。但是,在制作者上,只有 blob 级别上的操作才需要。 | 字符串 | |
| blobOffset (common) | 为上传或下载操作设置 blob 偏移,默认为 0。 | 0 | long |
| blobServiceClient (common) | 客户端到存储帐户。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。它还可用于将 URL 构造到 blob 和容器。此客户端包含服务帐户的操作。容器的操作可以通过 getBlobContainerClient (String)在 BlobContainerClient (String)上提供,并且 BlobClient 上的操作可以通过 getBlobContainerClient (String).getBlobClient (String)获得。 | BlobServiceClient | |
| blobType (common) | blob 类型,为每个 blob 类型启动适当的设置。 Enum 值:
| blockblob | BlobType |
| closeStreamAfterRead (common) | 在读取或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| credentials (common) | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。 | StorageSharedKeyCredential | |
| dataCount (common) | 范围内的字节数。如果指定,则必须大于或等于 0。 | Long | |
| fileDir (common) | 下载的 Blob 保存到的文件的目录,这可用于生成者和消费者。 | 字符串 | |
| maxResultsPerPage (common) | 指定要返回的 Blob 数量上限,包括所有 BlobPrefix 元素。如果请求没有指定 maxResultsPerPage 或指定大于 5,000 的值,服务器将返回最多 5,000 个项目。 | 整数 | |
| maxRetryRequests (common) | 指定从响应正文读取数据时将要进行的额外 HTTP 获取请求的最大数量。 | 0 | int |
| prefix (common) | 过滤结果,以仅返回名称以指定前缀开头的 Blob。可以是 null,以返回所有 Blob。 | 字符串 | |
| regex (common) | 过滤结果,以仅返回名称与指定正则表达式匹配的 Blob。如果同时设置了 prefix 和 regex,则正则表达式 可能是 null,则忽略 priority 和 prefix。 | 字符串 | |
| serviceClient (common) | Autowired Client 到存储帐户。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。它还可用于将 URL 构造到 blob 和容器。此客户端包含服务帐户的操作。容器的操作可在 BlobContainerClient via BlobServiceClient114getBlobContainerClient (String)上提供,并且 blob 上的操作可以通过 BlobContainerClient114getBlobClient (String)在 BlobClient 上提供。 | BlobServiceClient | |
| timeout (common) | 可选的超时值,超过 RuntimeException 会被引发。 | Duration | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| blobSequenceNumber (producer) | 用户控制的值,可用于跟踪请求。序列号的值必须在 0 到 263 到 1 之间。默认值为 0。 | 0 | Long |
| blockListType (producer) | 指定要返回的块类型。 Enum 值:
| 已提交 | BlockListType |
| changeFeedContext (producer) | 在使用 getChangeFeed producer 操作时,这提供了在服务调用期间通过 Http 管道传递的额外上下文。 | Context | |
| changeFeedEndTime (producer) | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在结束时间前返回事件。注: 也可以返回属于下一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回小时中的所有事件,以一小时结束时间。 | OffsetDateTime | |
| changeFeedStartTime (producer) | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在开始时间后大约返回事件。注: 也可以返回属于上一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回来自小时的所有事件,按一小时循环开始时间。 | OffsetDateTime | |
| closeStreamAfterWrite (producer) | 在写或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| commitBlockListLater (producer) | 当设置为 true 时,暂存块不会直接提交。 | true | 布尔值 |
| createAppendBlob (producer) | 当设置为 true 时,在提交附加块时将创建附加块。 | true | 布尔值 |
| createPageBlob (producer) | 当设置为 true 时,上传页面 Blob 时将创建页面 blob。 | true | 布尔值 |
| downloadLinkExpiration (producer) | 覆盖 URL 下载链接的默认过期时间(millis)。 | Long | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 可在制作者上与这个组件一起使用的 blob 操作。 Enum 值:
| listBlobContainers | BlobOperationsDefinition |
| pageBlobSize (producer) | 指定页面 blob 的最大大小,最多 8 TB。页面 blob 大小必须与 512 字节边界一致。 | 512 | Long |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessKey (security) | 用于连接 azure 帐户名称的访问密钥,用于使用 azure blob 服务进行身份验证。 | 字符串 | |
| sourceBlobAccessKey (security) | source Blob Access Key: 对于复制blob 操作,我们需要为源 Blob 有一个 accessKey,我们需要复制 accessKey 作为标头,因此我们可以设置为密钥。 | 字符串 |
所需信息选项
要使用此组件,您需要 3 个选项来提供所需的 Azure 身份验证信息:
-
为您的 Azure 帐户提供
accountName和accessKey,这是开始的最简单方法。accessKey 可通过您的 Azure 门户生成。 -
提供 StorageSharedKeyCredential 实例,它可以提供给
凭证选项。 -
提供 BlobServiceClient 实例,它可以提供给
blobServiceClient。注: 您不需要创建特定的客户端,如 BlockBlobClient,BlobServiceClient 代表顶层,可用于检索较低级别的客户端。
10.5. 使用方法 复制链接链接已复制到粘贴板!
例如,要从 camelazure 存储帐户中的 container1 上的块 blob hello.txt 下载 blob 内容,请使用以下代码片段:
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accessKey=yourAccessKey").
to("file://blobdirectory");
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accessKey=yourAccessKey").
to("file://blobdirectory");
10.5.1. 组件制作者评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 变量名称 | 类型 | 操作 | 描述 |
|---|---|---|---|---|
|
|
|
| All | 可选的超时值,超过 {@link RuntimeException} 将引发 {@link RuntimeException}。 |
|
|
|
| 与容器和 Blob 相关的操作 | 与容器或 blob 关联的元数据。 |
|
|
|
|
|
指定此容器中的数据对公共使用的方式。如果无公共访问,传递 |
|
|
|
| 与容器和 Blob 相关的操作 | 它包含值,将限制各种请求的成功操作到存在的条件。这些条件完全是可选的。 |
|
|
|
|
| 列出特定 Blob 的详细信息 |
|
|
|
|
| 过滤结果,以仅返回名称以指定前缀开头的 Blob。可以是 null,以返回所有 Blob。 |
|
|
|
|
| 指定要返回的 Blob 数量上限,包括所有 BlobPrefix 元素。如果请求没有指定 maxResultsPerPage 或指定大于 5,000 的值,服务器将返回最多 5,000 个项目。 |
|
|
|
|
| 定义可用于配置 {@link BlobContainerClient} 对象上 listBlobsFlatSegment 的调用行为的选项。 |
|
|
|
|
| 一组操作的额外参数。 |
|
|
|
|
| 定义 AccessTier 的值。 |
|
|
|
| 与上传 Blob 相关的大多数操作 | 块内容的 MD5 哈希。此哈希用于在传输过程中验证块的完整性。当指定此标头时,存储服务会比较与此标头值到达的内容的哈希值。请注意,这个 MD5 哈希不使用 blob 存储。如果两个哈希不匹配,则操作将失败。 |
|
|
|
| 与页面 Blob 相关的操作 | {@link PageRange} 对象。假设页面必须与 512 字节界限一致,开始偏移必须是 512ulus 的 modulus,结束偏移必须是 512 - 1 的 modulus。有效字节范围的示例为 0-511、512-1023 等。 |
|
|
|
|
|
当设置为 |
|
|
|
|
|
当设置为 |
|
|
|
|
|
当设置为 |
|
|
|
|
| 指定要返回的块类型。 |
|
|
|
|
| 指定页面 blob 的最大大小,最多 8 TB。页面 blob 大小必须与 512 字节边界一致。 |
|
|
|
|
| 用户控制的值,可用于跟踪请求。序列号的值必须在 0 到 2^63 到 1 之间。默认值为 0。 |
|
|
|
|
| 指定删除此 blob 上快照的行为。\{@code Include} 将删除基本 blob 和所有快照。\{@code Only} 将只删除快照。如果快照被删除,您必须传递 null。 |
|
|
|
|
| {@link ListBlobContainersOptions},用于指定该服务应返回哪些数据。 |
|
|
|
|
| 用于下载到文件的 {@link ParallelTransferOptions}。忽略并行传输参数的数量。 |
|
|
|
|
| 下载的 Blob 将保存到的文件的目录。 |
|
|
|
|
| 覆盖 URL 下载链接的默认过期时间(millis)。 |
|
|
|
| 与 blob 相关的操作 | 覆盖/设置交换标头中的 blob 名称。 |
|
|
|
| 与容器和 Blob 相关的操作 | 覆盖/设置交换标头中的容器名称。 |
|
|
|
| All | 指定要执行的制作者操作,请参阅此页面上与制作者操作相关的 doc。 |
|
|
|
|
| 过滤结果,以仅返回名称与指定正则表达式匹配的 Blob。可以是 null 以返回所有。如果同时设置了 prefix 和 regex,则 regex 会忽略 priority 和 prefix。 |
|
|
|
|
| 它过滤结果以在开始时间后大约返回事件。注: 也可以返回属于上一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回来自小时的所有事件,按一小时循环开始时间。 |
|
|
|
|
| 它过滤结果以在结束时间之前返回事件。注: 也可以返回属于下一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回小时中的所有事件,以一小时结束时间。 |
|
|
|
|
| 这提供了在服务调用期间通过 Http 管道传递的额外上下文。 |
|
|
|
|
| 在复制 blob 操作中用作源帐户名称的源 Blob 帐户名称 |
|
|
|
|
| 在复制 blob 操作中用作源容器名称的源 Blob 容器名称 |
10.5.2. 由组件制作者或消费者设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 变量名称 | 类型 | 描述 |
|---|---|---|---|
|
|
|
| 访问 blob 的层。 |
|
|
|
| 当 blob 的访问层最后一次更改时,日期时间。 |
|
|
|
| blob 的归档状态。 |
|
|
|
| blob 创建时间。 |
|
|
|
| 页面 blob 的当前序列号。 |
|
|
|
| blob 的大小。 |
|
|
|
| blob 的类型。 |
|
|
|
| 为 blob 指定的缓存控制。 |
|
|
|
| 提交到附加 Blob 的块数 |
|
|
|
| 为 blob 指定的内容分布。 |
|
|
|
| 为 blob 指定的内容编码。 |
|
|
|
| 为 blob 指定的内容语言。 |
|
|
|
| 为 blob 指定的内容 MD5。 |
|
|
|
| 为 blob 指定的内容类型。 |
|
|
|
| 当 blob 上的最后一次复制操作完成后,日期时间。 |
|
|
|
| blob 最后一次增量副本快照的快照标识符。 |
|
|
|
| blob 上执行的最后复制操作的标识符。 |
|
|
|
| 在 blob 上执行最后一次复制操作的进度。 |
|
|
|
| 在 blob 上执行最后一次复制操作的来源。 |
|
|
|
| blob 上执行的最后复制操作的状态。 |
|
|
|
| blob 上最后一个复制操作的描述。 |
|
|
|
| blob 的 E Tag |
|
|
|
| 表示 blob 的访问层是否从 blob 的属性中推断出来的标志。 |
|
|
|
| 表示 blob 是否已递增复制的标志。 |
|
|
|
| 表示 blob 的内容是否在服务器上加密的标志。 |
|
|
|
| 当 Blob 最后一次修改时,日期时间。 |
|
|
|
| blob 上的租期类型。 |
|
|
|
| blob 上的租期状态。 |
|
|
|
| blob 上租期的状态。 |
|
|
|
| 与 blob 关联的其他元数据。 |
|
|
|
| 块提交到块 Blob 的偏移。 |
|
|
|
|
从操作下载的文件名 |
|
|
|
|
由 |
|
|
|
| 返回用户可以使用的未解析 httpHeaders。 |
10.5.3. 高级 Azure Storage Blob 配置 复制链接链接已复制到粘贴板!
如果您的 Camel 应用程序在防火墙后面运行,或者需要对 BlobServiceClient 实例配置拥有更多控制,您可以创建自己的实例:
然后,在 Camel azure-storage-blob 组件配置中引用这个实例:
from("azure-storage-blob://cameldev/container1?blobName=myblob&serviceClient=#client")
.to("mock:result");
from("azure-storage-blob://cameldev/container1?blobName=myblob&serviceClient=#client")
.to("mock:result");
10.5.4. 在 registry 中自动检测 BlobServiceClient 客户端 复制链接链接已复制到粘贴板!
组件能够检测 registry 中的 BlobServiceClient bean 存在。如果这是该类型的唯一实例,它将用作客户端,并且您不必将其定义为 uri 参数,如上例所示。这对端点的智能配置可能非常有用。
10.5.5. Azure Storage Blob Producer 操作 复制链接链接已复制到粘贴板!
Camel Azure Storage Blob 组件在制作者端提供广泛的操作:
对服务级别的操作
对于这些操作,需要 accountName。
| 操作 | 描述 |
|---|---|
|
| 获取 blob 的内容。您可以将此操作的输出限制为 blob 范围。 |
|
| 返回对存储帐户中的 blob 和 blob 元数据的所有更改的事务日志。更改源提供这些更改的排序、保证、持久性、不可变、只读日志。 |
容器级别的操作
对于这些操作,需要 accountName 和 containerName。
| 操作 | 描述 |
|---|---|
|
| 在存储帐户中创建新容器。如果存在具有相同名称的容器,则制作者将忽略它。 |
|
| 删除存储帐户中指定的容器。如果容器不存在,则操作会失败。 |
|
| 返回此容器中的 blob 列表,文件夹结构扁平化。 |
对 blob 级别的操作
对于这些操作,需要 accountName、containerName 和 blobName。
| 操作 | blob 类型 | 描述 |
|---|---|---|
|
| Common | 获取 blob 的内容。您可以将此操作的输出限制为 blob 范围。 |
|
| Common | 删除 blob。 |
|
| Common | 将整个 blob 下载到路径指定的文件中。如果文件已存在 {@link FileAlreadyExistsException},则该文件必须不存在。 |
|
| Common | 使用共享访问令牌(SAS)为指定的 blob 生成下载链接。默认情况下,仅允许 1 小时访问。但是,您可以通过标头覆盖默认的过期持续时间。 |
|
| BlockBlob | 创建新的块 blob,或更新现有块 Blob 的内容。更新现有块 Blob 覆盖 blob 上的任何现有元数据。PutBlob 不支持部分更新,现有 Blob 的内容会被新内容覆盖。 |
|
|
|
将指定块上传到块 blob 的"staging 区域",以便稍后由对 commitBlobBlockList 的调用提交。但是,如果标头 |
|
|
|
通过指定要组成 blob 的块 ID 列表来写入 blob。为了作为 blob 的一部分编写,必须在之前的 |
|
|
| 使用指定的块列表过滤器返回作为块 blob 的一部分上传的块列表。 |
|
|
| 创建 0-length 附加 blob。调用 commitAppendBlo'b 操作,将数据附加到附加 Blob。 |
|
|
|
向现有附加 Blob 末尾提交一个新的数据块。如果标头 |
|
|
|
创建指定长度的页面 blob。调用 |
|
|
|
将一个或多个页面写入页面 blob。写入大小必须是 512 的倍数。如果标头 |
|
|
| 将页面 blob 调整为指定大小(必须是 512 的倍数)。 |
|
|
| 从页面 blob 中释放指定的页面。范围的大小必须是 512 的倍数。 |
|
|
| 返回页面 blob 或页面 blob 快照的有效页面范围列表。 |
|
|
| 将 blob 从一个容器复制到另一个容器,即使来自不同帐户。 |
请参阅此页面中的示例部分,了解如何在 camel 应用程序中使用这些操作。
10.5.6. 消费者示例 复制链接链接已复制到粘贴板!
要使用文件组件将 blob 消耗到文件中,如下所示:
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey").
to("file://blobdirectory");
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey").
to("file://blobdirectory");
但是,您还可以直接在不使用文件组件的情况下写入文件,您需要指定 fileDir 文件夹路径,以便在您的机器中保存 blob。
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");
from("azure-storage-blob://camelazure/container1?blobName=hello.txt&accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");
另外,组件支持批处理消费者,因此您可以消耗多个 Blob,它只指定容器名称,使用者将根据容器中的 Blob 数量返回多个交换。
示例
from("azure-storage-blob://camelazure/container1?accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");
from("azure-storage-blob://camelazure/container1?accountName=yourAccountName&accessKey=yourAccessKey&fileDir=/var/to/awesome/dir").
to("mock:results");
10.5.7. 生成者操作示例 复制链接链接已复制到粘贴板!
-
listBlobContainers
-
createBlobContainer
-
deleteBlobContainer:
-
listBlobs:
-
getBlob:
我们都可以在交换正文中设置 outputStream,并将数据写入其中。例如:
如果没有设置正文,则此操作将为我们提供一个 InputStream 实例,以便进一步下游:
-
deleteBlob:
-
下载BlobToFile:
-
downloadLink
-
uploadBlockBlob
-
stageBlockBlobList
-
commitBlockBlobList
-
getBlobBlockList
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getBlobBlockList&serviceClient=#client")
.log("${body}")
.to("mock:result");
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=getBlobBlockList&serviceClient=#client")
.log("${body}")
.to("mock:result");
-
createAppendBlob
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createAppendBlob&serviceClient=#client")
.to("mock:result");
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createAppendBlob&serviceClient=#client")
.to("mock:result");
-
commitAppendBlob
-
createPageBlob
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createPageBlob&serviceClient=#client")
.to("mock:result");
from("direct:start")
.to("azure-storage-blob://camelazure/container1?blobName=blob&operation=createPageBlob&serviceClient=#client")
.to("mock:result");
-
uploadPageBlob
-
resizePageBlob
-
clearPageBlob
-
getPageBlobRanges
-
copyBlob
这样,帐户 'account' 的容器容器容器中的 file.txt 将被复制到同一帐户的容器容器blob2 中。
10.5.8. 开发备注(Important) 复制链接链接已复制到粘贴板!
所有集成测试都使用 Testcontainers 并运行。需要获取 Azure accessKey 和 accountName 才能使用 Azure 服务运行所有集成测试。除了模拟单元测试外,还需要使用您进行的每个更改来运行集成测试,甚至客户端升级,因为 Azure 客户端可能会在次版本升级时破坏问题。要运行集成测试,在这个组件目录中运行以下 maven 命令:
mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey
mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey
其中by accountName 是您的 Azure 帐户名称,accessKey 是从 Azure 门户生成的访问密钥。
10.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 azure-storage-blob 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-azure-storage-blob-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-azure-storage-blob-starter</artifactId>
</dependency>
组件支持 32 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.azure-storage-blob.access-key | 用于连接 azure 帐户名称的访问密钥,用于使用 azure blob 服务进行身份验证。 | 字符串 | |
| camel.component.azure-storage-blob.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.azure-storage-blob.blob-name | blob 名称,使用容器中的特定 blob。但是,在制作者上,只有 blob 级别上的操作才需要。 | 字符串 | |
| camel.component.azure-storage-blob.blob-offset | 为上传或下载操作设置 blob 偏移,默认为 0。 | 0 | Long |
| camel.component.azure-storage-blob.blob-sequence-number | 用户控制的值,可用于跟踪请求。序列号的值必须在 0 到 263 到 1 之间。默认值为 0。 | 0 | Long |
| camel.component.azure-storage-blob.blob-type | blob 类型,为每个 blob 类型启动适当的设置。 | BlobType | |
| camel.component.azure-storage-blob.block-list-type | 指定要返回的块类型。 | BlockListType | |
| camel.component.azure-storage-blob.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.azure-storage-blob.change-feed-context | 在使用 getChangeFeed producer 操作时,这提供了在服务调用期间通过 Http 管道传递的额外上下文。选项是一个 com.azure.core.util.Context 类型。 | Context | |
| camel.component.azure-storage-blob.change-feed-end-time | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在结束时间前返回事件。注: 也可以返回属于下一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回小时中的所有事件,以一小时结束时间。选项是一个 java.time.OffsetDateTime 类型。 | OffsetDateTime | |
| camel.component.azure-storage-blob.change-feed-start-time | 使用 getChangeFeed producer 操作时,这将过滤结果,以便在开始时间后大约返回事件。注: 也可以返回属于上一个小时的一些事件。属于此小时的几个事件可能会缺失;为了确保返回来自小时的所有事件,按一小时循环开始时间。选项是一个 java.time.OffsetDateTime 类型。 | OffsetDateTime | |
| camel.component.azure-storage-blob.close-stream-after-read | 在读取或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| camel.component.azure-storage-blob.close-stream-after-write | 在写或保持打开后关闭流,默认为 true。 | true | 布尔值 |
| camel.component.azure-storage-blob.commit-block-list-later | 当设置为 true 时,暂存块不会直接提交。 | true | 布尔值 |
| camel.component.azure-storage-blob.configuration | 组件配置。选项是一个 org.apache.camel.component.azure.storage.blob.BlobConfiguration 类型。 | BlobConfiguration | |
| camel.component.azure-storage-blob.create-append-blob | 当设置为 true 时,在提交附加块时将创建附加块。 | true | 布尔值 |
| camel.component.azure-storage-blob.create-page-blob | 当设置为 true 时,上传页面 Blob 时将创建页面 blob。 | true | 布尔值 |
| camel.component.azure-storage-blob.credentials | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。选项是一个 com.azure.storage.common.StorageSharedKeyCredential 类型。 | StorageSharedKeyCredential | |
| camel.component.azure-storage-blob.data-count | 范围内的字节数。如果指定,则必须大于或等于 0。 | Long | |
| camel.component.azure-storage-blob.download-link-expiration | 覆盖 URL 下载链接的默认过期时间(millis)。 | Long | |
| camel.component.azure-storage-blob.enabled | 是否启用 azure-storage-blob 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.azure-storage-blob.file-dir | 下载的 Blob 保存到的文件的目录,这可用于生成者和消费者。 | 字符串 | |
| camel.component.azure-storage-blob.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.azure-storage-blob.max-results-per-page | 指定要返回的 Blob 数量上限,包括所有 BlobPrefix 元素。如果请求没有指定 maxResultsPerPage 或指定大于 5,000 的值,服务器将返回最多 5,000 个项目。 | 整数 | |
| camel.component.azure-storage-blob.max-retry-requests | 指定从响应正文读取数据时将要进行的额外 HTTP 获取请求的最大数量。 | 0 | 整数 |
| camel.component.azure-storage-blob.operation | 可在制作者上与这个组件一起使用的 blob 操作。 | BlobOperationsDefinition | |
| camel.component.azure-storage-blob.page-blob-size | 指定页面 blob 的最大大小,最多 8 TB。页面 blob 大小必须与 512 字节边界一致。 | 512 | Long |
| camel.component.azure-storage-blob.prefix | 过滤结果,以仅返回名称以指定前缀开头的 Blob。可以是 null,以返回所有 Blob。 | 字符串 | |
| camel.component.azure-storage-blob.regex | 过滤结果,以仅返回名称与指定正则表达式匹配的 Blob。如果同时设置了 prefix 和 regex,则正则表达式 可能是 null,则忽略 priority 和 prefix。 | 字符串 | |
| camel.component.azure-storage-blob.service-client | 客户端到存储帐户。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。它还可用于将 URL 构造到 blob 和容器。此客户端包含服务帐户的操作。容器的操作可在 BlobContainerClient via BlobServiceClient114getBlobContainerClient (String)上提供,并且 blob 上的操作可以通过 BlobContainerClient114getBlobClient (String)在 BlobClient 上提供。选项是一个 com.azure.storage.blob.BlobServiceClient 类型。 | BlobServiceClient | |
| camel.component.azure-storage-blob.source-blob-access-key | source Blob Access Key: 对于复制blob 操作,我们需要为源 Blob 有一个 accessKey,我们需要复制 accessKey 作为标头,因此我们可以设置为密钥。 | 字符串 | |
| camel.component.azure-storage-blob.timeout | 可选的超时值,超过 RuntimeException 会被引发。选项是一个 java.time.Duration 类型。 | Duration |
第 11 章 Azure Storage Queue Service 复制链接链接已复制到粘贴板!
支持生成者和消费者
Azure Storage Queue 组件支持使用 Azure APIs v12,将信息存储和检索到 Azure Storage Queue 服务。但是,如果版本 v12,我们会看到此组件是否可以根据有问题的更改量而采用这些更改。
先决条件
您必须有一个有效的 Windows Azure Storage 帐户。如需更多信息,请参阅 Azure 文档门户。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
11.1. URI 格式 复制链接链接已复制到粘贴板!
azure-storage-queue://accountName[/queueName][?options]
azure-storage-queue://accountName[/queueName][?options]
如果是 consumer,则需要 accountName 和 queueName。如果是生成者,它取决于请求的操作,例如,如果操作位于服务级别上,例如:listQueues,仅需要 accountName,但在队列级别上请求 operationName,如 createQueue、sendMessage. 等,则需要 accountName 和 queueName。
如果队列尚不存在,则会创建队列。您可以以以下格式将查询选项附加到 URI 中,
?options=value&option2=value&…
11.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
11.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
11.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
11.3. 组件选项 复制链接链接已复制到粘贴板!
Azure Storage Queue Service 组件支持 15 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| configuration (common) | 组件配置。 | QueueConfiguration | |
| serviceClient (common) | Autowired Service 客户端到存储帐户,以便与队列服务交互。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。此客户端包含与 Azure Storage 中的队列帐户交互的所有操作。客户端允许的操作正在创建、列出和删除队列、检索和更新帐户的属性,以及检索帐户统计信息。 | QueueServiceClient | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| createQueue (producer) | 当设置为 true 时,在发送消息到队列时会自动创建队列。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 队列服务操作提示到制作者。 Enum 值:
| QueueOperationDefinition | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| maxMessages (queue) | 如果队列中存在比请求所有消息少的消息数量,则需要获取的最大消息数。如果只检索空 1 个消息,则允许的范围为 1 到 32 个消息。 | 1 | 整数 |
| messageId (queue) | 要删除或更新的消息的 ID。 | 字符串 | |
| popReceipt (queue) | 必须匹配的唯一标识符才能删除或更新消息。 | 字符串 | |
| Timeout (queue) | 应用到操作的可选超时。如果在超时结束前未返回响应,则会抛出 RuntimeException。 | Duration | |
| timeToLive (queue) | 消息将在队列中保持活跃的时长。如果未设置该值,则默认值为 7 天,如果 -1 传递,则消息不会过期。生存时间必须是 -1 或任意正数。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。 | Duration | |
| visibilityTimeout (queue) | 消息在队列中不可见的超时时间。超时时间必须在 1 秒和 7 天之间。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。 | Duration | |
| accessKey (security) | 用于连接 azure 帐户名称的访问密钥,用于使用 azure 队列服务进行身份验证。 | 字符串 | |
| 凭证 (安全) | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。 | StorageSharedKeyCredential |
11.4. 端点选项 复制链接链接已复制到粘贴板!
Azure Storage Queue Service 端点使用 URI 语法进行配置:
azure-storage-queue:accountName/queueName
azure-storage-queue:accountName/queueName
使用以下路径和查询参数:
11.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| accountName (common) | 用于使用 azure 队列服务进行身份验证的 Azure 帐户名称。 | 字符串 | |
| queueName (common) | 队列资源名称。 | 字符串 |
11.4.2. 查询参数(31 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| serviceClient (common) | Autowired Service 客户端到存储帐户,以便与队列服务交互。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。此客户端包含与 Azure Storage 中的队列帐户交互的所有操作。客户端允许的操作正在创建、列出和删除队列、检索和更新帐户的属性,以及检索帐户统计信息。 | QueueServiceClient | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| createQueue (producer) | 当设置为 true 时,在发送消息到队列时会自动创建队列。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| operation (producer) | 队列服务操作提示到制作者。 Enum 值:
| QueueOperationDefinition | |
| maxMessages (queue) | 如果队列中存在比请求所有消息少的消息数量,则需要获取的最大消息数。如果只检索空 1 个消息,则允许的范围为 1 到 32 个消息。 | 1 | 整数 |
| messageId (queue) | 要删除或更新的消息的 ID。 | 字符串 | |
| popReceipt (queue) | 必须匹配的唯一标识符才能删除或更新消息。 | 字符串 | |
| Timeout (queue) | 应用到操作的可选超时。如果在超时结束前未返回响应,则会抛出 RuntimeException。 | Duration | |
| timeToLive (queue) | 消息将在队列中保持活跃的时长。如果未设置该值,则默认值为 7 天,如果 -1 传递,则消息不会过期。生存时间必须是 -1 或任意正数。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。 | Duration | |
| visibilityTimeout (queue) | 消息在队列中不可见的超时时间。超时时间必须在 1 秒和 7 天之间。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。 | Duration | |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessKey (security) | 用于连接 azure 帐户名称的访问密钥,用于使用 azure 队列服务进行身份验证。 | 字符串 | |
| 凭证 (安全) | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。 | StorageSharedKeyCredential |
所需信息选项
要使用此组件,您需要 3 个选项来提供所需的 Azure 身份验证信息:
-
为您的 Azure 帐户提供
accountName和accessKey,这是开始的最简单方法。accessKey 可通过您的 Azure 门户生成。 -
提供 StorageSharedKeyCredential 实例,它可以提供给
凭证选项。 -
提供 QueueServiceClient 实例,它可以提供给
serviceClient。注: 您不需要创建特定的客户端,如 QueueClient,QueueServiceClient 代表可用于检索较低级别的客户端。
11.5. 使用方法 复制链接链接已复制到粘贴板!
例如,若要从 storageAccount 存储帐户中的队列 消息Queue 获取消息内容,请使用以下代码片段:
from("azure-storage-queue://storageAccount/messageQueue?accessKey=yourAccessKey").
to("file://queuedirectory");
from("azure-storage-queue://storageAccount/messageQueue?accessKey=yourAccessKey").
to("file://queuedirectory");
11.5.1. 组件制作者评估的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 变量名称 | 类型 | 操作 | 描述 |
|---|---|---|---|---|
|
|
|
|
| 列出队列的选项 |
|
|
|
| All | 可选的超时值,超过 \{@link RuntimeException} 将引发。 |
|
|
|
|
| 与队列关联的元数据 |
|
|
|
|
| 消息将在队列中保持活跃的时长。如果未设置该值,则默认值为 7 天,如果 -1 传递,则消息不会过期。生存时间必须是 -1 或任意正数。 |
|
|
|
|
| 消息在队列中不可见的超时时间。如果未设置该值,则消息将立即可见。超时时间必须在 0 秒和 7 天之间。 |
|
|
|
|
|
当设置为 |
|
|
|
|
| 必须匹配的唯一标识符才能删除或更新消息。 |
|
|
|
|
| 要删除或更新的消息的 ID。 |
|
|
|
|
| 如果队列中存在比请求所有消息少的消息数量,则需要获取的最大消息数。如果只检索空 1 个消息,则允许的范围为 1 到 32 个消息。 |
|
|
|
| All | 指定要执行的制作者操作,请参阅此页面上与制作者操作相关的 doc。 |
|
|
|
| All | 覆盖队列名称。 |
11.5.2. 由组件制作者或消费者设置的消息标头 复制链接链接已复制到粘贴板!
| 标头 | 变量名称 | 类型 | 描述 |
|---|---|---|---|
|
|
|
| 发送到队列的消息 ID。 |
|
|
|
| 消息插入到 Queue 的时间。 |
|
|
|
| 消息将过期并自动删除的时间。 |
|
|
|
| 删除/更新消息需要这个值。如果删除失败,则此弹出信息已被另一个客户端取消队列。 |
|
|
|
| 消息再次在 Queue 中可见的时间。 |
|
|
|
| 消息被取消队列的次数。 |
|
|
|
| 返回用户可以使用的未解析 httpHeaders。 |
11.5.3. 高级 Azure Storage Queue 配置 复制链接链接已复制到粘贴板!
如果您的 Camel 应用程序在防火墙后面运行,或者需要对 QueueServiceClient 实例配置拥有更多控制,您可以创建自己的实例:
然后,在 Camel azure-storage-queue 组件配置中引用这个实例:
from("azure-storage-queue://cameldev/queue1?serviceClient=#client")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");
from("azure-storage-queue://cameldev/queue1?serviceClient=#client")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");
11.5.4. 在 registry 中自动检测 QueueServiceClient 客户端 复制链接链接已复制到粘贴板!
组件能够检测将 QueueServiceClient bean 是否存在到 registry 中。如果这是该类型的唯一实例,它将用作客户端,并且您不必将其定义为 uri 参数,如上例所示。这对端点的智能配置可能非常有用。
11.5.5. Azure Storage Queue Producer 操作 复制链接链接已复制到粘贴板!
Camel Azure Storage Queue 组件在制作者端提供广泛的操作:
对服务级别的操作
对于这些操作,需要 accountName。
| 操作 | 描述 |
|---|---|
|
| 列出存储帐户中从指定标记开始的过滤器的队列。 |
对队列级别的操作
对于这些操作,需要 accountName 和 queueName。
| 操作 | 描述 |
|---|---|
|
| 创建新队列。 |
|
| 永久删除队列。 |
|
| 删除队列中的所有消息。 |
|
|
默认 Producer 操作 会发送一个带有给定生存时间的消息,以及消息在队列中不可见的超时周期。消息文本从交换消息正文评估。默认情况下,如果队列不存在,它将首先创建一个空队列。如果要禁用此功能,请将 config |
|
| 删除队列中指定的消息。 |
|
| 最多从队列检索最大消息数,并从超时时间的其他操作中隐藏它们。但是,由于可靠性的原因,它不会将消息从队列中分离。 |
|
| 来自队列前面的消息,最高到消息的最大数量。 |
|
| 使用新消息更新队列中的特定消息,并重置可见性超时。消息文本从交换消息正文评估。 |
请参阅此页面中的示例部分,了解如何在 camel 应用程序中使用这些操作。
11.5.6. 消费者示例 复制链接链接已复制到粘贴板!
要在一个批处理中最多 5 个消息的文件中消耗队列,如下所示:
from("azure-storage-queue://cameldev/queue1?serviceClient=#client&maxMessages=5")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");
from("azure-storage-queue://cameldev/queue1?serviceClient=#client&maxMessages=5")
.to("file://outputFolder?fileName=output.txt&fileExist=Append");
11.5.7. 生成者操作示例 复制链接链接已复制到粘贴板!
-
listQueues:
-
createQueue:
-
deleteQueue:
-
清除Queue:
-
sendMessage:
-
deleteMessage:
-
receiveMessages:
-
peekMessages:
-
updateMessage:
11.5.8. 开发备注(Important) 复制链接链接已复制到粘贴板!
在此组件上开发时,您需要获取 Azure accessKey 才能运行集成测试。除了模拟单元测试外,还需要使用您进行的每个更改来运行集成测试,甚至客户端升级,因为 Azure 客户端可能会在次版本升级时破坏问题。要运行集成测试,在这个组件目录中运行以下 maven 命令:
mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey
mvn verify -PfullTests -DaccountName=myacc -DaccessKey=mykey
其中by accountName 是您的 Azure 帐户名称,accessKey 是从 Azure 门户生成的访问密钥。
11.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 azure-storage-queue 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-azure-storage-queue-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-azure-storage-queue-starter</artifactId>
</dependency>
组件支持 16 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.azure-storage-queue.access-key | 用于连接 azure 帐户名称的访问密钥,用于使用 azure 队列服务进行身份验证。 | 字符串 | |
| camel.component.azure-storage-queue.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.azure-storage-queue.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.azure-storage-queue.configuration | 组件配置。选项是一个 org.apache.camel.component.azure.storage.queue.QueueConfiguration 类型。 | QueueConfiguration | |
| camel.component.azure-storage-queue.create-queue | 当设置为 true 时,在发送消息到队列时会自动创建队列。 | false | 布尔值 |
| camel.component.azure-storage-queue.credentials | 可以注入 StorageSharedKeyCredential 来创建 azure 客户端,这包含重要的身份验证信息。选项是一个 com.azure.storage.common.StorageSharedKeyCredential 类型。 | StorageSharedKeyCredential | |
| camel.component.azure-storage-queue.enabled | 是否启用 azure-storage-queue 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.azure-storage-queue.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.azure-storage-queue.max-messages | 如果队列中存在比请求所有消息少的消息数量,则需要获取的最大消息数。如果只检索空 1 个消息,则允许的范围为 1 到 32 个消息。 | 1 | 整数 |
| camel.component.azure-storage-queue.message-id | 要删除或更新的消息的 ID。 | 字符串 | |
| camel.component.azure-storage-queue.operation | 队列服务操作提示到制作者。 | QueueOperationDefinition | |
| camel.component.azure-storage-queue.pop-receipt | 必须匹配的唯一标识符才能删除或更新消息。 | 字符串 | |
| camel.component.azure-storage-queue.service-client | 服务客户端到存储帐户,以便与队列服务交互。此客户端不包含有关特定存储帐户的状态,而是便捷地将适当的请求发送到该服务上的资源。此客户端包含与 Azure Storage 中的队列帐户交互的所有操作。客户端允许的操作正在创建、列出和删除队列、检索和更新帐户的属性,以及检索帐户统计信息。选项是一个 com.azure.storage.queue.QueueServiceClient 类型。 | QueueServiceClient | |
| camel.component.azure-storage-queue.time-to-live | 消息将在队列中保持活跃的时长。如果未设置该值,则默认值为 7 天,如果 -1 传递,则消息不会过期。生存时间必须是 -1 或任意正数。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。选项是一个 java.time.Duration 类型。 | Duration | |
| camel.component.azure-storage-queue.timeout | 应用到操作的可选超时。如果在超时结束前未返回响应,则会抛出 RuntimeException。选项是一个 java.time.Duration 类型。 | Duration | |
| camel.component.azure-storage-queue.visibility-timeout | 消息在队列中不可见的超时时间。超时时间必须在 1 秒和 7 天之间。格式应为 20.345 秒:PnDTnHnMn.nS.,例如:PT20.345S 345- parses 为 20.345,因为这些 Java API 是类型safe。选项是一个 java.time.Duration 类型。 | Duration |
第 12 章 bean 复制链接链接已复制到粘贴板!
仅支持生成者
Bean 组件将 Bean 绑定到 Camel 消息交换。
12.1. URI 格式 复制链接链接已复制到粘贴板!
bean:beanName[?options]
bean:beanName[?options]
其中 beanID 可以是用于在 Registry 中查找 bean 的任何字符串
12.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
12.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
12.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
12.3. 组件选项 复制链接链接已复制到粘贴板!
Bean 组件支持 4 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| cache (producer) | 弃用了 使用单例选项。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| scope (producer) | bean 范围。使用单例范围(默认) 时,仅创建或只查找一次,并在端点生命周期内重复使用一次。如果并发线程同时调用 bean,则 bean 应该是 thread-safe。在使用请求范围时,根据请求创建或查找一次(交换)。如果您要在处理请求时将状态存储在 bean 中,且您希望在处理请求时多次调用同一 bean 实例,则可以使用此项。bean 不必线程安全,因为实例仅从同一请求调用。在使用委派范围时,将根据调用查找或创建 bean。但是,如果查找,则这会被委派给 bean registry,如 Spring 或 CDI (如果使用),这依赖于它们的配置,也可以作为单例范围或与之分配的范围。因此,这取决于委派的 registry。 Enum 值:
| 单例 | BeanScope |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
12.4. 端点选项 复制链接链接已复制到粘贴板!
Bean 端点使用 URI 语法进行配置:
bean:beanName
bean:beanName
使用以下路径和查询参数:
12.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| beanName (common) | 必需 设置要调用的 bean 的名称。 | 字符串 |
12.4.2. 查询参数(5 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| cache (common) | 弃用的 Use scope 选项替代。 | 布尔值 | |
| method (common) | 设置要在 bean 上调用的方法名称。 | 字符串 | |
| scope (common) | bean 范围。使用单例范围(默认) 时,仅创建或只查找一次,并在端点生命周期内重复使用一次。如果并发线程同时调用 bean,则 bean 应该是 thread-safe。在使用请求范围时,根据请求创建或查找一次(交换)。如果您要在处理请求时将状态存储在 bean 中,且您希望在处理请求时多次调用同一 bean 实例,则可以使用此项。bean 不必线程安全,因为实例仅从同一请求调用。使用过期范围时,将根据调用查找或创建 bean。但是,如果查找,则这会被委派给 bean registry,如 Spring 或 CDI (如果使用),这依赖于它们的配置,也可以作为单例范围或与之分配的范围。因此,这取决于委派的 registry。 Enum 值:
| 单例 | BeanScope |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| 参数 (advanced) | 用于在 bean 上配置附加属性。 | Map |
12.5. 使用 复制链接链接已复制到粘贴板!
用于使用消息的对象实例必须使用 Registry 显式注册。例如,如果您使用 Spring,则必须在 Spring 配置 XML 文件中定义 bean。
您还可以使用 bind 方法通过 Camel 的 Registry 手动注册 Bean。
注册端点后,您可以构建用于处理交换的 Camel 路由。
bean: 端点不能定义为路由的输入;例如,您无法从其中使用,您只能从某些入站消息端点路由到 bean 端点。因此请考虑使用 direct: 或 queue: 端点作为输入。
您可以使用 ProxyHelper 上的 createProxy () 方法创建一个代理,该代理将生成交换并将其发送到任何端点:
以及使用 XML DSL 的同一路由:
<route> <from uri="direct:hello"/> <to uri="bean:bye"/> </route>
<route>
<from uri="direct:hello"/>
<to uri="bean:bye"/>
</route>
12.6. Bean 作为端点 复制链接链接已复制到粘贴板!
Camel 还支持将 Bean 作为端点调用。这是因为当交换路由到 myBean Camel 时,使用 Bean Binding 来调用 bean。bean 的源仅是一个普通 POJO。
Camel 将使用 Bean Binding 调用声明 Hello 方法,方法是将 Exchange 的 In body 转换为 String 类型,并将方法的输出存储在 Exchange Out 正文上。
12.7. Java DSL bean 语法 复制链接链接已复制到粘贴板!
Java DSL 附带组件的总语法。您可以使用以下语法,而不是将 bean 显式指定为端点(即 (即("bean:beanName")):
您可以指定 bean 本身,而不是将名称传递给 bean (因此 Camel 将在 registry 中查找它):
12.8. Bean 绑定 复制链接链接已复制到粘贴板!
如何选择 bean 方法(如果通过 method 参数明确指定)以及如何从 Message 构建参数值由 Bean Binding 机制定义,这些机制在 Camel 中的所有 Bean 集成机制中使用。
12.9. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 bean 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-bean-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-bean-starter</artifactId>
</dependency>
组件支持 13 个选项,如下所列。
| Name | 描述 | Default(默认) | 类型 |
|---|---|---|---|
| camel.component.bean.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.bean.enabled | 是否启用 bean 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.bean.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.bean.scope | bean 范围。使用单例范围(默认) 时,仅创建或只查找一次,并在端点生命周期内重复使用一次。如果并发线程同时调用 bean,则 bean 应该是 thread-safe。在使用请求范围时,根据请求创建或查找一次(交换)。如果您要在处理请求时将状态存储在 bean 中,且您希望在处理请求时多次调用同一 bean 实例,则可以使用此项。bean 不必线程安全,因为实例仅从同一请求调用。在使用委派范围时,将根据调用查找或创建 bean。但是,如果查找,则这会被委派给 bean registry,如 Spring 或 CDI (如果使用),这依赖于它们的配置,也可以作为单例范围或与之分配的范围。因此,这取决于委派的 registry。 | BeanScope | |
| camel.component.class.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.class.enabled | 是否启用类组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.class.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.class.scope | bean 范围。使用单例范围(默认) 时,仅创建或只查找一次,并在端点生命周期内重复使用一次。如果并发线程同时调用 bean,则 bean 应该是 thread-safe。在使用请求范围时,根据请求创建或查找一次(交换)。如果您要在处理请求时将状态存储在 bean 中,且您希望在处理请求时多次调用同一 bean 实例,则可以使用此项。bean 不必线程安全,因为实例仅从同一请求调用。在使用委派范围时,将根据调用查找或创建 bean。但是,如果查找,则这会被委派给 bean registry,如 Spring 或 CDI (如果使用),这依赖于它们的配置,也可以作为单例范围或与之分配的范围。因此,这取决于委派的 registry。 | BeanScope | |
| camel.language.bean.enabled | 是否启用 bean 语言的自动配置。这默认是启用的。 | 布尔值 | |
| camel.language.bean.scope | bean 范围。使用单例范围(默认) 时,仅创建或只查找一次,并在端点生命周期内重复使用一次。如果并发线程同时调用 bean,则 bean 应该是 thread-safe。在使用请求范围时,根据请求创建或查找一次(交换)。如果您要在处理请求时将状态存储在 bean 中,且您希望在处理请求时多次调用同一 bean 实例,则可以使用此项。bean 不必线程安全,因为实例仅从同一请求调用。使用过期范围时,将根据调用查找或创建 bean。但是,如果查找,则这会被委派给 bean registry,如 Spring 或 CDI (如果使用),这取决于它们的配置可以充当单例范围,也可以充当其他范围。因此,在使用过期范围时,这取决于 bean registry 实现。 | 单例 | 字符串 |
| camel.language.bean.trim | 是否修剪值以移除前导和结尾的空格和换行符。 | true | 布尔值 |
| camel.component.bean.cache | 弃用了 使用单例选项。 | true | 布尔值 |
| camel.component.class.cache | 弃用了 使用单例选项。 | true | 布尔值 |
第 13 章 Bean Validator 复制链接链接已复制到粘贴板!
仅支持生成者
Validator 组件使用 Java Bean Validation API ()执行消息正文的 bean 验证。Camel 使用参考实施,即 Hibernate Validator。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
13.1. URI 格式 复制链接链接已复制到粘贴板!
bean-validator:label[?options]
bean-validator:label[?options]
其中 label 是描述端点的任意文本值。您可以以以下格式将查询选项附加到 URI 中,
?option=value&option=value&…
13.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
13.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
13.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
13.3. 组件选项 复制链接链接已复制到粘贴板!
Bean Validator 组件支持 8 个选项,如下所列。
| Name | 描述 | Default(默认) | 类型 |
|---|---|---|---|
| ignoreXmlConfiguration (producer) | 是否忽略 META-INF/validation.xml 文件中的数据。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| constraintValidatorFactory (advanced) | 使用自定义 ConstraintValidatorFactory。 | ConstraintValidatorFactory | |
| messageInterpolator (advanced) | 使用自定义 MessageInterpolator。 | MessageInterpolator | |
| traversableResolver (advanced) | 使用自定义 TraversableResolver。 | TraversableResolver | |
| validationProviderResolver (advanced) | 使用自定义 ValidationProviderResolver。 | ValidationProviderResolver | |
| ValidatorFactory ( advanced) | Autowired 使用自定义 ValidatorFactory。 | ValidatorFactory |
13.4. 端点选项 复制链接链接已复制到粘贴板!
Bean Validator 端点使用 URI 语法进行配置:
bean-validator:label
bean-validator:label
使用以下路径和查询参数:
13.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| label (producer) | 必需 的位置标签是描述端点的任意文本值。 | 字符串 |
13.4.2. 查询参数(8 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| group (producer) | 使用自定义验证组。 | javax.validation.groups.Default | 字符串 |
| ignoreXmlConfiguration (producer) | 是否忽略 META-INF/validation.xml 文件中的数据。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| constraintValidatorFactory (advanced) | 使用自定义 ConstraintValidatorFactory。 | ConstraintValidatorFactory | |
| messageInterpolator (advanced) | 使用自定义 MessageInterpolator。 | MessageInterpolator | |
| traversableResolver (advanced) | 使用自定义 TraversableResolver。 | TraversableResolver | |
| validationProviderResolver (advanced) | 使用自定义 ValidationProviderResolver。 | ValidationProviderResolver | |
| ValidatorFactory ( advanced) | 使用自定义 ValidatorFactory。 | ValidatorFactory |
13.5. 过程部署 复制链接链接已复制到粘贴板!
要在 IaaS 环境中使用 Hibernate Validator,请使用专用的 ValidationProviderResolver 实现,就像 org.apache.camel.component.bean.validator.HibernateValidationProviderResolver 一样。以下片段演示了这种方法。您还可以使用 HibernateValidationProviderResolver。
Using HibernateValidationProviderResolver
from("direct:test").
to("bean-validator://ValidationProviderResolverTest?validationProviderResolver=#myValidationProviderResolver");
from("direct:test").
to("bean-validator://ValidationProviderResolverTest?validationProviderResolver=#myValidationProviderResolver");
<bean id="myValidationProviderResolver" class="org.apache.camel.component.bean.validator.HibernateValidationProviderResolver"/>
<bean id="myValidationProviderResolver" class="org.apache.camel.component.bean.validator.HibernateValidationProviderResolver"/>
如果没有定义自定义 ValidationProviderResolver,并且验证器组件已部署到 sVirt 环境中,则会自动使用 HibernateValidationProviderResolver。
13.6. 示例 复制链接链接已复制到粘贴板!
假设我们有一个带有以下注解的 java bean
Car.java
以及自定义验证组的接口定义
OptionalChecks.java
public interface OptionalChecks {
}
public interface OptionalChecks {
}
使用以下 Camel 路由时,只有属性制造商和 licensePlate 的 @NotNull 约束才会被验证(Camel 使用默认组 javax.validation.groups.Default)。
from("direct:start")
.to("bean-validator://x")
.to("mock:end")
from("direct:start")
.to("bean-validator://x")
.to("mock:end")
如果要从组 OptionalChecks 中检查约束,则必须定义路由,如下所示
from("direct:start")
.to("bean-validator://x?group=OptionalChecks")
.to("mock:end")
from("direct:start")
.to("bean-validator://x?group=OptionalChecks")
.to("mock:end")
如果要从这两个组中检查约束,您必须首先定义一个新接口
AllChecks.java
@GroupSequence({Default.class, OptionalChecks.class})
public interface AllChecks {
}
@GroupSequence({Default.class, OptionalChecks.class})
public interface AllChecks {
}
然后您的路由定义应类似如下
from("direct:start")
.to("bean-validator://x?group=AllChecks")
.to("mock:end")
from("direct:start")
.to("bean-validator://x?group=AllChecks")
.to("mock:end")
如果需要提供自己的消息插入器、遍历解析器和约束验证器工厂,您必须编写如下路由:
<bean id="myMessageInterpolator" class="my.ConstraintValidatorFactory" /> <bean id="myTraversableResolver" class="my.TraversableResolver" /> <bean id="myConstraintValidatorFactory" class="my.ConstraintValidatorFactory" />
<bean id="myMessageInterpolator" class="my.ConstraintValidatorFactory" />
<bean id="myTraversableResolver" class="my.TraversableResolver" />
<bean id="myConstraintValidatorFactory" class="my.ConstraintValidatorFactory" />
from("direct:start")
.to("bean-validator://x?group=AllChecks&messageInterpolator=#myMessageInterpolator
&traversableResolver=#myTraversableResolver&constraintValidatorFactory=#myConstraintValidatorFactory")
.to("mock:end")
from("direct:start")
.to("bean-validator://x?group=AllChecks&messageInterpolator=#myMessageInterpolator
&traversableResolver=#myTraversableResolver&constraintValidatorFactory=#myConstraintValidatorFactory")
.to("mock:end")
也可以将约束描述为 XML,而不是作为 Java 注解描述。在这种情况下,您必须提供文件 META-INF/validation.xml,该文件可能如下所示
validation.xml
和 constraints-car.xml 文件
constraints-car.xml
以下是 OrderedChecks 示例路由定义的 XML 语法。
请注意,正文应包含要验证的类实例。
13.7. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 bean-validator 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-bean-validator-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-bean-validator-starter</artifactId>
</dependency>
组件支持 9 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.bean-validator.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.bean-validator.constraint-validator-factory | 使用自定义 ConstraintValidatorFactory。选项是一个 javax.validation.ConstraintValidatorFactory 类型。 | ConstraintValidatorFactory | |
| camel.component.bean-validator.enabled | 是否启用 bean-validator 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.bean-validator.ignore-xml-configuration | 是否忽略 META-INF/validation.xml 文件中的数据。 | false | 布尔值 |
| camel.component.bean-validator.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.bean-validator.message-interpolator | 使用自定义 MessageInterpolator。选项是 javax.validation.MessageInterpolator 类型。 | MessageInterpolator | |
| camel.component.bean-validator.traversable-resolver | 使用自定义 TraversableResolver。选项是一个 javax.validation.TraversableResolver 类型。 | TraversableResolver | |
| camel.component.bean-validator.validation-provider-resolver | 使用自定义 ValidationProviderResolver。选项是一个 javax.validation.ValidationProviderResolver 类型。 | ValidationProviderResolver | |
| camel.component.bean-validator.validator-factory | 使用自定义 ValidatorFactory。选项是 javax.validation.ValidatorFactory 类型。 | ValidatorFactory |
第 14 章 浏览 复制链接链接已复制到粘贴板!
支持生成者和消费者
Browse 组件提供了一个简单的 BrowsableEndpoint,可用于测试、可视化工具或调试。发送到端点的交换都可用于浏览。
14.1. URI 格式 复制链接链接已复制到粘贴板!
browse:someName[?options]
browse:someName[?options]
其中 someName 可以是唯一标识端点的任意字符串。
14.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
14.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
14.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
14.3. 组件选项 复制链接链接已复制到粘贴板!
Browse 组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
14.4. 端点选项 复制链接链接已复制到粘贴板!
Browse 端点使用 URI 语法进行配置:
browse:name
browse:name
使用以下路径和查询参数:
14.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| name (common) | 必需的 A 名称,可以是任意字符串来唯一标识端点。 | 字符串 |
14.4.2. 查询参数(4 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
14.5. 示例 复制链接链接已复制到粘贴板!
在以下路由中,我们插入一个 browse: 组件,以便浏览要传递的交换:
from("activemq:order.in").to("browse:orderReceived").to("bean:processOrder");
from("activemq:order.in").to("browse:orderReceived").to("bean:processOrder");
现在,我们可以检查来自 Java 代码中的接收的交换:
14.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用浏览时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-browse-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-browse-starter</artifactId>
</dependency>
组件支持 4 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.browse.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.browse.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.browse.enabled | 是否启用浏览组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.browse.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 15 章 Cassandra CQL 复制链接链接已复制到粘贴板!
支持生成者和消费者
Apache Cassandra 是一个开源 IaaS 数据库,旨在处理商业硬件上的大量数据。与 Amazon 的 DynamoDB 一样,Casasa 具有对等和 master-less 架构,以避免单一故障点和高可用性。与 Google 的 TriTable 一样,Casasra 数据是使用列系列的结构化,可通过 Thrift RPC API 或称为 CQL 的 SQL API 访问。
此组件旨在使用 CQL3 API (而不是 Thrift API)集成 Cassandra 2.0+。它基于 DataStax 提供的 Cassandra Java 驱动程序。
15.1. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
15.1.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
15.1.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
15.2. 组件选项 复制链接链接已复制到粘贴板!
Cassandra CQL 组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
15.3. 端点选项 复制链接链接已复制到粘贴板!
Cassandra CQL 端点使用 URI 语法进行配置:
cql:beanRef:hosts:port/keyspace
cql:beanRef:hosts:port/keyspace
使用以下路径和查询参数:
15.3.1. 路径参数(4 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| beanRef (common) | beanRef 使用 bean:id 来定义。 | 字符串 | |
| hosts (common) | 主机名 Cassandra 服务器。可以使用逗号分隔多个主机。 | 字符串 | |
| port (common) | Cassandra 服务器的端口号。 | 整数 | |
| 键空间 (common) | 要使用的键空间。 | 字符串 |
15.3.2. 查询参数(30 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clusterName (common) | 集群名称。 | 字符串 | |
| consistencyLevel (common) | 要使用的一致性级别。 Enum 值:
| DefaultConsistencyLevel | |
| cql (common) | 要执行的 CQL 查询。可以使用键 CamelCqlQuery 的消息标头覆盖。 | 字符串 | |
| DataCenter (common) | 要使用的数据中心。 | datacenter1 | 字符串 |
| loadBalancingPolicyClass (common) | 使用特定的 LoadBalancingPolicyClass。 | 字符串 | |
| password (common) | 会话身份验证的密码。 | 字符串 | |
| prepareStatements (common) | 是否使用 PreparedStatements 还是常规声明。 | true | 布尔值 |
| resultSetConversionStrategy (common) | 要使用实施 ResultSet 的逻辑将 ResultSet 转换为消息 body ALL, ONE, LIMIT_10, LIMIT_100… 的自定义类 | ResultSetConversionStrategy | |
| session (common) | 使用 Session 实例(通常不要使用这个选项)。 | CqlSession | |
| 用户名 (common) | 会话身份验证的用户名。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
15.4. 端点连接语法 复制链接链接已复制到粘贴板!
端点可以启动 Cassandra 连接或使用现有的连接。
| URI | 描述 |
|---|---|
|
| 单个主机、默认端口、测试通常 |
|
| 多主机,默认端口 |
|
| 多主机、自定义端口 |
|
| 默认端口和键空间 |
|
| 提供的会话参考 |
|
| 提供的集群参考 |
要微调 Cassandra 连接(SSL 选项、池选项、负载平衡策略、重试策略、重新连接策略…),请创建自己的 Cluster 实例,并将其提供给 Camel 端点。
15.5. messages 复制链接链接已复制到粘贴板!
15.5.1. 传入消息 复制链接链接已复制到粘贴板!
Camel Cassandra 端点需要一个简单的对象(Object 或 Object[] 或 Collection<Object>),它将绑定到 CQL 语句作为查询参数。如果消息正文为空或为空,那么将在不绑定参数的情况下执行 CQL 查询。
Headers
CamelCqlQuery(可选、字符串或常规状态)CQL 以普通字符串形式查询或使用
QueryBuilder构建。
15.5.2. 传出消息 复制链接链接已复制到粘贴板!
Camel Cassandra 端点根据 resultSetConversionStrategy 生成一个或多个 Cassandra Row 对象:
-
list<Row> 如果resultSetConversionStrategy为ALL或LIMIT_[0-9]+ -
如果
resultSetConversionStrategy是ONE,则单数为 Row' -
否则,如果
resultSetConversionStrategy是ResultSetConversionStrategy的自定义实现
15.6. 软件仓库 复制链接链接已复制到粘贴板!
Cassandra 可用于存储用于幂等和聚合 EIP 的消息。
Cassandra 可能尚未是排队用例的最佳工具,请阅读 Cassandra 反模式队列和队列,如数据集。建议使用这些表的 LeveledCompaction 和一个小的 GC grace 设置,以便快速删除 tombstoned 行。
15.7. 幂等软件仓库 复制链接链接已复制到粘贴板!
NamedCassandraIdempotentRepository 将消息密钥存储在 Cassandra 表中,如下所示:
CAMEL_IDEMPOTENT.cql
此存储库实施使用轻量级事务(也称为 Compare 和 Set),并且需要 Cassandra 2.0.7+。
或者,CassandraIdempotentRepository 没有 NAME 列,并可扩展来使用不同的数据模型。
| 选项 | Default(默认) | 描述 |
|---|---|---|
|
|
| 表名称 |
|
|
| 主密钥列 |
|
|
软件仓库名称,用于 | |
|
| 生存时间 | |
|
|
用于插入/删除密钥的一致性级别: | |
|
|
用于读取/检查键的一致性级别: |
15.8. 聚合存储库 复制链接链接已复制到粘贴板!
NamedCassandraAggregationRepository 将交换由关联密钥存储在 Cassandra 表中,如下所示:
CAMEL_AGGREGATION.cql
或者,CassandraAggregationRepository 没有 NAME 列,并可扩展为使用不同的数据模型。
| 选项 | Default(默认) | 描述 |
|---|---|---|
|
|
| 表名称 |
|
|
| 主密钥列 |
|
|
| Exchange Id 列 |
|
|
| 交换内容列 |
|
|
软件仓库名称,用于 | |
|
| 交换时间 | |
|
|
用于插入/删除交换的一致性级别: | |
|
|
用于读取/检查交换的一致性级别: |
15.9. 例子 复制链接链接已复制到粘贴板!
要在表中插入一些内容,您可以使用以下代码:
String CQL = "insert into camel_user(login, first_name, last_name) values (?, ?, ?)";
from("direct:input")
.to("cql://localhost/camel_ks?cql=" + CQL);
String CQL = "insert into camel_user(login, first_name, last_name) values (?, ?, ?)";
from("direct:input")
.to("cql://localhost/camel_ks?cql=" + CQL);
此时,您应该能够使用列表作为正文插入数据
Arrays.asList("davsclaus", "Claus", "Ibsen")
Arrays.asList("davsclaus", "Claus", "Ibsen")
相同的方法可用于更新或查询表。
15.10. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 cql 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-cassandraql-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-cassandraql-starter</artifactId>
</dependency>
组件支持 4 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.cql.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.cql.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.cql.enabled | 是否启用 cql 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.cql.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 16 章 控制总线 复制链接链接已复制到粘贴板!
仅支持生成者
EIP 模式的控制 总线 允许从框架内监控和管理集成系统。
使用控制总线来管理企业集成系统。控制总线使用与应用程序数据使用的相同消息传递机制,但使用单独的频道来传输与消息流中涉及的组件管理相关的数据。
在 Camel 中,您可以使用 JMX 管理和监控,或使用 CamelContext 中的 Java API 或 org.apache.camel.api.management 软件包,或使用此处具有示例的事件通知程序。
ControlBus 组件可根据控制总线 EIP 模式轻松管理 Camel 应用程序。例如,通过向端点发送消息来控制路由的生命周期,或收集性能统计信息。
controlbus:command[?options]
controlbus:command[?options]
其中 command 可以是任何字符串,用于识别要使用的命令类型。
16.1. 命令 复制链接链接已复制到粘贴板!
| 命令 | 描述 |
|---|---|
|
|
使用 |
|
| 允许您指定用于评估消息正文的。如果评估有任何结果,则结果将放入消息正文中。 |
16.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
16.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
16.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
16.3. 组件选项 复制链接链接已复制到粘贴板!
Control Bus 组件支持 2 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
16.4. 端点选项 复制链接链接已复制到粘贴板!
Control Bus 端点使用 URI 语法进行配置:
controlbus:command:language
controlbus:command:language
使用以下路径和查询参数:
16.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| command (producer) | 所需的命令 可以是 route 或 language。 Enum 值:
| 字符串 | |
| language (producer) | 允许您指定用于评估消息正文的语言名称。如果评估有任何结果,则结果将放入消息正文中。 Enum 值:
| 语言 |
16.4.1.1. 查询参数(6 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| action (producer) | 要表示可以是 start、stop 或 status 的操作。要启动或停止路由,或者作为消息正文中的输出获取路由的状态。您可以使用挂起并从 Camel 2.11.1 中恢复来挂起或恢复路由。从 Camel 2.11.1 开始,您可以使用 stats 获取以 XML 格式返回的性能静态;routeId 选项可用于定义哪个路由来获取整个 CamelContext 的性能统计。restart 操作将重启路由。 Enum 值:
| 字符串 | |
| async (producer) | 是否异步执行控制总线任务。重要:如果启用了这个选项,则任务的任何结果都不会在 Exchange 上设置。这只有在同步执行任务时才可能。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| loggingLevel (producer) | 任务完成后用于日志记录的日志记录级别,或者在处理任务期间发生任何异常。 Enum 值:
| INFO | LoggingLevel |
| restartDelay (producer) | 重启路由时要使用的 millis 中的延迟。 | 1000 | int |
| routeId (producer) | 按其 id 指定路由:special 关键字 current 表示当前的路由。 | 字符串 |
16.5. 使用 route 命令 复制链接链接已复制到粘贴板!
通过 route 命令,您可以在给定路由上执行常见的任务,例如启动路由,您可以向这个端点发送空消息:
template.sendBody("controlbus:route?routeId=foo&action=start", null);
template.sendBody("controlbus:route?routeId=foo&action=start", null);
要获取路由的状态,您可以执行以下操作:
String status = template.requestBody("controlbus:route?routeId=foo&action=status", null, String.class);
String status = template.requestBody("controlbus:route?routeId=foo&action=status", null, String.class);
16.6. 获取性能统计信息 复制链接链接已复制到粘贴板!
这要求启用 JMX (默认为 ),然后您可以获取每个路由的性能统计信息,或用于 CamelContext。例如,要获取名为 foo 的路由的统计信息,我们可以执行以下操作:
String xml = template.requestBody("controlbus:route?routeId=foo&action=stats", null, String.class);
String xml = template.requestBody("controlbus:route?routeId=foo&action=stats", null, String.class);
返回的统计信息采用 XML 格式。您可以使用 ManagedRouteMBean 上的 dumpRouteStatsAsXml 操作从 JMX 获取的相同数据。
要获取整个 CamelContext 的统计信息,只需省略 routeId 参数,如下所示:
String xml = template.requestBody("controlbus:route?action=stats", null, String.class);
String xml = template.requestBody("controlbus:route?action=stats", null, String.class);
16.7. 使用简单语言 复制链接链接已复制到粘贴板!
您可以将 简单 语言与控制总线搭配使用,例如停止特定路由,您可以将消息发送到包含以下信息的 "controlbus:language:simple" 端点:
template.sendBody("controlbus:language:simple", "${camelContext.getRouteController().stopRoute('myRoute')}");
template.sendBody("controlbus:language:simple", "${camelContext.getRouteController().stopRoute('myRoute')}");
因为这是一个 void 操作,因此不会返回任何结果。但是,如果要进行路由状态:
String status = template.requestBody("controlbus:language:simple", "${camelContext.getRouteStatus('myRoute')}", String.class);
String status = template.requestBody("controlbus:language:simple", "${camelContext.getRouteStatus('myRoute')}", String.class);
使用 route 命令控制路由的生命周期更为容易。语言 命令允许您执行具有更强大的电源的语言脚本,如 Groovy 或某些扩展 简单 语言。
例如,要关闭 Camel 本身,您可以执行以下操作:
template.sendBody("controlbus:language:simple?async=true", "${camelContext.stop()}");
template.sendBody("controlbus:language:simple?async=true", "${camelContext.stop()}");
我们使用 async=true 异步停止 Camel,否则我们将尝试在被发送到控制总线组件时尝试停止 Camel。
您还可以使用其他语言,如 Groovy 等等。
16.8. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 controlbus 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-controlbus-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-controlbus-starter</artifactId>
</dependency>
组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.controlbus.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.controlbus.enabled | 是否启用 controlbus 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.controlbus.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 17 章 Cron 复制链接链接已复制到粘贴板!
仅支持消费者
Cron 组件是一个通用接口组件,允许在使用 Unix cron 语法指定的特定间隔触发事件(例如: 0/2945 DS ? ? ),每两秒钟触发事件。
作为接口组件,Cron 组件不包含默认的实现,而是要求用户插入其选择的实施。
以下标准 Camel 组件支持 Cron 端点:
- camel-quartz
- camel-spring
Camel K 中也支持 Cron 组件,它可在 cron 表达式需要时使用 Kubernetes 调度程序触发路由。当使用与 Kubernetes cron 语法兼容的 cron 表达式时,Camel K 不需要插入额外的库。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
可能需要其他库来插入特定的实现。
17.1. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
17.1.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
17.1.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
17.2. 组件选项 复制链接链接已复制到粘贴板!
Cron 组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| cronService (advanced) | 提供了多个实现时要使用的 CamelCronService 的 id。 | 字符串 |
17.3. 端点选项 复制链接链接已复制到粘贴板!
Cron 端点使用 URI 语法进行配置:
cron:name
cron:name
使用以下路径和查询参数:
17.3.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| name (consumer) | 必需 cron 触发器的名称。 | 字符串 |
17.3.2. 查询参数(4 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| schedule (consumer) | 必需的 A cron 表达式,用于生成事件。 | 字符串 | |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern |
17.4. 使用方法 复制链接链接已复制到粘贴板!
组件可用于在指定时间触发事件,如下例所示:
from("cron:tab?schedule=0/1+*+*+*+*+?")
.setBody().constant("event")
.log("${body}");
from("cron:tab?schedule=0/1+*+*+*+*+?")
.setBody().constant("event")
.log("${body}");
调度表达式 0/3+10+114 +? 也可以写为 十分钟内每三个秒触发一次事件。
0/3 10945?,并在每小时的
调度表达式中的部分表示(按顺序排列):
- 秒(可选)
- minutes
- 几小时
- 月份的日期
- 月
- 周天
- 年(可选)
计划表达式可由 5 个到 7 个部分组成。当表达式由 6 个部分组成时,第一个项是"秒"部分(和年份)。
调度表达式的其他有效示例如下:
-
0/2 * * * ?(5 部分,每两分钟事件一次) -
0 0/2 200200 MON-FRI 2030(7 部分,每两分钟,每 2 月 2030 日)
路由也可以使用 XML DSL 编写。
17.5. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 cron 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-cron-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-cron-starter</artifactId>
</dependency>
组件支持 4 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.cron.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.cron.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.cron.cron-service | 提供了多个实现时要使用的 CamelCronService 的 id。 | 字符串 | |
| camel.component.cron.enabled | 是否启用 cron 组件的自动配置。这默认是启用的。 | 布尔值 |
第 18 章 CXF 复制链接链接已复制到粘贴板!
支持生成者和消费者
CXF 组件提供与 Apache CXF 集成,用于连接在 CXF 中托管的 JAX-WS 服务。
当在流模式中使用 CXF 时(请参阅 DataFormat 选项),然后读取流缓存。
Maven 用户必须在其 pom.xml 中为这个组件添加以下依赖项:
18.1. URI 格式 复制链接链接已复制到粘贴板!
此端点有两种 URI 格式: cxfEndpoint 和 someAddress。
cxf:bean:cxfEndpoint[?options]
cxf:bean:cxfEndpoint[?options]
其中 cxfEndpoint 代表引用 Spring bean registry 中的 bean 的 bean ID。使用这个 URI 格式,大多数端点详情都在 bean 定义中指定。
cxf://someAddress[?options]
cxf://someAddress[?options]
其中 someAddress 指定 CXF 端点的地址。使用这个 URI 格式,大多数端点详情都会使用选项来指定。
对于以上任一风格,您可以在 URI 中附加选项,如下所示:
cxf:bean:cxfEndpoint?wsdlURL=wsdl/hello_world.wsdl&dataFormat=PAYLOAD
cxf:bean:cxfEndpoint?wsdlURL=wsdl/hello_world.wsdl&dataFormat=PAYLOAD
18.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
18.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
18.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为 配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
18.3. 组件选项 复制链接链接已复制到粘贴板!
CXF 组件支持 6 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| allowStreaming (advanced) | 这个选项控制在 PAYLOAD 模式下运行 CXF 组件是否会将传入的消息解析为 DOM Elements,或将有效负载保留为 javax.xml.transform.Source 对象,在某些情况下允许流。 | 布尔值 | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| HeaderFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| useGlobalSslContextParameters (security) | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
18.4. 端点选项 复制链接链接已复制到粘贴板!
CXF 端点使用 URI 语法进行配置:
cxf:beanId:address
cxf:beanId:address
使用以下路径和查询参数:
18.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| beanId (common) | 查找现有配置的 CxfEndpoint。必须使用 bean: 作为前缀。 | 字符串 | |
| 地址 (服务) | 服务发布地址。 | 字符串 |
18.4.2. 查询参数(35 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| dataformat (common) | CXF 端点支持的数据类型消息。 Enum 值:
| POJO | dataformat |
| wrappedStyle (common) | 描述 SOAP 正文中如何表示参数的 WSDL 风格。如果值为 false,则 CXF 将选择 Documentation-literal unwrapped 风格,如果值为 true,则 CXF 将选择文档粘贴风格。 | 布尔值 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| cookieHandler (producer) | 配置 Cookie 处理程序来维护 HTTP 会话。 | CookieHandler | |
| defaultOperationName (producer) | 此选项将设置默认 operationName,它将由调用远程服务的 CxfProducer 使用。 | 字符串 | |
| defaultOperationNamespace (producer) | 此选项将设置默认 operationNamespace,它将由调用远程服务的 CxfProducer 使用。 | 字符串 | |
| HostnameVerifier (producer) | 要使用的主机名验证器。使用 sVirt 表示法引用 registry 中的 HostnameVerifier。 | HostnameVerifier | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| sslContextParameters (producer) | Camel SSL 设置参考。使用 DNAT 表示法引用 SSL 上下文。 | SSLContextParameters | |
| wrap (producer) | CXF 端点制作者将调用的操作类型。 | false | 布尔值 |
| Sync (producer (advanced)) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| allowStreaming (advanced) | 这个选项控制在 PAYLOAD 模式下运行 CXF 组件是否会将传入的消息解析为 DOM Elements,或将有效负载保留为 javax.xml.transform.Source 对象,在某些情况下允许流。 | 布尔值 | |
| 总线 (advanced) | 使用自定义配置的 CXF 总线。 | 总线 | |
| continuationTimeout (advanced) | 这个选项用于设置 CXF continuation 超时,当 CXF 服务器使用 Jetty 或 Servlet 传输时,默认可在 CxfConsumer 中使用。 | 30000 | long |
| cxfBinding (advanced) | 使用自定义 CxfBinding 来控制 Camel Message 和 CXF 消息之间的绑定。 | CxfBinding | |
| cxfConfigurer (advanced) | 这个选项可以应用 org.apache.camel.component.cxf.CxfEndpointConfigurer 的实现,它们支持以编程方式配置 CXF 端点。用户可以通过实施 CxfEndpointConfigurer 的 configure{ServerClient} 方法来配置 CXF 服务器和客户端。 | CxfConfigurer | |
| defaultBus (advanced) | 当 CXF 端点自行创建总线时,将设置默认总线。 | false | 布尔值 |
| HeaderFilterStrategy (advanced) | 使用自定义 HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| mergeProtocolHeaders (advanced) | 是否合并协议标头。如果启用,则 Camel 和 CXF 之间的标头会变得更加一致且类似。如需了解更多详细信息,请参阅 CAMEL-6393。 | false | 布尔值 |
| mtomEnabled (advanced) | 启用 MTOM (attachment)。这需要使用 POJO 或 PAYLOAD 数据格式模式。 | false | 布尔值 |
| properties (advanced) | 使用映射中的键/值对来设置额外的 CXF 选项。例如,要在 SOAP 错误中打开 stacktraces, properties.faultStack TraceEnabled=true。 | Map | |
| skipPayloadMessagePartCheck (advanced) | 设置是否应禁用 SOAP 消息验证。 | false | 布尔值 |
| loggingFeatureEnabled (logging) | 这个选项启用 CXF Logging 功能,将入站和出站 SOAP 消息写入日志。 | false | 布尔值 |
| loggingSizeLimit (logging) | 要限制在启用日志记录功能时日志记录器输出的字节数,-1 代表没有限制。 | 49152 | int |
| skipFaultLogging (logging) | 这个选项控制 PhaseInterceptorChain 是否跳过它捕获的 Fault。 | false | 布尔值 |
| 密码 (安全) | 此选项用于为 CXF 客户端设置密码的基本身份验证信息。 | 字符串 | |
| 用户名 (安全) | 此选项用于为 CXF 客户端设置用户名的基本身份验证信息。 | 字符串 | |
| bindingId (service) | 要使用的服务模型的 bindingId。 | 字符串 | |
| portName (service) | 此服务的端点名称,它映射到 wsdl:portname。以 ns:PORT_NAME 格式,其中 ns 是在这个范围内有效的命名空间前缀。 | 字符串 | |
| publishedEndpointUrl (service) | 此选项可覆盖从 WSDL 发布的 endpointUrl,可通过服务地址 url 和 wsd 访问。 | 字符串 | |
| serviceClass (service) | SEI (Service Endpoint Interface)类的类名称,该类可以具有 JSR181 注解或不。 | 类 | |
| serviceName (service) | 此服务正在实现的服务名称,它映射到 wsdl:servicename。 | 字符串 | |
| wsdlURL (service) | WSDL 的位置。可以位于 classpath、文件系统或远程托管。 | 字符串 |
serviceName 和 portName 是 QNames,因此如果您提供它们带有其 {namespace} 前缀,如上例所示。
18.4.3. 数据格式的描述 复制链接链接已复制到粘贴板!
在 Apache Camel 中,Camel CXF 组件是将路由与 Web 服务集成的关键。您可以使用 Camel CXF 组件创建一个 CXF 端点,该端点可使用以下方法之一使用:
- consumer - (在路由开始时)代表 Web 服务实例,与路由集成。注入路由的有效负载类型取决于端点的 dataFormat 选项的值。
- producer - (路由中的其他点)代表 WS 客户端代理,它将当前的交换对象转换为远程 Web 服务上的操作调用。当前交换的格式必须与端点的 dataFormat 设置匹配。
| dataformat | 描述 |
|---|---|
|
| POJO (旧 Java 对象)是目标服务器上调用的方法的 Java 参数。支持协议和逻辑 JAX-WS 处理程序。 |
|
|
|
|
|
|
|
|
|
您可以通过检索交换属性 CamelCXFDataFormat 来确定交换的数据格式模式。Exchange key 常量在 org.apache.camel.component.cxf.common.message.CxfConstants.DATA_FORMAT_PROPERTY 中定义。
18.4.4. 如何在 RAW 模式中启用 CXF 的 LoggingOutInterceptor 复制链接链接已复制到粘贴板!
CXF 的 LoggingOutInterceptor 输出在有线到日志记录系统(Java Util Logging)上的出站消息。由于 LoggingOutInterceptor 处于 PRE_STREAM 阶段(但 PRE_STREAM 阶段以 RAW 模式删除),所以您必须将 LoggingOutInterceptor 配置为在 WRITE 阶段运行。以下是以下示例。
18.4.5. relayHeaders 选项的描述 复制链接链接已复制到粘贴板!
有来自一个 JAXWS WSDL-first 开发者的 in-band 和 out-of-band on-the-wire 标头。
in-band 标头是明确定义为端点的 WSDL 绑定合同(如 SOAP 标头)的标头。
带外 标头是通过线序列化的标头,但不明确是 WSDL 绑定合同的一部分。
标头中继/过滤是双向的。
当路由具有 CXF 端点并且开发人员需要具有在线标头(如 SOAP 标头)时,会在由另一个 JAXWS 端点使用的路由间进行转发,然后将 relayHeaders 设置为 true,这是默认值。
18.4.6. 仅适用于 POJO 模式 复制链接链接已复制到粘贴板!
relayHeaders=true 表示转发标头的意图。对给定标头是否转发的实际决定将委派给实施 MessageHeadersRelay 接口的可插拔实例。将参考 MessageHeadersRelay 的共识实施,以确定是否需要转发标头。已实施 SoapMessageHeadersRelay,它将自身绑定到已知的 SOAP 名字空间。目前,只过滤带外标头,并在 relayHeaders=true 时始终转发带外标头。如果线上有一个标头,其名称空间对于运行时未知,则使用回退 DefaultMessageHeadersRelay,它只允许转发所有标头。
relayHeaders=false 设置指定所有标头带外和带外设置都应丢弃。
您可以插入您自己的 MessageHeadersRelay 实现,或向中继列表添加额外的 MessageHeadersRelay。要覆盖预加载的中继实例,请确保您的 MessageHeadersRelay 实现服务与您希望覆盖的名称相同。另请注意,覆盖中继必须服务所有要覆盖的名称空间,否则路由启动时的运行时异常将被抛出,因为这会给转发实例映射引入名字空间中的不确定性。
查看显示您可以在此处转发/排序标头的测试:
-
支持
POJO和PAYLOAD模式。在POJO模式中,只有带外消息标头才可以进行过滤,因为 cxf 从标头列表中移除。in-band 标头合并到 POJO 模式的MessageContentList中。camel-cxf组件会使任何尝试从MessageContentList中删除 in-band 标头。如果需要过滤带头标头,请在 CXF 端点中使用PAYLOAD模式或插入(pretty 拦截器) CXF 拦截器/DemoWS Handler。 -
Message Header Relay 机制已合并到
CxfHeaderFilterStrategy中。relayHeaders选项、其语义和默认值保持不变,但它是CxfHeaderFilterStrategy的属性。以下是配置它的示例。
然后,您的端点可以引用 CxfHeaderFilterStrategy。
然后,按如下所示配置路由:
rom("cxf:bean:routerNoRelayEndpoint")
.to("cxf:bean:serviceNoRelayEndpoint");
rom("cxf:bean:routerNoRelayEndpoint")
.to("cxf:bean:serviceNoRelayEndpoint");
-
MessageHeadersRelay接口稍有变化,并被重命名为MessageHeaderFilter。它是CxfHeaderFilterStrategy的属性。以下是配置用户定义的消息标头过滤器的示例:
-
除了
relayHeaders外,还可以在CxfHeaderFilterStrategy中配置以下属性。
| Name | 必填 | 描述 |
|---|---|---|
|
| 否 |
所有消息标头都将由 Message Header Filters Type: |
|
| 否 |
所有消息标头都将传播(不由 Message Header Filters 处理) 类型: |
|
| 否 |
如果激活命名空间中的两个过滤器重叠,则属性控制如何处理它。如果值为 |
18.5. 使用 Spring 配置 CXF 端点 复制链接链接已复制到粘贴板!
您可以使用下面显示的 Spring 配置文件配置 CXF 端点,您还可以将端点嵌入到 camelContext 标签中。在调用服务端点时,您可以将 operationName 和 operationNamespace 标头设置为显式状态您要调用的操作。
务必包含 root Bean 元素上指定的 JAX-WS 模式Location 属性。这允许 CXF 验证文件,且是必需的。另请注意 < cxf:cxfEndpoint/& gt; 标签末尾的命名空间声明。这些声明是必需的,因为此标签的属性值当前不支持组合 {namespace}localName 语法。
cxf:cxfEndpoint 元素支持许多附加属性:
| Name | 值 |
|---|---|
|
|
此服务的端点名称,它映射到 |
|
|
此服务正在实现的服务名称,它映射到 |
|
| WSDL 的位置。可以位于 classpath、文件系统或远程托管。 |
|
|
要使用的服务模型的 |
|
| 服务发布地址。 |
|
| JAX-WS 端点中使用的总线名称。 |
|
| SEI (Service Endpoint Interface)类的类名称,该类可以具有 JSR181 注解或不。 |
它还支持多个子元素:
| Name | 值 |
|---|---|
|
|
此端点的传入拦截器。< |
|
|
此端点的传入错误拦截器。< |
|
|
此端点传出的拦截器。< |
|
|
此端点传出的故障拦截器。< |
|
| 应该向 JAX-WS 端点提供的属性映射。请参阅以下。 |
|
| 应该向 JAX-WS 端点提供 JAX-WS 处理程序列表。请参阅以下。 |
|
|
您可以指定在端点中使用的 |
|
|
您可以为这个端点指定 |
|
| 保存此端点拦截器的功能。Bean 或 refs 列表 |
|
| 要使用的端点的模式位置。schemaLocations 列表 |
|
|
此端点要使用的服务工厂。这可以通过 Spring < |
您可以找到更高级的示例,其中显示了如何在 CXF JAX-WS Configuration 页面上 提供拦截器、属性和处理程序。
您可以使用 cxf:properties 设置 camel-cxf 端点的 dataFormat,并从 spring 配置文件中设置DefaultBus 属性。
在 SpringBoot 中,您可以使用 Spring XML 文件来配置 camel-cxf,并使用类似以下示例的代码来创建 XML 配置的 Bean:
@ImportResource({
"classpath:spring-configuration.xml"
})
@ImportResource({
"classpath:spring-configuration.xml"
})
但是,使用配置了 Bean 的 Java 代码(如其他示例所示)是在 SpringBoot 中最佳实践。
18.6. 如何使 camel-cxf 组件使用 log4j 而不是 java.util.logging 复制链接链接已复制到粘贴板!
CXF 的默认日志记录器为 java.util.logging。如果要将它更改为 log4j,请按如下所示操作:在 classpath 中创建一个名为 META-INF/cxf/org.apache.cxf.logger 的文件。此文件应包含类 org.apache.cxf.common.logging.Log4jLogger 的完全限定名称,且不含注释。
18.7. 如何让 camel-cxf 响应以 xml 处理指令开头 复制链接链接已复制到粘贴板!
如果您使用一些 SOAP 客户端,如 PHP,则会出现这类错误,因为 CXF 没有添加 XML 处理指令 < ?xml version="1.0" encoding="utf-8"?>:
Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]
Error:sendSms: SoapFault exception: [Client] looks like we got no XML document in [...]
要解决这个问题,您只需要告知 StaxOutInterceptor 为您 编写 XML 启动文档,如下所示:
另外,您还可以为它添加一个消息标头,如 CxfConsumerTest 所示:
// set up the response context which force start document
Map<String, Object> map = new HashMap<String, Object>();
map.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
exchange.getOut().setHeader(Client.RESPONSE_CONTEXT, map);
// set up the response context which force start document
Map<String, Object> map = new HashMap<String, Object>();
map.put("org.apache.cxf.stax.force-start-document", Boolean.TRUE);
exchange.getOut().setHeader(Client.RESPONSE_CONTEXT, map);
18.8. 如何从消息标头中覆盖 CXF producer 地址 复制链接链接已复制到粘贴板!
camel-cxf producer 支持通过设置消息标头 CamelDestinationOverrideUrl 来覆盖目标服务地址。
// set up the service address from the message header to override the setting of CXF endpoint exchange.getIn().setHeader(Exchange.DESTINATION_OVERRIDE_URL, constant(getServiceAddress()));
// set up the service address from the message header to override the setting of CXF endpoint
exchange.getIn().setHeader(Exchange.DESTINATION_OVERRIDE_URL, constant(getServiceAddress()));
18.9. 如何以 POJO 数据格式使用 camel-cxf 端点的消息 复制链接链接已复制到粘贴板!
camel-cxf 端点消费者 POJO 数据格式基于 CXF 调用器,因此消息标头具有名为 CxfConstants.OPERATION_NAME 的属性,消息正文是 SEI 方法参数的列表。
考虑 PersonProcessor 示例代码:
18.10. 如何以 POJO 数据格式为 camel-cxf 端点准备消息 复制链接链接已复制到粘贴板!
camel-cxf 端点制作者基于 CXF 客户端 API。首先,您需要在消息标头中指定操作名称,然后将方法参数添加到列表中,并使用此参数列表初始化消息。响应消息的正文是一个 messageContentsList,您可以从该列表中获取结果。
如果您没有在消息标头中指定操作名称,CxfProducer 将尝试使用来自 CxfEndpoint 的 defaultOperationName,如果在 CxfEndpoint 上没有设置defaultOperationName,它将从 Operation 列表中选择第一个 operationName。
如果要从消息正文中获取对象数组,您可以使用 message.getBody (Object[].class) 获取正文,如 CxfProducerRouterTest.testInvokingSimpleServerWithParams 所示:
18.11. 如何以 PAYLOAD 数据格式处理 camel-cxf 端点的消息 复制链接链接已复制到粘贴板!
PAYLOAD 意味着您将 SOAP envelope 中的有效负载作为原生 CxfPayload 处理。message .getBody () 将返回 org.apache.camel.component.cxf.CxfPayload 对象,其中包含 SOAP 消息标头和 SOAP 正文的 getters。
请参阅 CxfConsumerPayloadTest :
18.12. 如何在 POJO 模式中获取和设置 SOAP 标头 复制链接链接已复制到粘贴板!
POJO 表示,当 camel-cxf 端点生成或消耗 Camel 交换时,数据格式是一个"Java 对象列表"。虽然 Camel 在此模式中将消息正文公开为 POJO,但 camel-cxf 仍提供对读取和写入 SOAP 标头的访问。但是,由于 CXF 拦截器在处理后从标头列表中删除 in-band SOAP 标头,因此只有带外 SOAP 标头可用于 POJO 模式的 camel-cxf。
以下示例演示了如何 get/set SOAP 标头。假设我们有一个从 Camel-cxf 端点转发到另一个 Camel-cxf 端点的路由。也就是说,SOAP Client → Camel → CXF 服务。在响应回 SOAP 客户端之前,我们可以将两个处理器附加到(1)来获取/插入 SOAP 标头,然后再向 CXF 服务获取/插入 SOAP 标头。本例中的 processor (1)和(2)是 InsertRequestOutHeaderProcessor 和 InsertResponseOutHeaderProcessor。我们的路由类似如下:
from("cxf:bean:routerRelayEndpointWithInsertion")
.process(new InsertRequestOutHeaderProcessor())
.to("cxf:bean:serviceRelayEndpointWithInsertion")
.process(new InsertResponseOutHeaderProcessor());
from("cxf:bean:routerRelayEndpointWithInsertion")
.process(new InsertRequestOutHeaderProcessor())
.to("cxf:bean:serviceRelayEndpointWithInsertion")
.process(new InsertResponseOutHeaderProcessor());
Bean routerRelayEndpointWithInsertion 和 serviceRelayEndpointWithInsertion 定义如下:
SOAP 标头被传播到 Camel Message 标头。Camel 消息标头名称为 "org.apache.cxf.headers.Header.list",它在 CXF (org.apache.cxf.headers.Header.HEADER_LIST)中定义。标头值是一个 CXF SoapHeader 对象列表(org.apache.cxf.binding.soap.SoapHeader)。以下片段是 InsertResponseOutHeaderProcessor (它会在响应消息中插入新的 SOAP 标头)。访问 InsertResponseOutHeaderProcessor 和 InsertRequestOutHeaderProcessor 中的 SOAP 标头的方式实际上相同。两个处理器之间的唯一区别是设置插入 SOAP 标头的方向。
您可以在 CxfMessageHeadersRelayTest 中找到 InsertResponseOutHeaderProcessor 示例:
18.13. 如何在 PAYLOAD 模式中获取和设置 SOAP 标头 复制链接链接已复制到粘贴板!
我们已展示了如何在 PAYLOAD 模式中以 PAYLOAD 模式访问 SOAP 消息作为 CxfPayload 对象,该部分 是 How to handle the camel-cxf endpoint in PAYLOAD data format。
获取 CxfPayload 对象后,您可以调用 CxfPayload.getHeaders ()方法,该方法返回 DOM Elements (SOAP 标头)列表。
例如,请参阅 CxfPayLoadSoapHeaderTest :
您还可以使用与子选择 " How to get and set SOAP headers in POJO 模式"中所述的方法一样设置或获取 SOAP 标头。因此,您可以使用标头 "org.apache.cxf.headers.Header.list" 来获取和设置 SOAP 标头列表。这也意味着,如果您有一个从一个 Camel-cxf 端点转发到另一个 Camel-cxf 端点的路由(SOAP Client → Camel → CXF 服务),现在也会将 SOAP 客户端发送的 SOAP 标头转发到 CXF 服务。如果您不想转发这些标头,则必须在 Camel 标头 "org.apache.cxf.headers.Header.list" 中删除它们。
18.14. SOAP 标头在 RAW 模式中不可用 复制链接链接已复制到粘贴板!
SOAP 标头在 RAW 模式中不可用,因为跳过 SOAP 处理。
18.15. 如何从 Camel 中抛出 SOAP Fault 复制链接链接已复制到粘贴板!
如果您使用 camel-cxf 端点来消耗 SOAP 请求,您可能需要从 camel 上下文抛出 SOAP Fault。
基本上,您可以使用 throwFault DSL 来执行此操作;它适用于 POJO、PAYLOAD 和 MESSAGE 数据格式。
您可以定义 soap 错误,如 CxfCustomizedExceptionTest 所示:
SOAP_FAULT = new SoapFault(EXCEPTION_MESSAGE, SoapFault.FAULT_CODE_CLIENT); Element detail = SOAP_FAULT.getOrCreateDetail(); Document doc = detail.getOwnerDocument(); Text tn = doc.createTextNode(DETAIL_TEXT); detail.appendChild(tn);
SOAP_FAULT = new SoapFault(EXCEPTION_MESSAGE, SoapFault.FAULT_CODE_CLIENT);
Element detail = SOAP_FAULT.getOrCreateDetail();
Document doc = detail.getOwnerDocument();
Text tn = doc.createTextNode(DETAIL_TEXT);
detail.appendChild(tn);
然后,按照您需要抛出它
from(routerEndpointURI).setFaultBody(constant(SOAP_FAULT));
from(routerEndpointURI).setFaultBody(constant(SOAP_FAULT));
如果您的 CXF 端点以 MESSAGE 数据格式工作,您可以在消息正文中设置 SOAP Fault 消息,并在消息标头中设置响应代码,如 CxfMessageStreamExceptionTest所示
与使用 POJO 数据格式相同。您可以在外部正文上设置 SOAPFault。
18.16. 如何传播 camel-cxf 端点的请求和响应上下文 复制链接链接已复制到粘贴板!
CXF 客户端 API 提供了一种通过请求和响应上下文调用操作的方法。如果您使用 camel-cxf 端点制作者来调用外部 Web 服务,您可以设置请求上下文并使用以下代码获取响应上下文:
18.17. 附加支持 复制链接链接已复制到粘贴板!
POJO 模式: 支持带有 Attachment 和 MTOM 的 SOAP (请参阅启用 MTOM 的 Payload 模式)。但是,没有测试带有 Attachment 的 SOAP。由于附件被分为 marshalled 和 unmarshalled into POJO,因此用户通常不需要处理他们自己的附件。如果没有启用 MTOM,则会将附件传播到 Camel 消息的附加。因此,可以通过 Camel Message API 检索附件
DataHandler Message.getAttachment(String id)
DataHandler Message.getAttachment(String id)
有效负载模式: 组件支持 MTOM。附加可通过上述 Camel Message API 检索。支持具有附加(SwA)的 SOAP,并且可以检索附件。SwA 是默认值(与将 CXF 端点属性 "mtom-enabled" 设置为 false)。
要启用 MTOM,请将 CXF 端点属性 "mtom-enabled" 设置为 true。
您可以生成带有 attachment 的 Camel 消息,以便在 Payload 模式中发送到 CXF 端点。
您还可以以 Payload 模式使用从 CXF 端点接收的 Camel 消息。CxfMtomConsumerPayloadModeTest 演示了如何工作:
原始模式: 不支持过期,因为它根本不处理消息。
CXF_RAW Mode :支持 MTOM,并且前面提到的 Camel Message API 可以检索过期。请注意,当收到多部分(即 MTOM)消息时,默认的 SOAPMessage 到 String converter 将提供正文的完整多部分有效负载。如果您只需要 SOAP XML 作为字符串,您可以使用 message.getSOAPPart ()设置消息正文,Camel convert 可以为您执行其余工作。
18.18. PAYLOAD 模式中的流支持 复制链接链接已复制到粘贴板!
camel-cxf 组件现在在使用 PAYLOAD 模式时支持流传输传入的消息。在以前的版本中,传入的信息会被完全解析。对于大型消息,这会消耗时间,并使用大量内存。传入消息可以在路由时保留为 javax.xml.transform.Source,如果没有修改有效负载,则可以直接流传输到目标目的地。对于常见的"简单代理"用例(例如: from ("cxf:…").to ("cxf:…")),这可提供显著的性能增加,并显著降低的内存要求。
然而,在有些情况下,流可能不合适或需要。由于流性质,在处理链中稍后才会发现无效的传入的 XML。此外,某些操作可能需要消息成为 DOM 解析任何方法(如 WS-Security 或消息追踪等),在这种情况下,流的优点有限。此时,可以通过两种方式控制流:
- endpoint 属性:您可以添加 "allowStreaming=false" 作为端点属性,以打开 streaming on/off。
- 组件属性: CxfComponent 对象也有一个 allowStreaming 属性,可为从该组件创建的端点设置默认。
全局系统属性: 您可以将"org.apache.camel.component.cxf.streaming"的系统属性添加到 "false" 以将其关闭。这会设置全局默认值,但设置上述 endpoint 属性将覆盖该端点的值。
18.19. 使用通用 CXF Dispatch 模式 复制链接链接已复制到粘贴板!
camel-cxf 组件支持通用 CXF 分配模式,该模式可以传输任意结构的消息(例如,不绑定到特定的 XML 模式)。要使用此模式,只需省略指定 CXF 端点的 wsdlURL 和 serviceClass 属性。
<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/SoapContext/SoapAnyPort">
<cxf:properties>
<entry key="dataFormat" value="PAYLOAD"/>
</cxf:properties>
</cxf:cxfEndpoint>
<cxf:cxfEndpoint id="testEndpoint" address="http://localhost:9000/SoapContext/SoapAnyPort">
<cxf:properties>
<entry key="dataFormat" value="PAYLOAD"/>
</cxf:properties>
</cxf:cxfEndpoint>
请注意,默认的 CXF 分配客户端不会发送特定的 SOAPAction 标头。因此,当目标服务需要特定的 SOAPAction 值时,会使用 key SOAPAction 在 Camel 标头中提供它(不区分大小写)。
18.20. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 cxf 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-cxf-soap-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-cxf-soap-starter</artifactId>
</dependency>
组件支持 13 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.cxf.allow-streaming | 这个选项控制在 PAYLOAD 模式下运行 CXF 组件是否会将传入的消息解析为 DOM Elements,或将有效负载保留为 javax.xml.transform.Source 对象,在某些情况下允许流。 | 布尔值 | |
| camel.component.cxf.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.cxf.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.cxf.enabled | 是否启用 cxf 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.cxf.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.cxf.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.cxf.use-global-ssl-context-parameters | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
| camel.component.cxfrs.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.cxfrs.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.cxfrs.enabled | 是否启用 cxfrs 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.cxfrs.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.cxfrs.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.cxfrs.use-global-ssl-context-parameters | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
第 19 章 数据格式 复制链接链接已复制到粘贴板!
仅支持生成者
Dataformat 组件允许使用数据格式 作为 Camel 组件。
19.1. URI 格式 复制链接链接已复制到粘贴板!
dataformat:name:(marshal|unmarshal)[?options]
dataformat:name:(marshal|unmarshal)[?options]
其中 name 是数据格式的名称。然后后根一个操作,需要是 marshal 或 unmarshal。这些选项用于配置正在使用的 数据格式。有关它支持哪些选项,请参阅数据格式文档。
19.2. 数据格式选项 复制链接链接已复制到粘贴板!
19.2.1. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
19.2.1.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
19.2.1.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
19.3. 组件选项 复制链接链接已复制到粘贴板!
数据格式组件支持 2 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
19.4. 端点选项 复制链接链接已复制到粘贴板!
数据格式端点使用 URI 语法进行配置:
dataformat:name:operation
dataformat:name:operation
使用以下路径和查询参数:
19.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| name (producer) | 数据格式 必需 名称。 | 字符串 | |
| operation (producer) | 需要使用 marshal 或 unmarshal 的操作。 Enum 值:
| 字符串 |
19.4.2. 查询参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
19.5. Samples 复制链接链接已复制到粘贴板!
例如,要使用 JAXB 数据格式,我们可以执行以下操作:
from("activemq:My.Queue").
to("dataformat:jaxb:unmarshal?contextPath=com.acme.model").
to("mqseries:Another.Queue");
from("activemq:My.Queue").
to("dataformat:jaxb:unmarshal?contextPath=com.acme.model").
to("mqseries:Another.Queue");
在 XML DSL 中,您要进行:
19.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 dataformat 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-dataformat-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-dataformat-starter</artifactId>
</dependency>
组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.dataformat.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.dataformat.enabled | 是否启用 dataformat 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.dataformat.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 20 章 dataset 复制链接链接已复制到粘贴板!
支持生成者和消费者
对分布式和异步处理的测试非常困难。Mock、Test 和 DataSet 端点与 Camel 测试框架很好,通过使用 企业集成模式 和 Camel 的大型组件以及强大的 Bean 集成来简化单元和集成测试。
DataSet 组件提供了一种机制,可轻松对系统执行负载和 soak 测试。它的工作原理是允许您创建 DataSet 实例作为 消息源,并作为接收数据集的方法。
Camel 在发送数据集 时使用吞吐量日志记录器。
20.1. URI 格式 复制链接链接已复制到粘贴板!
dataset:name[?options]
dataset:name[?options]
其中 name 用于在 Registry 中查找 DataSet 实例
Camel 附带 org.apache.camel.component.dataset.DataSet 的支持实施,org.apache.camel.component.dataset.DataSetSupport 类,可用作实施您自己的 DataSet 的基础。Camel 还附带一些实现,可用于测试: org.apache.camel.component.dataset.SimpleDataSet、org.apache.camel.component.dataset.ListDataSet 和 org.apache.camel.component.dataset.FileDataSet,它们扩展 DataSetSupport。
20.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
20.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
20.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
20.3. 组件选项 复制链接链接已复制到粘贴板!
Dataset 组件支持 5 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| log (producer) | 在模拟收到传入的消息时打开日志记录。这将仅记录传入消息的 INFO 级别一次。如需更详细的日志记录,请将 org.apache.camel.component.mock.MockEndpoint 类的日志记录器设置为 DEBUG 级别。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| exchangeFormatter (advanced) | Autowired 设置自定义 ExchangeFormatter,将 Exchange 转换为适合日志记录的字符串。如果没有指定,则默认为 DefaultExchangeFormatter。 | ExchangeFormatter |
20.4. 端点选项 复制链接链接已复制到粘贴板!
Dataset 端点使用 URI 语法进行配置:
dataset:name
dataset:name
使用以下路径和查询参数:
20.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| name (common) | 要在 registry 中查找 DataSet 所需的 名称。 | DataSet |
20.4.2. 查询参数(21 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| dataSetIndex (common) | 控制 CamelDataSetIndex 标头的行为。对于 Consumers: - off = 标头不会设置 - strict/lenient = 标头将被设置为 For Producers: - off = 标头值不会被验证,如果没有包括标头值,则不会设置它。如果标头值不存在,标头值必须存在,并将验证 = lenient = 标头值(如果不存在)。 Enum 值:
| lenient | 字符串 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| initialDelay (consumer) | 在开始发送消息前,millis 中的时间段。 | 1000 | long |
| minRate (consumer) | 等待 DataSet 至少包含这个数量的消息。 | 0 | int |
| preloadSize (consumer) | 设置在路由完成初始化前应预加载(sent)的消息数量。 | 0 | long |
| produceDelay (consumer) | 可以指定延迟,这会在消费者发送消息时造成延迟(模拟速度较慢的处理)。 | 3 | long |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| assertPeriod (producer) | 设置一个宽限期,模拟端点将重新分配,以确保初始断言仍然有效。例如,这用于精确有多个消息到达的声明。例如,如果 expectedMessageCount (int)设为 5,则在 5 个或更多消息到达时满足断言。为确保完全 5 个消息到达,您需要等待少量周期以确保没有进一步的消息到达。这是您可以使用此方法。默认情况下禁用这个周期。 | long | |
| consumeDelay (producer) | 可以指定延迟,在生成者消耗消息时(模拟速度较慢)时会导致延迟。 | 0 | long |
| expectedCount (producer) | 指定此端点应接收的消息交换数量。beware:如果要期望 0 个消息,然后在测试启动时进行额外的操作,因为测试启动时需要设置一个断言周期,以便测试可以在一段时间内运行,以确保仍没有到达的消息;对于使用 setAssertPeriod (long),您需要设置一个指定时间。另一种方法是使用 NotifyBuilder,并使用 notifier 知道 Camel 在对模拟调用 assertIsSatisfied ()方法之前,在路由某些消息前知道何时进行路由。这可让您不使用固定的断言周期来加快测试时间。如果您想成为完全 n 个消息到达这个模拟端点,请参阅 setAssertPeriod (long)方法以了解更多详细信息。 | -1 | int |
| failFast (producer) | 设置是否 assertIsSatisfied ()是否应该在第一次检测到的失败时快速失败,同时可能会等待所有预期消息到达,然后再执行预期验证。默认为 true。设置为 false,以使用与 Camel 2.x 中一样的行为。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| log (producer) | 在模拟收到传入的消息时打开日志记录。这将仅记录传入消息的 INFO 级别一次。如需更详细的日志记录,请将 org.apache.camel.component.mock.MockEndpoint 类的日志记录器设置为 DEBUG 级别。 | false | 布尔值 |
| reportGroup (producer) | 用于根据大小组打开吞吐量日志的数字。 | int | |
| resultMinimumWaitTime (producer) | 设置 assertIsSatisfied ()的最短预期时间(以 millis 为单位)。 | long | |
| resultWaitTime (producer) | 设置 assertIsSatisfied ()在达到前等待的最大时间(以 millis 为单位)。 | long | |
| retainFirst (producer) | 指定只保留前 n 个接收的交换数。这在使用大量数据进行测试时,通过不存储每个交换端点接收的每个交换的副本来减少内存消耗。重要:在使用这个限制时,getReceivedCounter ()仍会返回实际收到的交换数量。例如,如果我们收到 5000 Exchanges,并且配置为只保留前 10 个交换,则 getReceivedCounter ()仍会返回 5000,但 getExchanges ()中只有前 10 个交换,并且 getReceivedExchanges ()方法。使用此方法时,不支持一些其他预期方法,例如 expectedBodiesReceived (Object…)在收到的第一个正文数量上设置预期。您可以配置 setRetainFirst (int)和 setRetainLast (int)方法,以限制第一个和最后一个接收的方法。 | -1 | int |
| retainLast (producer) | 指定只保留最后 n 个接收的交换数。这在使用大量数据进行测试时,通过不存储每个交换端点接收的每个交换的副本来减少内存消耗。重要:在使用这个限制时,getReceivedCounter ()仍会返回实际收到的交换数量。例如,如果我们收到 5000 Exchanges,并且配置为只保留最后 20 个交换,则 getReceivedCounter ()仍会返回 5000,但 getExchanges ()中只有最后 20 个交换,并且 getReceivedExchanges ()方法。使用此方法时,不支持一些其他预期方法,例如 expectedBodiesReceived (Object…)在收到的第一个正文数量上设置预期。您可以配置 setRetainFirst (int)和 setRetainLast (int)方法,以限制第一个和最后一个接收的方法。 | -1 | int |
| sleepForEmptyTest (producer) | 当 expectedMessageCount (int)调用零时,允许指定 sleep 来等待此端点确实为空。 | long | |
| copyOnExchange (producer (advanced)) | 设置是否在这个模拟端点收到传入交换的深度副本。默认为 true。 | true | 布尔值 |
20.5. 配置 DataSet 复制链接链接已复制到粘贴板!
Camel 将在 Registry 中查找用于实施 DataSet 接口的 bean。以便您可以将自己的 DataSet 注册为:
<bean id="myDataSet" class="com.mycompany.MyDataSet"> <property name="size" value="100"/> </bean>
<bean id="myDataSet" class="com.mycompany.MyDataSet">
<property name="size" value="100"/>
</bean>
20.6. 示例 复制链接链接已复制到粘贴板!
例如,要测试将一组消息发送到队列,然后从队列中消耗,而不丢失任何消息:
// send the dataset to a queue
from("dataset:foo").to("activemq:SomeQueue");
// now lets test that the messages are consumed correctly
from("activemq:SomeQueue").to("dataset:foo");
// send the dataset to a queue
from("dataset:foo").to("activemq:SomeQueue");
// now lets test that the messages are consumed correctly
from("activemq:SomeQueue").to("dataset:foo");
以上会在 Registry 中查找用于创建消息的 foo DataSet 实例。
然后,您可以创建一个 DataSet 实现,例如使用 SimpleDataSet,配置数据集的大事项,以及消息样子等。
20.7. DataSetSupport (abstract 类) 复制链接链接已复制到粘贴板!
DataSetSupport 抽象类是新 DataSets 的过期起点,为派生类提供一些有用的功能。
20.7.1. DataSetSupport 的属性 复制链接链接已复制到粘贴板!
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
|
|
|
|
指定默认消息正文。对于 SimpleDataSet,它是一个恒定的有效负载;但是,如果要为每个消息创建自定义有效负载,请创建自己的 |
|
|
| null | |
|
|
|
| 指定要发送/恢复的消息数量。 |
|
|
|
|
指定在报告进度前要接收的消息数量。可用于显示大型负载测试的进度。如果 < 0,则 |
20.8. SimpleDataSet 复制链接链接已复制到粘贴板!
SimpleDataSet 扩展 DataSetSupport,并添加默认正文。
20.8.1. SimpleDataSet 的额外属性 复制链接链接已复制到粘贴板!
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
|
|
|
|
指定默认消息正文。默认情况下, |
20.9. ListDataSet 复制链接链接已复制到粘贴板!
List'DataSet' 扩展 DataSetSupport,并添加默认正文列表。
20.9.1. ListDataSet 的额外属性 复制链接链接已复制到粘贴板!
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
|
|
|
|
指定默认消息正文。默认情况下, |
|
|
| defaultBodies 列表的大小 |
指定要发送/恢复的消息数量。这个值可以与 |
20.10. FileDataSet 复制链接链接已复制到粘贴板!
FileDataSet 扩展 ListDataSet,并添加从文件中加载正文的支持。
20.10.1. FileDataSet 中的其他属性 复制链接链接已复制到粘贴板!
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
|
|
| null | 指定有效负载的源文件 |
|
|
| \z |
指定 |
20.11. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 dataset 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-dataset-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-dataset-starter</artifactId>
</dependency>
组件支持 11 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.dataset-test.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.dataset-test.enabled | 是否启用 dataset-test 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.dataset-test.exchange-formatter | 设置自定义 ExchangeFormatter,将 Exchange 转换为适合日志记录的字符串。如果没有指定,则默认为 DefaultExchangeFormatter。选项是 org.apache.camel.spi.ExchangeFormatter 类型。 | ExchangeFormatter | |
| camel.component.dataset-test.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.dataset-test.log | 在模拟收到传入的消息时打开日志记录。这将仅记录传入消息的 INFO 级别一次。如需更详细的日志记录,请将 org.apache.camel.component.mock.MockEndpoint 类的日志记录器设置为 DEBUG 级别。 | false | 布尔值 |
| camel.component.dataset.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.dataset.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.dataset.enabled | 是否启用 dataset 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.dataset.exchange-formatter | 设置自定义 ExchangeFormatter,将 Exchange 转换为适合日志记录的字符串。如果没有指定,则默认为 DefaultExchangeFormatter。选项是 org.apache.camel.spi.ExchangeFormatter 类型。 | ExchangeFormatter | |
| camel.component.dataset.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.dataset.log | 在模拟收到传入的消息时打开日志记录。这将仅记录传入消息的 INFO 级别一次。如需更详细的日志记录,请将 org.apache.camel.component.mock.MockEndpoint 类的日志记录器设置为 DEBUG 级别。 | false | 布尔值 |
第 21 章 direct 复制链接链接已复制到粘贴板!
支持生成者和消费者
当制作者发送消息交换时,Direct 组件提供任何消费者的直接同步调用。
此端点可用于连接 同一 camel 上下文中的现有路由。
异步
SEDA 组件在发送消息交换时提供任何消费者的异步调用。
21.1. URI 格式 复制链接链接已复制到粘贴板!
direct:someName[?options]
direct:someName[?options]
其中 someName 可以是唯一标识端点的任意字符串
21.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
21.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
21.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
21.3. 组件选项 复制链接链接已复制到粘贴板!
Direct 组件支持 5 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| block (producer) | 如果向没有活跃消费者的直接端点发送消息,则我们可以告知制作者阻止并等待消费者变为 active。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| timeout (producer) | 如果启用了块,要使用的超时值。 | 30000 | long |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
21.4. 端点选项 复制链接链接已复制到粘贴板!
直接端点使用 URI 语法进行配置:
direct:name
direct:name
使用以下路径和查询参数:
21.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| name (common) | 直接端点 必需 的名称。 | 字符串 |
21.4.2. 查询参数(8 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| block (producer) | 如果向没有活跃消费者的直接端点发送消息,则我们可以告知制作者阻止并等待消费者变为 active。 | true | 布尔值 |
| failIfNoConsumers (producer) | 当发送到没有活跃消费者的 DIRECT 端点时,生成者是否应该失败。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| timeout (producer) | 如果启用了块,要使用的超时值。 | 30000 | long |
| Sync (advanced) | 是否强制进行同步处理。如果启用,则制作者线程将强制等待消息完成,直到同一线程继续处理。如果禁用(默认),则制作者线程可能会释放,并在消息继续由其他线程(活跃)处理时执行其他工作。 | false | 布尔值 |
21.5. Samples 复制链接链接已复制到粘贴板!
在以下路由中,我们使用直接组件将两个路由连接在一起:
和使用 spring DSL 的示例:
另请参阅 SEDA 组件中的示例,它们如何一起使用。
21.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用直接时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-direct-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-direct-starter</artifactId>
</dependency>
组件支持 6 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.direct.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.direct.block | 如果向没有活跃消费者的直接端点发送消息,则我们可以告知制作者阻止并等待消费者变为 active。 | true | 布尔值 |
| camel.component.direct.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.direct.enabled | 是否启用直接组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.direct.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.direct.timeout | 如果启用了块,要使用的超时值。 | 30000 | Long |
第 22 章 Elasticsearch 复制链接链接已复制到粘贴板!
从 Camel 3.18.3 开始
仅支持生成者
ElasticSearch 组件允许您使用 Java API 客户端库与 ElasticSearch 8.x API 进行接口。
将以下依赖项添加到此组件的 pom.xml 中:
22.1. URI 格式 复制链接链接已复制到粘贴板!
elasticsearch://clusterName[?options]
elasticsearch://clusterName[?options]
22.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
22.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
22.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
22.3. 组件选项 复制链接链接已复制到粘贴板!
Elasticsearch 组件支持 14 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| connectionTimeout (producer) | 连接超时前等待的时间(ms)。 | 30000 | int |
| hostAddresses (producer) | 以逗号分隔的带有要使用的 ip:port 格式的远程传输地址的列表。ip 和 port 选项必须留空,才能考虑 hostAddresses。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| maxRetryTimeout (producer) | 重试前 ms 的时间。 | 30000 | int |
| socketTimeout (producer) | 套接字超时前要等待的超时时间(ms)。 | 30000 | int |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| client (advanced) | Autowired 使用现有配置的 Elasticsearch 客户端,而不是为每个端点创建客户端。这允许使用特定设置自定义客户端。 | RestClient | |
| enableSniffer (advanced) | 启用从正在运行的 Elasticsearch 集群中自动发现节点。如果将这个选项与 Spring Boot 结合使用,则由 Spring Boot 配置管理(请参阅:Spring Boot 中禁用 Sniffer)。 | false | 布尔值 |
| sniffAfterFailureDelay (advanced) | 失败后(以毫秒为单位)调度 sniff 执行的延迟。 | 60000 | int |
| snifferInterval (advanced) | 以毫秒为单位连续执行间隔。当禁用 sniffOnFailure 时,或连续的 sniffOnFailure 之间没有故障时,将休眠。 | 300000 | int |
| certificatePath (security) | 用于访问 Elasticsearch 的自签名证书的路径。 | 字符串 | |
| 启用SSL (安全) | 启用 SSL。 | false | 布尔值 |
| 密码 (安全) | 进行身份验证的密码。 | 字符串 | |
| 用户 (安全) | 基本身份验证用户。 | 字符串 |
22.4. 端点选项 复制链接链接已复制到粘贴板!
Elasticsearch 端点使用 URI 语法进行配置:
elasticsearch:clusterName
elasticsearch:clusterName
使用以下路径和查询参数:
22.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clusterName (producer) | 集群所需的 名称。 | 字符串 |
22.4.2. 查询参数(19 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| connectionTimeout (producer) | 连接超时前等待的时间(ms)。 | 30000 | int |
| disconnect (producer) | 在完成调用制作者后断开连接。 | false | 布尔值 |
| from (producer) | 启动响应的索引。 | 整数 | |
| hostAddresses (producer) | 以逗号分隔的带有要使用的 ip:port 格式的远程传输地址的列表。 | 字符串 | |
| indexName (producer) | 要操作的索引的名称。 | 字符串 | |
| maxRetryTimeout (producer) | 重试前 ms 的时间。 | 30000 | int |
| operation (producer) | 要执行的操作。 Enum 值:
| ElasticsearchOperation | |
| scrollKeepAliveMs (producer) | elasticsearch 将保持搜索上下文处于活跃状态的时间(ms)。 | 60000 | int |
| size (producer) | 响应的大小。 | 整数 | |
| socketTimeout (producer) | 套接字超时前要等待的超时时间(ms)。 | 30000 | int |
| useScroll (producer) | 启用滚动使用。 | false | 布尔值 |
| waitForActiveShards (producer) | 索引创建会等待写入一致性的分片数量可用。 | 1 | int |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| documentClass (advanced) | 反序列化文档时要使用的类。 | ObjectNode | 类 |
| enableSniffer (advanced) | 启用从正在运行的 Elasticsearch 集群中自动发现节点。如果将这个选项与 Spring Boot 结合使用,则由 Spring Boot 配置管理(请参阅:Spring Boot 中禁用 Sniffer)。 | false | 布尔值 |
| sniffAfterFailureDelay (advanced) | 失败后(以毫秒为单位)调度 sniff 执行的延迟。 | 60000 | int |
| snifferInterval (advanced) | 以毫秒为单位连续执行间隔。当禁用 sniffOnFailure 时,或连续的 sniffOnFailure 之间没有故障时,将休眠。 | 300000 | int |
| certificatePath (security) | 用于访问 Elasticsearch 的自签名证书的路径。 | 字符串 | |
| 启用SSL (安全) | 启用 SSL。 | false | 布尔值 |
22.5. 消息标头 复制链接链接已复制到粘贴板!
Elasticsearch 组件支持 9 个消息标头,如下所列:
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| operation (producer) 常数: PARAM_OPERATION | 要执行的操作。 Enum 值:
| ElasticsearchOperation | |
| indexId (producer) 常数: PARAM_INDEX_ID | 索引文档的 id。 | 字符串 | |
| indexName (producer) 常数: PARAM_INDEX_NAME | 要操作的索引的名称。 | 字符串 | |
| documentClass (producer) | 文档类的全限定名称到 unmarshall。 | ObjectNode | 类 |
| waitForActiveShards (producer) | 索引创建会等待写入一致性的分片数量可用。 | 整数 | |
| scrollKeepAliveMs (producer) | 响应的起始索引。 | 整数 | |
| useScroll (producer) 常数: PARAM_SCROLL | 设置为 true 以启用滚动使用。 | 布尔值 | |
| size (producer) 常数: PARAM_SIZE | 响应的大小。 | 整数 | |
| from (producer) 常量: PARAM_FROM | 响应的起始索引。 | 整数 |
22.6. 消息操作 复制链接链接已复制到粘贴板!
目前支持以下 ElasticSearch 操作。只需设置端点 URI 选项或交换标头,键为"operation",值设为以下之一:有些操作还需要设置其他参数或消息正文。
| operation | 消息正文 | description |
|---|---|---|
| 索引 | 将,String,byte[], Reader,InputStream or IndexRequest.Builder content to index | 将内容添加到索引中,并在正文中返回内容的 indexId。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。您可以使用 "indexId" 设置消息标头来设置 indexId。 |
| GetById | 要检索的内容的字符串或 GetRequest.Builder 索引 ID | 检索与给定索引 ID 对应的文档,并在正文中返回一个 GetResponse 对象。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。您可以使用 "documentClass" 设置消息标头来设置文档类型。 |
| 删除 | 要删除的内容的字符串或 DeleteRequest.Builder 索引 ID | 删除指定的 indexName,并在正文中返回一个 Result 对象。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。 |
| DeleteIndex | 要删除的索引的字符串或 DeleteIndexRequest.Builder 索引名称 | 删除指定的 indexName 并在正文中返回状态代码。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。 |
| 批量 | 已接受的任何类型的Ser able 或 BulkRequest.Builder (DeleteOperation.Builder 用于删除操作,UpdateOperation.Builder 用于 update 操作,CreateOperation.Builder 用于 create operation, byte[], InputStream, String, Reader, Map 或 index 操作的任何文档类型) | 将/更新/删除内容从/添加到索引中,并在正文中返回一个 List<BulkResponseItem> 对象,您可以通过使用键 "indexName" 设置消息标头来设置目标索引的名称。 |
| 搜索 | map 、 string 或 SearchRequest.Builder | 使用查询字符串映射搜索内容。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。您可以通过将消息标头设置为"size"来设置要返回的点击数。您可以通过将消息标头设置为键"from"来设置起始文档偏移。 |
| MultiSearch | MsearchRequest.Builder | 一个搜索 |
| MultiGet | iterable<String > 或 MgetRequest.Builder 要检索的文档 ID | 多次获取 您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。 |
| Exists | None | 检查索引是否存在,并在正文中返回布尔值标志。 您必须使用键 "indexName" 设置消息标头来设置目标索引的名称。 |
| Update(更新) | byte[], InputStream,String,Reader,Map 或要更新的任何文档类型内容 | 将内容更新为索引,并在正文中返回内容的 indexId。您可以使用键 "indexName" 设置消息标头来设置目标索引的名称。您可以使用 "indexId" 设置消息标头来设置 indexId。 |
| ping | None | 对 Elasticsearch 集群进行 ping 操作并返回 true (如果 ping 成功),否则返回 false |
22.7. 配置组件并启用基本身份验证 复制链接链接已复制到粘贴板!
要使用 Elasticsearch 组件,必须使用最低配置进行配置。
ElasticsearchComponent elasticsearchComponent = new ElasticsearchComponent();
elasticsearchComponent.setHostAddresses("myelkhost:9200");
camelContext.addComponent("elasticsearch", elasticsearchComponent);
ElasticsearchComponent elasticsearchComponent = new ElasticsearchComponent();
elasticsearchComponent.setHostAddresses("myelkhost:9200");
camelContext.addComponent("elasticsearch", elasticsearchComponent);
对于使用 elasticsearch 的基本身份验证或在 elasticsearch 集群前面使用反向 http 代理,只需在组件上设置基本身份验证和 SSL,如下例所示
22.8. 索引示例 复制链接链接已复制到粘贴板!
以下是一个简单的 INDEX 示例
from("direct:index")
.to("elasticsearch://elasticsearch?operation=Index&indexName=twitter");
from("direct:index")
.to("elasticsearch://elasticsearch?operation=Index&indexName=twitter");
<route>
<from uri="direct:index"/>
<to uri="elasticsearch://elasticsearch?operation=Index&indexName=twitter"/>
</route>
<route>
<from uri="direct:index"/>
<to uri="elasticsearch://elasticsearch?operation=Index&indexName=twitter"/>
</route>
对于此操作,您需要指定一个 indexId 标头。
客户端只需要将包含映射的正文消息传递给路由。结果正文包含创建的 indexId。
Map<String, String> map = new HashMap<String, String>();
map.put("content", "test");
String indexId = template.requestBody("direct:index", map, String.class);
Map<String, String> map = new HashMap<String, String>();
map.put("content", "test");
String indexId = template.requestBody("direct:index", map, String.class);
22.9. 搜索示例 复制链接链接已复制到粘贴板!
搜索特定字段和值使用 Operation 'Search'。传递查询 JSON 字符串或映射
from("direct:search")
.to("elasticsearch://elasticsearch?operation=Search&indexName=twitter");
from("direct:search")
.to("elasticsearch://elasticsearch?operation=Search&indexName=twitter");
<route>
<from uri="direct:search"/>
<to uri="elasticsearch://elasticsearch?operation=Search&indexName=twitter"/>
</route>
<route>
<from uri="direct:search"/>
<to uri="elasticsearch://elasticsearch?operation=Search&indexName=twitter"/>
</route>
String query = "{\"query\":{\"match\":{\"doc.content\":\"new release of ApacheCamel\"}}}";
HitsMetadata<?> response = template.requestBody("direct:search", query, HitsMetadata.class);
String query = "{\"query\":{\"match\":{\"doc.content\":\"new release of ApacheCamel\"}}}";
HitsMetadata<?> response = template.requestBody("direct:search", query, HitsMetadata.class);
使用 Map 在特定字段中搜索。
使用 Elasticsearch 搜索 api 以获取所有结果。
from("direct:search")
.to("elasticsearch://elasticsearch?operation=Search&indexName=twitter&useScroll=true&scrollKeepAliveMs=30000");
from("direct:search")
.to("elasticsearch://elasticsearch?operation=Search&indexName=twitter&useScroll=true&scrollKeepAliveMs=30000");
<route>
<from uri="direct:search"/>
<to uri="elasticsearch://elasticsearch?operation=Search&indexName=twitter&useScroll=true&scrollKeepAliveMs=30000"/>
</route>
<route>
<from uri="direct:search"/>
<to uri="elasticsearch://elasticsearch?operation=Search&indexName=twitter&useScroll=true&scrollKeepAliveMs=30000"/>
</route>
String query = "{\"query\":{\"match\":{\"doc.content\":\"new release of ApacheCamel\"}}}";
try (ElasticsearchScrollRequestIterator response = template.requestBody("direct:search", query, ElasticsearchScrollRequestIterator.class)) {
// do something smart with results
}
String query = "{\"query\":{\"match\":{\"doc.content\":\"new release of ApacheCamel\"}}}";
try (ElasticsearchScrollRequestIterator response = template.requestBody("direct:search", query, ElasticsearchScrollRequestIterator.class)) {
// do something smart with results
}
还可以使用。
22.10. MultiSearch 示例 复制链接链接已复制到粘贴板!
多搜索特定字段和值使用 Operation 'MultiSearch'。传递 MultiSearchRequest 实例
from("direct:multiSearch")
.to("elasticsearch://elasticsearch?operation=MultiSearch");
from("direct:multiSearch")
.to("elasticsearch://elasticsearch?operation=MultiSearch");
<route>
<from uri="direct:multiSearch"/>
<to uri="elasticsearch://elasticsearch?operation=MultiSearch"/>
</route>
<route>
<from uri="direct:multiSearch"/>
<to uri="elasticsearch://elasticsearch?operation=MultiSearch"/>
</route>
特定字段上的 MultiSearch
22.11. 文档类型 复制链接链接已复制到粘贴板!
对于所有搜索操作,可以指定检索的文档类型,以便结果已经与预期类型一起取消合并。
可使用标头 "documentClass" 或相同名称的 uri 参数来设置文档类型。
22.12. 在 Spring Boot 中使用 Camel Elasticsearch 复制链接链接已复制到粘贴板!
当您将 camel-elasticsearch-starter 与 Spring Boot v2 搭配使用时,您必须在您自己的 pom.xml 中声明以下依赖项:
<dependency> <groupId>jakarta.json</groupId> <artifactId>jakarta.json-api</artifactId> <version>2.0.2</version> </dependency>
<dependency>
<groupId>jakarta.json</groupId>
<artifactId>jakarta.json-api</artifactId>
<version>2.0.2</version>
</dependency>
这是必要的,因为 Spring Boot v2 提供了 jakarta.json-api:1.1.6,Elasticsearch 需要使用 json-api v2。
22.12.1. 使用 Spring Boot 提供的 RestClient 复制链接链接已复制到粘贴板!
默认情况下,Spring Boot 将自动配置 camel 将使用的 Elasticsearch RestClient,它可使用以下基本属性自定义客户端:
spring.elasticsearch.uris=myelkhost:9200 spring.elasticsearch.username=elkuser spring.elasticsearch.password=secure!!
spring.elasticsearch.uris=myelkhost:9200
spring.elasticsearch.username=elkuser
spring.elasticsearch.password=secure!!
如需更多信息,请参阅 application-properties.data.spring.elasticsearch.connection-timeout。
22.12.2. 在使用 Spring Boot 时禁用 Sniffer 复制链接链接已复制到粘贴板!
当 Spring Boot 位于 classpath 时,Elasticsearch 的 Sniffer 客户端会被默认启用。这个选项可以在 Spring Boot Configuration 中禁用:
spring:
autoconfigure:
exclude: org.springframework.boot.autoconfigure.elasticsearch.ElasticsearchRestClientAutoConfiguration
spring:
autoconfigure:
exclude: org.springframework.boot.autoconfigure.elasticsearch.ElasticsearchRestClientAutoConfiguration
22.13. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 elasticsearch 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-elasticsearch-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-elasticsearch-starter</artifactId>
</dependency>
组件支持 15 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.elasticsearch.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.elasticsearch.certificate-path | 用于访问 Elasticsearch 的自签名证书的路径。 | 字符串 | |
| camel.component.elasticsearch.client | 要使用现有配置的 Elasticsearch 客户端,而不是为每个端点创建客户端。这允许使用特定设置自定义客户端。选项是一个 org.elasticsearch.client.RestClient 类型。 | RestClient | |
| camel.component.elasticsearch.connection-timeout | 连接超时前等待的时间(ms)。 | 30000 | 整数 |
| camel.component.elasticsearch.enable-s-s-l | 启用 SSL。 | false | 布尔值 |
| camel.component.elasticsearch.enable-sniffer | 启用从正在运行的 Elasticsearch 集群中自动发现节点。如果将这个选项与 Spring Boot 结合使用,则由 Spring Boot 配置管理(请参阅:Spring Boot 中禁用 Sniffer)。 | false | 布尔值 |
| camel.component.elasticsearch.enabled | 是否启用 elasticsearch 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.elasticsearch.host-addresses | 以逗号分隔的带有要使用的 ip:port 格式的远程传输地址的列表。ip 和 port 选项必须留空,才能考虑 hostAddresses。 | 字符串 | |
| camel.component.elasticsearch.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.elasticsearch.max-retry-timeout | 重试前 ms 的时间。 | 30000 | 整数 |
| camel.component.elasticsearch.password | 进行身份验证的密码。 | 字符串 | |
| camel.component.elasticsearch.sniff-after-failure-delay | 失败后(以毫秒为单位)调度 sniff 执行的延迟。 | 60000 | 整数 |
| camel.component.elasticsearch.sniffer-interval | 以毫秒为单位连续执行间隔。当禁用 sniffOnFailure 时,或连续的 sniffOnFailure 之间没有故障时,将休眠。 | 300000 | 整数 |
| camel.component.elasticsearch.socket-timeout | 套接字超时前要等待的超时时间(ms)。 | 30000 | 整数 |
| camel.component.elasticsearch.user | 基本身份验证用户。 | 字符串 |
第 23 章 FHIR 复制链接链接已复制到粘贴板!
支持生成者和消费者
FHIR 组件与 HAPI-FHIR 库集成,这是 Java 中 FHIR (Fast Healthcare Interoperability Resources)规范的开源实现。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-fhir</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-fhir</artifactId>
<version>${camel-version}</version>
</dependency>
23.1. URI 格式 复制链接链接已复制到粘贴板!
FHIR 组件使用以下 URI 格式:
fhir://endpoint-prefix/endpoint?[options]
fhir://endpoint-prefix/endpoint?[options]
端点前缀可以是以下之一:
- 功能
- create
- delete
- history
- load-page
- meta
- operation
- patch
- 读取
- search
- 事务
- update
- validate
23.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
23.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
23.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
23.3. 组件选项 复制链接链接已复制到粘贴板!
FHIR 组件支持 27 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| encoding (common) | 用于所有请求的编码。 Enum 值:
| 字符串 | |
| fhirVersion (common) | 要使用的 FHIR 版本。 Enum 值:
| R4 | 字符串 |
| log (common) | 将记录每个请求和响应。 | false | 布尔值 |
| prettyPrint (common) | 用户友善打印所有请求。 | false | 布尔值 |
| serverUrl (common) | FHIR 服务器基础 URL。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| client (advanced) | 使用自定义客户端。 | IGenericClient | |
| clientFactory (advanced) | 使用自定义客户端工厂。 | IRestfulClientFactory | |
| 压缩 (高级) | 将传出(POST/PUT)内容压缩到 GZIP 格式。 | false | 布尔值 |
| 配置 (高级) | 使用共享配置。 | FhirConfiguration | |
| connectionTimeout (advanced) | 尝试和建立初始 TCP 连接的时间(以 ms 为单位)。 | 10000 | 整数 |
| deferModelScanning (advanced) | 当设置这个选项时,模型类不会扫描子类,直到实际访问给定类型的子列表。 | false | 布尔值 |
| fhirContext (advanced) | FhirContext 是一个昂贵的对象,可以创建。为避免创建多个实例,可以直接设置它。 | FhirContext | |
| forceConformanceCheck (advanced) | 强制一致性检查。 | false | 布尔值 |
| sessionCookie (advanced) | 要添加到每个请求的 HTTP 会话 Cookie。 | 字符串 | |
| socketTimeout (advanced) | 单个读/写操作阻止的时间(以 ms 为单位)。 | 10000 | 整数 |
| Summary (advanced) | 请求服务器使用 _summary 参数修改响应。 Enum 值:
| 字符串 | |
| validationMode (advanced) | 当应 Camel 验证 FHIR 服务器的一致声明时。 Enum 值:
| ONCE | 字符串 |
| proxyHost (proxy) | 代理主机。 | 字符串 | |
| proxyPassword (proxy) | 代理密码。 | 字符串 | |
| proxyPort (proxy) | 代理端口。 | 整数 | |
| proxyUser (proxy) | 代理用户名。 | 字符串 | |
| accessToken (security) | OAuth 访问令牌。 | 字符串 | |
| 密码 (安全) | 用于基本身份验证的用户名。 | 字符串 | |
| 用户名 (安全) | 用于基本身份验证的用户名。 | 字符串 |
23.4. 端点选项 复制链接链接已复制到粘贴板!
FHIR 端点使用 URI 语法进行配置:
fhir:apiName/methodName
fhir:apiName/methodName
使用以下路径和查询参数:
23.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| apiName (common) | 需要 采取什么操作。 Enum 值:
| FhirApiName | |
| methodName (common) | 必需的所选操作需要哪些子操作。 | 字符串 |
23.4.2. 查询参数(44 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| encoding (common) | 用于所有请求的编码。 Enum 值:
| 字符串 | |
| fhirVersion (common) | 要使用的 FHIR 版本。 Enum 值:
| R4 | 字符串 |
| inBody (common) | 设置要在交换 In Body 中传递的参数名称。 | 字符串 | |
| log (common) | 将记录每个请求和响应。 | false | 布尔值 |
| prettyPrint (common) | 用户友善打印所有请求。 | false | 布尔值 |
| serverUrl (common) | FHIR 服务器基础 URL。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| client (advanced) | 使用自定义客户端。 | IGenericClient | |
| clientFactory (advanced) | 使用自定义客户端工厂。 | IRestfulClientFactory | |
| 压缩 (高级) | 将传出(POST/PUT)内容压缩到 GZIP 格式。 | false | 布尔值 |
| connectionTimeout (advanced) | 尝试和建立初始 TCP 连接的时间(以 ms 为单位)。 | 10000 | 整数 |
| deferModelScanning (advanced) | 当设置这个选项时,模型类不会扫描子类,直到实际访问给定类型的子列表。 | false | 布尔值 |
| fhirContext (advanced) | FhirContext 是一个昂贵的对象,可以创建。为避免创建多个实例,可以直接设置它。 | FhirContext | |
| forceConformanceCheck (advanced) | 强制一致性检查。 | false | 布尔值 |
| sessionCookie (advanced) | 要添加到每个请求的 HTTP 会话 Cookie。 | 字符串 | |
| socketTimeout (advanced) | 单个读/写操作阻止的时间(以 ms 为单位)。 | 10000 | 整数 |
| Summary (advanced) | 请求服务器使用 _summary 参数修改响应。 Enum 值:
| 字符串 | |
| validationMode (advanced) | 当应 Camel 验证 FHIR 服务器的一致声明时。 Enum 值:
| ONCE | 字符串 |
| proxyHost (proxy) | 代理主机。 | 字符串 | |
| proxyPassword (proxy) | 代理密码。 | 字符串 | |
| proxyPort (proxy) | 代理端口。 | 整数 | |
| proxyUser (proxy) | 代理用户名。 | 字符串 | |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| accessToken (security) | OAuth 访问令牌。 | 字符串 | |
| 密码 (安全) | 用于基本身份验证的用户名。 | 字符串 | |
| 用户名 (安全) | 用于基本身份验证的用户名。 | 字符串 |
23.5. API 参数(13 API) 复制链接链接已复制到粘贴板!
@FHIR 端点是基于 API 的组件,具有额外的参数,它基于使用的 API 名称和 API 方法。API 名称和 API 方法位于端点 URI 中,作为 apiName/methodName 路径参数:
fhir:apiName/methodName
fhir:apiName/methodName
下表中列出了 13 个 API 名称:
| API 名称 | 类型 | 描述 |
|---|---|---|
| 两者 | API 为 Fetch 服务器的 capabilities 语句 | |
| 两者 | 创建操作的 API,它会在服务器上创建新资源实例 | |
| 两者 | 删除操作的 API,它会在服务器资源上执行逻辑删除 | |
| 两者 | 历史记录方法的 API | |
| 两者 | 使用 atom 捆绑包中的链接 type=next 标签中指定的链接,从页面集中加载先前/下一步捆绑包的 API | |
| 两者 | meta 操作的 API,可用于从资源或服务器中获取、添加和删除标签和其他 Meta 元素 | |
| 两者 | 用于扩展 FHIR 操作的 API | |
| 两者 | 补丁操作的 API,它会在服务器资源上执行逻辑补丁 | |
| 两者 | 读取操作的 API 方法 | |
| 两者 | API 搜索与给定条件匹配的资源 | |
| 两者 | 用于将事务(资源集合)发送到要作为单个单元执行的服务器的 API | |
| 两者 | 更新操作的 API,它会在服务器资源上执行逻辑删除 | |
| 两者 | 用于验证资源的 API |
每个 API 都记录在以下部分中。
23.5.1. API: capabilities 复制链接链接已复制到粘贴板!
支持生成者和消费者
capabilities API 采用语法定义,如下所示:
fhir:capabilities/methodName?[parameters]
fhir:capabilities/methodName?[parameters]
该方法列在下表中,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 使用给定的模型类型检索 conformance 语句 |
23.5.1.1. Type 方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseConformance ofType (Class<org.hl7.fhir.instance.model.api.IBaseConformance> type, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/ofType API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| type | 模型类型 | 类 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.2. API: create 复制链接链接已复制到粘贴板!
支持生成者和消费者
create API 采用语法定义,如下所示:
fhir:create/methodName?[parameters]
fhir:create/methodName?[parameters]
下表中列出了 1 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 在服务器上创建一个 IBaseResource |
23.5.2.1. 方法资源 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome 资源(String resourceAsString, String url, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- CA.uhn.fhir.rest.api.MethodOutcome 资源(org.hl7.fhir.instance.model.api.IBaseResource 资源, String url, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resource API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| preferReturn | 在请求中添加 Prefer 标头,其请求服务器包含或阻止资源正文作为结果的一部分。如果服务器返回资源,它将通过 MethodOutcome114getResource ()解析客户端可访问,则可能是 null | PreferReturnEnum |
| resource | 要创建的资源 | IBaseResource |
| resourceAsString | 要创建的资源 | 字符串 |
| url | 要使用的搜索 URL。这个 URL 的格式应为 ResourceTypeParameters,例如: Patientname=Smith&identifier=13.2.4.11.4%7C847366,可能是 null | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.3. API: delete 复制链接链接已复制到粘贴板!
支持生成者和消费者
删除 API 采用语法定义,如下所示:
fhir:delete/methodName?[parameters]
fhir:delete/methodName?[parameters]
下表中列出了 3 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 删除给定资源 | |
| 根据资源类型删除资源,例如 | |
| 指定应作为条件删除对给定搜索 URL 执行删除 |
23.5.3.1. 方法资源 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseOperationOutcome resource (org.hl7.fhir.instance.model.api.IBaseResource 资源, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resource API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| resource | 要删除的 IBaseResource | IBaseResource |
23.5.3.2. method resourceById 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseOperationOutcome resourceById (String type, String stringId, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseOperationOutcome resourceById (org.hl7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resourceById API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | IIdType 引用资源 | IIdType |
| stringId | 它 ID | 字符串 |
| type | 资源类型,如 Patient | 字符串 |
23.5.3.3. method resourceConditionalByUrl 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseOperationOutcome resourceConditionalByUrl (String url, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resourceConditionalByUrl API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| url | 要使用的搜索 URL。这个 URL 的格式应为 ResourceTypeParameters,例如: Patientname=Smith&identifier=13.2.4.11.4%7C847366 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.4. api: history 复制链接链接已复制到粘贴板!
支持生成者和消费者
history API 采用语法定义,如下所示:
fhir:history/methodName?[parameters]
fhir:history/methodName?[parameters]
下表中列出了 3 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 在服务器中特定资源的所有版本(按 ID 和类型)执行操作 | |
| 在服务器上所有类型的所有版本中执行操作 | |
| 在服务器中给定类型的所有版本中执行操作 |
23.5.4.1. 对Instance 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle onInstance (org.hl7.fhir.instance.model.api.IIdType id, Class<org.hl7.fhir.instance.model.api.IBaseBundle> returnType, Integer count, java.util.Date cutoff, org.hl7.fhir.instance.model.api.IPrimitiveType<java.util.Date> iCutoff, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onInstance API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| æ•°é‡� | 请求服务器仅返回到Count 个资源数量,可以是 NULL | 整数 |
| cutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | Date |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| iCutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | IPrimitiveType |
| id | IIdType,它必须同时填充资源类型和资源 ID | IIdType |
| returnType | 请求该方法会返回 Bundle 资源(如 ca.uhn.fhir.model.dstu2.resource.Bundle)。如果您要访问 DSTU2 服务器,请使用此方法。 | 类 |
23.5.4.2. Server 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle onServer (Class<org.hl7.fhir.instance.model.api.IBaseBundle> returnType, Integer count, java.util.Date cutoff, org.hl7.fhir.instance.model.api.IPrimitiveType<java.util.Date> iCutoff, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onServer API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| æ•°é‡� | 请求服务器仅返回到Count 个资源数量,可以是 NULL | 整数 |
| cutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | Date |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| iCutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | IPrimitiveType |
| returnType | 请求该方法会返回 Bundle 资源(如 ca.uhn.fhir.model.dstu2.resource.Bundle)。如果您要访问 DSTU2 服务器,请使用此方法。 | 类 |
23.5.4.3. Type 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle onType (Class<org.hl7.fhir.instance.model.api.IBaseResource> resourceType, Class<org.hl7.fhir.instance.model.api.IBaseBundle> returnType, Integer count, java.util.Date cutoff, org.hl7.fhir.instance.model.api.IPrimitiveType<java.util.Date> iCutoff, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onType API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| æ•°é‡� | 请求服务器仅返回到Count 个资源数量,可以是 NULL | 整数 |
| cutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | Date |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| iCutoff | 请求服务器只返回在给定时间(包括)时创建的资源版本,可能是 NULL | IPrimitiveType |
| resourceType | 要搜索的资源类型 | 类 |
| returnType | 请求该方法会返回 Bundle 资源(如 ca.uhn.fhir.model.dstu2.resource.Bundle)。如果您要访问 DSTU2 服务器,请使用此方法。 | 类 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.5. api: load-page 复制链接链接已复制到粘贴板!
支持生成者和消费者
load-page API 在语法中定义,如下所示:
fhir:load-page/methodName?[parameters]
fhir:load-page/methodName?[parameters]
下表中列出了 3 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 使用给定的 URL 和捆绑包类型加载结果页面,并返回 DSTU1 Atom 捆绑包 | |
| 使用捆绑包中关系的链接加载下一个结果页面 | |
| 使用捆绑包中关系 prev 的链接加载前面的结果页面 |
23.5.5.1. 方法 byUrl 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle byUrl (String url, Class<org.hl7.fhir.instance.model.api.IBaseBundle> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/byUrl API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| returnType | 返回类型 | 类 |
| url | 搜索 url | 字符串 |
23.5.5.2. Next 方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle next (org.hl7.fhir.instance.model.api.IBaseBundle bundle, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/next API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| bundle | IBaseBundle | IBaseBundle |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
23.5.5.3. 前一个方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle previous (org.hl7.fhir.instance.model.api.IBaseBundle bundle, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/previous API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| bundle | IBaseBundle | IBaseBundle |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.6. api: meta 复制链接链接已复制到粘贴板!
支持生成者和消费者
meta API 在语法中定义,如下所示:
fhir:meta/methodName?[parameters]
fhir:meta/methodName?[parameters]
下表中列出了 5 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 将给定元数据中的元素添加到现有集合(请勿删除任何) | |
| 从给定的 ID 中删除给定元数据中的元素 | |
| 从特定资源获取当前元数据 | |
| 从整个服务器获取当前元数据 | |
| 从特定类型的获取当前元数据 |
23.5.6.1. 方法添加 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseMetaType add (org.hl7.fhir.instance.model.api.IBaseMetaType meta, org.hl7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/add API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | id | IIdType |
| meta | IBaseMetaType 类 | IBaseMetaType |
23.5.6.2. method delete 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseMetaType delete (org.hl7.fhir.instance.model.api.IBaseMetaType meta, org.hl7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/delete API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | id | IIdType |
| meta | IBaseMetaType 类 | IBaseMetaType |
23.5.6.3. method getFromResource 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseMetaType getFromResource (Class<org.hl7.fhir.instance.model.api.IBaseMetaType> metaType, org.hl7.fhir.instance.model.api.IIdType id, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/getFromResource API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | id | IIdType |
| metaType | IBaseMetaType 类 | 类 |
23.5.6.4. method getFromServer 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseMetaType getFromServer (Class<org.hl7.fhir.instance.model.api.IBaseMetaType> metaType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/getFromServer API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| metaType | 给定 FHIR 模型版本的 meta 数据类型的类型(应该为 MetaDt.class 或 MetaType.class) | 类 |
23.5.6.5. method getFromType 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseMetaType getFromType (Class<org.hl7.fhir.instance.model.api.IBaseMetaType> metaType, String resourceType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/getFromType API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| metaType | IBaseMetaType 类 | 类 |
| resourceType | 资源类型,如 Patient | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.7. api: operation 复制链接链接已复制到粘贴板!
支持生成者和消费者
操作 API 采用语法定义,如下所示:
fhir:operation/methodName?[parameters]
fhir:operation/methodName?[parameters]
下表中列出了 5 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 在服务器中特定资源的所有版本(按 ID 和类型)执行操作 | |
| 此操作在资源的特定版本上运行 | |
| 在服务器上所有类型的所有版本中执行操作 | |
| 在服务器中给定类型的所有版本中执行操作 | |
| 此操作称为 $process-message,如 FHIR 规格定义 |
23.5.7.1. 对Instance 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource onInstance (org.hl7.fhir.instance.model.api.IIdType id, String name, org.hl7.fhir.instance.model.api.IBaseParameters parameters, Class<org.hl7.fhir.instance.model.api.IBaseParameters> outputParameterType, 布尔值使用HttpGet, Class<org.hl7.fhir.instance.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onInstance API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | 资源(版本将被剥离) | IIdType |
| name | 操作名称 | 字符串 |
| outputParameterType | 输出参数使用的类型(这应该设置为来自您使用的 FHIR 结构版本的 Parameters.class drawn),可以是 NULL | 类 |
| parameters | 用作输入的参数。如果操作不需要任何输入参数,则可能是 null。 | IBaseParameters |
| returnType | 如果此操作将单个资源正文返回类型而不是 Parameters 资源,请使用此方法指定该资源类型。这对返回捆绑包而不是 Parameters 资源的某些操作(如 Patient/NNN/$everything)非常有用,可以是 NULL | 类 |
| useHttpGet | 使用 HTTP GET 动词 | 布尔值 |
23.5.7.2. 方法 onInstanceVersion 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource onInstanceVersion (org.hl7.fhir.instance.model.api.IIdType id, String name, org.hl7.fhir.instance.model.api.IBaseParameters parameters, Class<org.hl7.fhir.instance.model.api.IBaseParameters> outputParameterType, 布尔值使用HttpGet, Class<org.hl7.fhir.instance.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onInstanceVersion API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | 资源版本 | IIdType |
| name | 操作名称 | 字符串 |
| outputParameterType | 输出参数使用的类型(这应该设置为来自您使用的 FHIR 结构版本的 Parameters.class drawn),可以是 NULL | 类 |
| parameters | 用作输入的参数。如果操作不需要任何输入参数,则可能是 null。 | IBaseParameters |
| returnType | 如果此操作将单个资源正文返回类型而不是 Parameters 资源,请使用此方法指定该资源类型。这对返回捆绑包而不是 Parameters 资源的某些操作(如 Patient/NNN/$everything)非常有用,可以是 NULL | 类 |
| useHttpGet | 使用 HTTP GET 动词 | 布尔值 |
23.5.7.3. Server 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource onServer (String name, org.hl7.fhir.instance.model.api.IBaseParameters parameters, Class<org.hl7.fhir.instance.model.api.IBaseParameters> outputParameterType, boolean useHttpGet, Class<org.hl7.fhir.instance.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onServer API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| name | 操作名称 | 字符串 |
| outputParameterType | 输出参数使用的类型(这应该设置为来自您使用的 FHIR 结构版本的 Parameters.class drawn),可以是 NULL | 类 |
| parameters | 用作输入的参数。如果操作不需要任何输入参数,则可能是 null。 | IBaseParameters |
| returnType | 如果此操作将单个资源正文返回类型而不是 Parameters 资源,请使用此方法指定该资源类型。这对返回捆绑包而不是 Parameters 资源的某些操作(如 Patient/NNN/$everything)非常有用,可以是 NULL | 类 |
| useHttpGet | 使用 HTTP GET 动词 | 布尔值 |
23.5.7.4. Type 的方法 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource onType (Class<org.hl7.fhir.instance.model.api.IBaseResource> resourceType, String name, org.hl7.fhir.instance.model.api.IBaseParameters parameters, Class<org.hl7.fhir.instance.model.api.IBaseParameters> outputParameterType, 布尔值使用HttpGet, Class<org.hl7.fhir.instance.model.api.IBaseResource> returnType, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/onType API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| name | 操作名称 | 字符串 |
| outputParameterType | 输出参数使用的类型(这应该设置为来自您使用的 FHIR 结构版本的 Parameters.class drawn),可以是 NULL | 类 |
| parameters | 用作输入的参数。如果操作不需要任何输入参数,则可能是 null。 | IBaseParameters |
| resourceType | 要操作的资源类型 | 类 |
| returnType | 如果此操作将单个资源正文返回类型而不是 Parameters 资源,请使用此方法指定该资源类型。这对返回捆绑包而不是 Parameters 资源的某些操作(如 Patient/NNN/$everything)非常有用,可以是 NULL | 类 |
| useHttpGet | 使用 HTTP GET 动词 | 布尔值 |
23.5.7.5. method processMessage 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle processMessage (String respondToUri, org.hl7.fhir.instance.model.api.IBaseBundle msgBundle, boolean asynchronous, Class<org.hl7.fhir.instance.model.api.IBaseBundle> responseClass, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/processMessage API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| 异步 | 是否异步处理消息还是同步,默认为 sync。 | 布尔值 |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| msgBundle | 将 Message Bundle 设置为 POST 到消息传递服务器 | IBaseBundle |
| respondToUri | 可选的查询参数表示来自接收服务器的响应应发送到此 URI,可能是 NULL | 字符串 |
| responseClass | 响应类 | 类 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.8. API: patch 复制链接链接已复制到粘贴板!
支持生成者和消费者
patch API 采用语法定义,如下所示:
fhir:patch/methodName?[parameters]
fhir:patch/methodName?[parameters]
下表中列出了 2 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 将补丁应用到给定资源 ID | |
| 指定应作为条件创建对给定搜索 URL 执行更新 |
23.5.8.1. method patchById 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome patchById (String patchBody, String stringId, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- CA.uhn.fhir.rest.api.MethodOutcome patchById (String patchBody, org.hl7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/patchById API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | 要修补的资源 ID | IIdType |
| patchBody | 补丁文档的正文在 XML 或 JSON 中进行序列化,它们符合 | 字符串 |
| preferReturn | 在请求中添加 Prefer 标头,其请求服务器包含或阻止资源正文作为结果的一部分。如果服务器返回资源,它将通过 MethodOutcome114getResource ()解析客户端可访问 | PreferReturnEnum |
| stringId | 要修补的资源 ID | 字符串 |
23.5.8.2. method patchByUrl 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome patchByUrl (String patchBody, String url, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/patchByUrl API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| patchBody | 补丁文档的正文在 XML 或 JSON 中进行序列化,它们符合 | 字符串 |
| preferReturn | 在请求中添加 Prefer 标头,其请求服务器包含或阻止资源正文作为结果的一部分。如果服务器返回资源,它将通过 MethodOutcome114getResource ()解析客户端可访问 | PreferReturnEnum |
| url | 要使用的搜索 URL。这个 URL 的格式应为 ResourceTypeParameters,例如: Patientname=Smith&identifier=13.2.4.11.4%7C847366 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.9. API: read 复制链接链接已复制到粘贴板!
支持生成者和消费者
read API 采用语法定义,如下所示:
fhir:read/methodName?[parameters]
fhir:read/methodName?[parameters]
下表中列出了 2 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 通过 id 读取服务器上的 IBaseResource | |
| 通过 url 读取服务器上的 IBaseResource |
23.5.9.1. method resourceById 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (Class<org.hl7.fhir.instance.model.api.IBaseResource> resource, Long longId, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, boolean throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (Class<org.hl7.fhir.instance.model.api.IBaseResource> resource, String stringId, String version, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, boolean throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (Class<org.hl7.fhir.instance.model.api.IBaseResource> resource, org.hl7.fhir.instance.model.api.IIdType id, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, 布尔值 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (String resourceClass, Long longId, String ifVersionMatches, boolean returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, 布尔值 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (String resourceClass, String stringId, String ifVersionMatches, String version, boolean returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, 布尔值 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceById (String resourceClass, org.hl7.fhir.instance.model.api.IIdType id, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, boolean throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resourceById API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | IIdType 引用资源 | IIdType |
| ifVersionMatches | 与服务器中最新版本匹配的版本 | 字符串 |
| longId | 资源 ID | Long |
| resource | 要读取的资源(如 Patient) | 类 |
| resourceClass | 要读取的资源(如 Patient) | 字符串 |
| returnNull | 如果版本匹配,则返回 null | 布尔值 |
| returnResource | 如果版本匹配,则返回资源 | IBaseResource |
| stringId | 资源 ID | 字符串 |
| throwError | 如果版本匹配,抛出错误 | 布尔值 |
| version | 资源版本 | 字符串 |
23.5.9.2. method resourceByUrl 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseResource resourceByUrl (Class<org.hl7.fhir.instance.model.api.IBaseResource> resource, String url, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, boolean throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceByUrl (Class<org.hl7.fhir.instance.model.api.IBaseResource> resource, org.hl7.fhir.instance.model.api.IIdType iUrl, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, 布尔值 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceByUrl (String resourceClass, String url, String ifVersionMatches, boolean returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, 布尔值 throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseResource resourceByUrl (String resourceClass, org.hl7.fhir.instance.model.api.IIdType iUrl, String ifVersionMatches, 布尔值 returnNull, org.hl7.fhir.instance.model.api.IBaseResource returnResource, boolean throwError, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resourceByUrl API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| iUrl | IIdType 通过绝对 url 引用资源 | IIdType |
| ifVersionMatches | 与服务器中最新版本匹配的版本 | 字符串 |
| resource | 要读取的资源(如 Patient) | 类 |
| resourceClass | 要读取的资源(如 Patient.class) | 字符串 |
| returnNull | 如果版本匹配,则返回 null | 布尔值 |
| returnResource | 如果版本匹配,则返回资源 | IBaseResource |
| throwError | 如果版本匹配,抛出错误 | 布尔值 |
| url | 通过绝对 url 引用资源 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.10. api: search 复制链接链接已复制到粘贴板!
支持生成者和消费者
搜索 API 的语法定义,如下所示:
fhir:search/methodName?[parameters]
fhir:search/methodName?[parameters]
下表中列出了 1 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 通过 URL 直接执行搜索 |
23.5.10.1. method searchByUrl 复制链接链接已复制到粘贴板!
签名:
- org.hl7.fhir.instance.model.api.IBaseBundle searchByUrl (String url, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/searchByUrl API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| url | 要搜索的 URL。请注意,此 URL 可以完成(例如,),在这种情况下,客户端的基本 URL 将被忽略。或者,它可以被相对(例如,Patientname=foo),在这种情况下,客户端的基本 URL 将会被使用。 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.11. API: transaction 复制链接链接已复制到粘贴板!
支持生成者和消费者
transaction API 的语法定义,如下所示:
fhir:transaction/methodName?[parameters]
fhir:transaction/methodName?[parameters]
下表中列出了 2 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 使用给定的原始文本(应该是 Bundle 资源)作为事务输入 | |
| 使用资源列表作为事务输入 |
23.5.11.1. 带有Bundle 的方法 复制链接链接已复制到粘贴板!
签名:
- 带有Bundle (String stringBundle, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- org.hl7.fhir.instance.model.api.IBaseBundle withBundle (org.hl7.fhir.instance.model.api.IBaseBundle bundle, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/withBundle API 方法包含下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| bundle | 在事务中使用的捆绑包 | IBaseBundle |
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| stringBundle | 在事务中使用的捆绑包 | 字符串 |
23.5.11.2. 带有Resources 的方法 复制链接链接已复制到粘贴板!
签名:
- java.util.List<org.hl7.fhir.instance.model.api.IBaseResource> withResources (java.util.List<org.hl7.fhir.instance.model.api.IBaseResource> resources, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/withResources API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| 资源 | 在事务中使用的资源 | list |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.12. API: update 复制链接链接已复制到粘贴板!
支持生成者和消费者
更新 API 的语法定义,如下所示:
fhir:update/methodName?[parameters]
fhir:update/methodName?[parameters]
下表中列出了 2 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 通过 id 更新服务器上的 IBaseResource | |
| 通过搜索 url 更新服务器上的 IBaseResource |
23.5.12.1. 方法资源 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome 资源(String resourceAsString, String stringId, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- CA.uhn.fhir.rest.api.MethodOutcome 资源(String resourceAsString, org.hl7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- CA.uhn.fhir.rest.api.MethodOutcome 资源(org.hl7.fhir.instance.model.api.IBaseResource 资源, String stringId, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- ca.uhn.fhir.rest.api.MethodOutcome resource (org.hl7.fhir.instance.model.api.IBaseResource 资源, org.hl7.fhir.instance.model.api.IIdType id, ca.uhn.fhir.rest.api.PreferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resource API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| id | IIdType 引用资源 | IIdType |
| preferReturn | 在结果中,服务器是否包含或阻止资源正文 | PreferReturnEnum |
| resource | 要更新的资源(如 Patient) | IBaseResource |
| resourceAsString | 要更新的资源正文 | 字符串 |
| stringId | 引用资源的 ID | 字符串 |
23.5.12.2. method resourceBySearchUrl 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome resourceBySearchUrl (String resourceAsString, String url, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- CA.uhn.fhir.rest.api.MethodOutcome resourceBySearchUrl (org.hl7.fhir.instance.model.api.IBaseResource 资源, String url, ca.uhn.fhir.rest.api.PreferReturnEnum preferReturn, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resourceBySearchUrl API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| preferReturn | 在结果中,服务器是否包含或阻止资源正文 | PreferReturnEnum |
| resource | 要更新的资源(如 Patient) | IBaseResource |
| resourceAsString | 要更新的资源正文 | 字符串 |
| url | 指定应作为条件创建对给定搜索 URL 执行更新 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.5.13. api: validate 复制链接链接已复制到粘贴板!
支持生成者和消费者
validate API 采用语法定义,如下所示:
fhir:validate/methodName?[parameters]
fhir:validate/methodName?[parameters]
下表中列出了 1 方法,后跟每种方法的详细语法。(API 方法可以有一个简短的别名名称,可在语法而不是名称中使用)
| 方法 | 描述 |
|---|---|
| 验证资源 |
23.5.13.1. 方法资源 复制链接链接已复制到粘贴板!
签名:
- ca.uhn.fhir.rest.api.MethodOutcome 资源(String resourceAsString, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
- ca.uhn.fhir.rest.api.MethodOutcome 资源(org.hl7.fhir.instance.model.api.IBaseResource 资源, java.util.Map<org.apache.camel.component.fhir.api.ExtraParameters, Object> extraParameters);
fhir/resource API 方法有下表中列出的参数:
| 参数 | 描述 | 类型 |
|---|---|---|
| extraParameters | 如需可传递的完整参数列表,请参阅 ExtraParameters,可以是 NULL | Map |
| resource | 用于验证的 IBaseResource | IBaseResource |
| resourceAsString | 验证的原始资源 | 字符串 |
除了以上参数外,fhir API 也可以使用任何 查询参数。
任何参数都可以在端点 URI 中提供,也可以在消息标头中动态提供。消息标头名称必须是 CamelFhir.parameter 格式。inBody 参数覆盖消息标头,即 Body=myParameterNameHere 中的端点参数将覆盖 CamelFhir.myParameterNameHere 标头。
23.6. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 fhir 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-fhir-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-fhir-starter</artifactId>
</dependency>
组件支持 56 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.fhir.access-token | OAuth 访问令牌。 | 字符串 | |
| camel.component.fhir.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.fhir.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.fhir.client | 使用自定义客户端。选项是一个 ca.uhn.fhir.rest.client.api.IGenericClient 类型。 | IGenericClient | |
| camel.component.fhir.client-factory | 使用自定义客户端工厂。选项是一个 ca.uhn.fhir.rest.client.api.IRestfulClientFactory 类型。 | IRestfulClientFactory | |
| camel.component.fhir.compress | 将传出(POST/PUT)内容压缩到 GZIP 格式。 | false | 布尔值 |
| camel.component.fhir.configuration | 使用共享配置。选项是 org.apache.camel.component.fhir.FhirConfiguration 类型。 | FhirConfiguration | |
| camel.component.fhir.connection-timeout | 尝试和建立初始 TCP 连接的时间(以 ms 为单位)。 | 10000 | 整数 |
| camel.component.fhir.defer-model-scanning | 当设置这个选项时,模型类不会扫描子类,直到实际访问给定类型的子列表。 | false | 布尔值 |
| camel.component.fhir.enabled | 是否启用 fhir 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.fhir.encoding | 用于所有请求的编码。 | 字符串 | |
| camel.component.fhir.fhir-context | FhirContext 是一个昂贵的对象,可以创建。为避免创建多个实例,可以直接设置它。选项是一个 ca.uhn.fhir.context.FhirContext 类型。 | FhirContext | |
| camel.component.fhir.fhir-version | 要使用的 FHIR 版本。 | R4 | 字符串 |
| camel.component.fhir.force-conformance-check | 强制一致性检查。 | false | 布尔值 |
| camel.component.fhir.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.fhir.log | 将记录每个请求和响应。 | false | 布尔值 |
| camel.component.fhir.password | 用于基本身份验证的用户名。 | 字符串 | |
| camel.component.fhir.pretty-print | 用户友善打印所有请求。 | false | 布尔值 |
| camel.component.fhir.proxy-host | 代理主机。 | 字符串 | |
| camel.component.fhir.proxy-password | 代理密码。 | 字符串 | |
| camel.component.fhir.proxy-port | 代理端口。 | 整数 | |
| camel.component.fhir.proxy-user | 代理用户名。 | 字符串 | |
| camel.component.fhir.server-url | FHIR 服务器基础 URL。 | 字符串 | |
| camel.component.fhir.session-cookie | 要添加到每个请求的 HTTP 会话 Cookie。 | 字符串 | |
| camel.component.fhir.socket-timeout | 单个读/写操作阻止的时间(以 ms 为单位)。 | 10000 | 整数 |
| camel.component.fhir.summary | 请求服务器使用 _summary 参数修改响应。 | 字符串 | |
| camel.component.fhir.username | 用于基本身份验证的用户名。 | 字符串 | |
| camel.component.fhir.validation-mode | 当应 Camel 验证 FHIR 服务器的一致声明时。 | ONCE | 字符串 |
| camel.dataformat.fhirjson.content-type-header | 数据格式是否应使用数据格式的类型设置 Content-Type 标头。例如,用于数据格式的 application/xml 例如,marshalling 到 XML,对于数据格式为 JSON,application/json 用于数据格式。 | true | 布尔值 |
| camel.dataformat.fhirjson.dont-encode-elements | 如果提供,请指定不应编码的元素。此字段的有效值包括: 德语 - Don't encode the the all sub Patient.name - Don't encode the the Patient.name.family - Don't encode the the family's family name .text - Don't encode the text element on any resource (只有最第一个位置可能包含通配符)DSTU2 备注: 请注意,包括 meta 的值(如 Patient.meta)将可用于 DSTU2 解析器,但 meta 上的子元素的值(如 Patient.meta.lastUpdated )只能在 DSTU3 模式中工作。 | Set | |
| camel.dataformat.fhirjson.dont-strip-versions-from-references-at-paths | 如果提供的值,指定路径上的任何资源引用都会编码其资源版本,而不是在编码过程中自动剥离。此设置对解析过程没有影响。这个方法提供了比 setStripVersionsFromReferences (String)和此方法指定的任何路径更精细的控制级别,即使 setStripVersionsFromReferences (String)已设置为 true (默认值)。 | list | |
| camel.dataformat.fhirjson.enabled | 是否启用 fhirJson 数据格式的自动配置。这默认是启用的。 | 布尔值 | |
| camel.dataformat.fhirjson.encode-elements | 如果提供,请指定应编码的元素,以排除所有其他元素。此字段的有效值包括:Patient - Encode the and all child Patient.name - Encode only the Patient.name.family - Encode only the good's 系列名称 .text - Encode - 对任何资源上的文本元素进行编码(仅限第一个位置可能包含通配符)-(必需)- 这个特殊情况,它导致任何资源的系列名称(最小 0)被编码。 | Set | |
| camel.dataformat.fhirjson.encode-elements-applies-to-child-resources-only | 如果设置为 true (默认为 false),则提供给 setEncodeElements (Set)的值不会应用到根资源(通常是 Bundle),但将应用到包含在其中的任何子资源(例如,搜索捆绑包中的资源)。 | false | 布尔值 |
| camel.dataformat.fhirjson.fhir-version | 要使用的 FHIR 版本。可能的值有:DSTU2,DSTU2_HL7ORG,DSTU2_1,DSTU3,R4。 | DSTU3 | 字符串 |
| camel.dataformat.fhirjson.omit-resource-id | 如果设置为 true (默认为 false),则编码的任何资源的 ID 不会包含在输出中。请注意,这不适用于包含的资源,仅适用于 root 资源。换句话说,如果这设为 true,则包含的资源仍会具有本地 ID,但外部/包含 ID 将不会有 ID。 | false | 布尔值 |
| camel.dataformat.fhirjson.override-resource-id-with-bundle-entry-full-url | 如果设置为 true (默认值),如果定义了 fullUrl,Bundle.entry.fullUrl 将覆盖 Bundle.entry.resource 的资源 ID。在将源数据解析到 Bundle 对象时,会发生此行为。如果这不是所需行为,则将其设置为 false (例如,客户端代码希望在 fullUrl 和资源 ID 之间执行额外的验证检查)。 | false | 布尔值 |
| camel.dataformat.fhirjson.pretty-print | 设置用户友善的 print 标志,这意味着解析器将使用人类可读和元素之间的新行编码资源,而不是尽可能高的输出。 | false | 布尔值 |
| camel.dataformat.fhirjson.server-base-url | 设置此解析器使用的服务器基本 URL。如果设置了值,如果资源引用以绝对 URL 提供,但具有与给定基础匹配的基础,则资源引用将转换为相对引用。 | 字符串 | |
| camel.dataformat.fhirjson.strip-versions-from-references | 如果设置为 true (默认值),则包含版本的资源引用将在编码资源时删除版本。这通常很好,因为在大多数情况下,从一个资源到另一个资源的引用应该是按 ID 到资源,而不是按 ID 和版本对资源。然而,在某些情况下可能需要在资源链接中保留版本。在这种情况下,这个值应设为 false。这个方法提供了全局禁用参考编码的功能。如果需要精细控制,请使用 setDontStripVersionsFromReferencesAtPaths (List)。 | false | 布尔值 |
| camel.dataformat.fhirjson.summary-mode | 如果设置为 true (默认为 false),则仅包含 FHIR 规格标记为概述元素的元素。 | false | 布尔值 |
| camel.dataformat.fhirjson.suppress-narratives | 如果设置为 true (默认为 false),则 narratives 不会包含在编码的值中。 | false | 布尔值 |
| camel.dataformat.fhirxml.content-type-header | 数据格式是否应使用数据格式的类型设置 Content-Type 标头。例如,用于数据格式的 application/xml 例如,marshalling 到 XML,对于数据格式为 JSON,application/json 用于数据格式。 | true | 布尔值 |
| camel.dataformat.fhirxml.dont-encode-elements | 如果提供,请指定不应编码的元素。此字段的有效值包括: 德语 - Don't encode the the all sub Patient.name - Don't encode the the Patient.name.family - Don't encode the the family's family name .text - Don't encode the text element on any resource (只有最第一个位置可能包含通配符)DSTU2 备注: 请注意,包括 meta 的值(如 Patient.meta)将可用于 DSTU2 解析器,但 meta 上的子元素的值(如 Patient.meta.lastUpdated )只能在 DSTU3 模式中工作。 | Set | |
| camel.dataformat.fhirxml.dont-strip-versions-from-references-at-paths | 如果提供的值,指定路径上的任何资源引用都会编码其资源版本,而不是在编码过程中自动剥离。此设置对解析过程没有影响。这个方法提供了比 setStripVersionsFromReferences (String)和此方法指定的任何路径更精细的控制级别,即使 setStripVersionsFromReferences (String)已设置为 true (默认值)。 | list | |
| camel.dataformat.fhirxml.enabled | 是否启用 fhirXml 数据格式的自动配置。这默认是启用的。 | 布尔值 | |
| camel.dataformat.fhirxml.encode-elements | 如果提供,请指定应编码的元素,以排除所有其他元素。此字段的有效值包括:Patient - Encode the and all child Patient.name - Encode only the Patient.name.family - Encode only the good's 系列名称 .text - Encode - 对任何资源上的文本元素进行编码(仅限第一个位置可能包含通配符)-(必需)- 这个特殊情况,它导致任何资源的系列名称(最小 0)被编码。 | Set | |
| camel.dataformat.fhirxml.encode-elements-applies-to-child-resources-only | 如果设置为 true (默认为 false),则提供给 setEncodeElements (Set)的值不会应用到根资源(通常是 Bundle),但将应用到包含在其中的任何子资源(例如,搜索捆绑包中的资源)。 | false | 布尔值 |
| camel.dataformat.fhirxml.fhir-version | 要使用的 FHIR 版本。可能的值有:DSTU2,DSTU2_HL7ORG,DSTU2_1,DSTU3,R4。 | DSTU3 | 字符串 |
| camel.dataformat.fhirxml.omit-resource-id | 如果设置为 true (默认为 false),则编码的任何资源的 ID 不会包含在输出中。请注意,这不适用于包含的资源,仅适用于 root 资源。换句话说,如果这设为 true,则包含的资源仍会具有本地 ID,但外部/包含 ID 将不会有 ID。 | false | 布尔值 |
| camel.dataformat.fhirxml.override-resource-id-with-bundle-entry-full-url | 如果设置为 true (默认值),如果定义了 fullUrl,Bundle.entry.fullUrl 将覆盖 Bundle.entry.resource 的资源 ID。在将源数据解析到 Bundle 对象时,会发生此行为。如果这不是所需行为,则将其设置为 false (例如,客户端代码希望在 fullUrl 和资源 ID 之间执行额外的验证检查)。 | false | 布尔值 |
| camel.dataformat.fhirxml.pretty-print | 设置用户友善的 print 标志,这意味着解析器将使用人类可读和元素之间的新行编码资源,而不是尽可能高的输出。 | false | 布尔值 |
| camel.dataformat.fhirxml.server-base-url | 设置此解析器使用的服务器基本 URL。如果设置了值,如果资源引用以绝对 URL 提供,但具有与给定基础匹配的基础,则资源引用将转换为相对引用。 | 字符串 | |
| camel.dataformat.fhirxml.strip-versions-from-references | 如果设置为 true (默认值),则包含版本的资源引用将在编码资源时删除版本。这通常很好,因为在大多数情况下,从一个资源到另一个资源的引用应该是按 ID 到资源,而不是按 ID 和版本对资源。然而,在某些情况下可能需要在资源链接中保留版本。在这种情况下,这个值应设为 false。这个方法提供了全局禁用参考编码的功能。如果需要精细控制,请使用 setDontStripVersionsFromReferencesAtPaths (List)。 | false | 布尔值 |
| camel.dataformat.fhirxml.summary-mode | 如果设置为 true (默认为 false),则仅包含 FHIR 规格标记为概述元素的元素。 | false | 布尔值 |
| camel.dataformat.fhirxml.suppress-narratives | 如果设置为 true (默认为 false),则 narratives 不会包含在编码的值中。 | false | 布尔值 |
第 24 章 File 复制链接链接已复制到粘贴板!
支持生成者和消费者
File 组件提供对文件系统的访问,允许由其他组件的任何其他 Camel 组件或来自其他组件的消息保存到磁盘中处理文件。
24.1. URI 格式 复制链接链接已复制到粘贴板!
file:directoryName[?options]
file:directoryName[?options]
其中 directoryName 代表底层文件目录。
只有目录
Camel 仅支持使用启动目录配置的端点。因此,directoryName 必须是目录。如果只使用单个文件,您可以使用 fileName 选项,例如通过设置 fileName=thefilename。另外,启动目录不得包含带有 ${ } 占位符的动态表达式。使用 fileName 选项指定文件名的动态部分。
避免读取当前由另一个应用程序写入的文件
成为JDK File IO API 在检测另一个应用程序当前是否写入/复制文件时有一定限制。此外,实施也可以因操作系统平台而异。这可能会导致 Camel 认为该文件不会被其他进程锁定,并开始消耗它。因此,您必须自己调查您的环境套件。为了帮助获得此 Camel,可以使用不同的 readLock 选项和 doneFileName 选项。另请参阅 从其他文件直接丢弃文件的文件夹恢复文件 一节。
24.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
24.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
24.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
24.3. 组件选项 复制链接链接已复制到粘贴板!
File 组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
24.4. 端点选项 复制链接链接已复制到粘贴板!
File 端点使用 URI 语法进行配置:
file:directoryName
file:directoryName
使用以下路径和查询参数:
24.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| directoryName (common) | 需要 启动目录。 | File |
24.4.2. 查询参数(94 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| charset (common) | 此选项用于指定文件编码。您可以在消费者上使用此功能,以指定文件的编码,它允许 Camel 在访问文件内容时加载文件内容。在编写文件时,您可以使用此选项指定写入该文件的 charset。请注意,当编写 Camel 文件时,可能需要将消息内容读取在内存中才能将数据转换为配置的 charset,因此如果您有大量消息,则不要使用它。 | 字符串 | |
| doneFileName (common) | producer :如果提供,则 Camel 将在编写原始文件时写入第二次完成的文件。done 文件为空。这个选项配置要使用的文件名。您可以指定固定名称。或者,您可以使用动态占位符。done 文件将始终写在与原始文件相同的文件夹中。consumer :如果提供,Camel 仅在文件存在时使用文件。这个选项配置要使用的文件名。您可以指定固定名称。或者,您可以使用动态占位符。done 文件始终预期在与原始文件相同的文件夹中。仅支持 $\\{file.name} 和 $\\{file.name.next} 作为动态占位符。 | 字符串 | |
| fileName (common) | 使用 Expression (如文件语言)来动态设置文件名。对于消费者,它用作文件名过滤器。对于生成者,它用于评估要写入的文件名。如果设置了表达式,它将优先于 CamelFileName 标头。(注意:标头本身也可以是 Expression)。表达式选项支持 String 和 Expression 类型。如果表达式是字符串类型,则始终使用 File Language 来评估。如果表达式是 Expression 类型,则会使用指定的 Expression 类型 - 例如,您可以使用 OGNL 表达式。对于消费者,您可以使用它来过滤文件名,因此您可以使用 File Language 语法:mydata-$\\{date:now:yyyyMMdd}.txt 来使用现在使用的文件。producers 支持 CamelOverruleFileName 标头,其优先于任何现有 CamelFileName 标头;CamelOverruleFileName 是一个仅一次的标头,并便于避免临时存储 CamelFileName 并在以后恢复它。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| delete (consumer) | 如果为 true,则会在成功处理文件后删除该文件。 | false | 布尔值 |
| moveFailed (consumer) | 根据简单语言设置移动失败表达式。例如,要将文件移到 .error 子目录使用:.error。注意:将文件移到失败位置 Camel 将处理错误时,不会再次获取该文件。 | 字符串 | |
| noop (consumer) | 如果为 true,则文件不会以任何方式移动或删除。这个选项适用于只读数据,或 ETL 类型要求。如果 noop=true,Camel 也设置幂等=true,以避免再次消耗相同的文件。 | false | 布尔值 |
| preMove (consumer) | 在处理前移动文件名的表达式(如文件语言)。例如,要将 in-progress 文件移到 order 目录中,将此值设置为 order。 | 字符串 | |
| preSort (consumer) | 启用预排序后,消费者将在轮询过程中对文件和目录名称进行排序,这从文件系统检索。如果您需要按照排序的顺序对文件进行操作,您可能需要执行此操作。预排序是在消费者开始过滤前执行的,并接受由 Camel 处理的文件。这个选项是 default=false 表示禁用。 | false | 布尔值 |
| recursion (consumer) | 如果某个目录,也会在所有子目录中查找文件。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| directoryMustExist (consumer (advanced)) | 与 startDirectoryMustExist 选项类似,但这在轮询过程中适用(在启动消费者后)。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| extendedAttributes (consumer (advanced)) | 定义感兴趣的文件属性。与 posix:permissions,posix:owner,basic:lastAccessTime 一样,它支持基本的通配符,如 posix:, basic:lastAccessTime。 | 字符串 | |
| inProgressRepository (consumer (advanced)) | 可插拔 in-progress 存储库 org.apache.camel.spi.IdempotentRepository。in-progress 存储库用于考虑当前正在使用的进程文件中。默认使用基于内存的存储库。 | IdempotentRepository | |
| localWorkDirectory (consumer (advanced)) | 消耗时,本地工作目录可用于直接将远程文件内容存储在本地文件中,以避免将内容加载到内存中。这很有用,如果您消耗非常大的远程文件,因此可以节省内存。 | 字符串 | |
| onCompletionExceptionHandler (consumer (advanced)) | 要使用自定义 org.apache.camel.spi.ExceptionHandler 来处理在消费者进行提交或回滚的完成过程中发生的任何抛出异常。默认实现将在 WARN 级别和忽略时记录任何异常。 | ExceptionHandler | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| probeContentType (consumer (advanced)) | 是否启用内容类型的探测。如果启用,则消费者使用 Files114probeContentType (java.nio.file.Path)来确定文件的 content-type,并将该类型存储为 Message 上带有密钥 ExchangeFILE_CONTENT_TYPE 的标头。 | false | 布尔值 |
| processStrategy (consumer (advanced)) | 一个可插拔的 org.apache.camel.component.file.GenericFileProcessStrategy,允许您实现自己的 readLock 选项或类似。在消耗文件之前,也可以使用特殊条件,如存在特殊的就绪文件。如果设置了这个选项,则不会应用 readLock 选项。 | GenericFileProcessStrategy | |
| resumeStrategy (consumer (advanced)) | 为文件设置恢复策略。这样便可定义一个策略,以便在最后一次点后恢复文件,然后再停止应用程序。有关实现详情,请参阅 FileConsumerResumeStrategy。 | FileConsumerResumeStrategy | |
| startingDirectoryMustExist (consumer (advanced)) | 起始目录必须存在。请记住,autoCreate 选项是默认启用的,这意味着如果启动目录不存在,则通常会自动创建。您可以禁用 autoCreate 并启用此功能以确保启动目录必须存在。如果目录不存在,将抛出异常。 | false | 布尔值 |
| startingDirectoryMustHaveAccess (consumer (advanced)) | 启动目录是否具有访问权限。请记住,startDirectoryMustExist 参数必须设置为 true,才能验证目录是否存在。如果目录没有读写权限,则抛出异常。 | false | 布尔值 |
| appendChars (producer) | 用于在写入文件后附加字符(文本)。例如,这可用于在编写和附加新文件或现有文件时添加新行或其他分隔符。要指定新行(slash-n 或 slash-r)或 tab (slash-t)字符,然后使用额外的斜杠 eg slash-slash-n 进行转义。 | 字符串 | |
| fileExist (producer) | 如果文件已存在具有相同名称的文件,则该怎么办。覆盖(这是默认设置)替换现有文件。- Append - 将内容添加到现有文件中。- Fail - 抛出一个 GenericFileOperationException,表示已有的文件。- Ignore - 静默忽略问题,且不会覆盖现有的文件,但假设所有内容正常。- Move - 选项需要使用 moveExisting 选项。选项 eagerDeleteTargetFile 可以用来控制移动文件时要执行的操作,并且已存在现有文件,否则会导致移动操作失败。Move 选项将在编写目标文件前移动任何现有文件。- 只有在使用 tempFileName 选项时才适用 TryRename。这允许尝试将文件从临时名称重命名为实际名称,而无需执行任何存在检查。对于某些文件系统,这个检查可能会更快,特别是 FTP 服务器。 Enum 值:
| 覆盖 | GenericFileExist |
| flatten (producer) | 扁平化用于扁平化任何前导路径的文件名路径,因此它只是文件名。这样,您可以递归地将文件写入子目录中,但当您将文件写入另一个目录中时,它们将写入到单个目录中。在制作者上将其设置为 true 可强制在 CamelFileName 标头中为任何前导路径去除任何文件名。 | false | 布尔值 |
| jailStartingDirectory (producer) | 仅用于 jailing (限制)将文件写入启动目录(和子)。默认情况下,这不允许 Camel 将文件写入外部目录(其开箱即用)。您可以将其关闭,以允许将文件写入启动目录之外的目录,如父目录或根文件夹。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| moveExisting (producer) | 配置 fileExist=Move 时使用的表达式(如文件语言)用于计算文件名。将文件移到备份子目录中,只需输入备份。这个选项只支持以下文件语言令牌: file:name、file:name.ext、file:name.noext、file:onlyname、file:onlyname.noext、file:ext 和 file:parent。请注意,FTP 组件不支持 file:parent,因为 FTP 组件只能将任何现有文件移至基于当前 dir 作为基础的相对目录中。 | 字符串 | |
| tempFileName (producer) | 与 tempPrefix 选项相同,但提供对临时文件名命名更加精细的控制,因为它使用 File 语言。tempFilename 的位置相对于选项 'fileName' 中的最终文件位置,而不是基础 uri 中的目标目录。例如,如果选项 fileName 包含一个目录前缀:dir/finalFilename,则 tempFileName 相对于该子目录 dir。 | 字符串 | |
| tempPrefix (producer) | 此选项用于使用临时名称写入文件,然后在写入完成后将其重命名为实际名称。可用于识别正在写入的文件,并避免消费者(不使用专用读锁定)读取进度文件中。FTP 通常在上传大型文件时使用。 | 字符串 | |
| allowNullBody (producer (advanced)) | 用于指定在文件写入过程中是否允许 null 正文。如果设置为 true,则会创建一个空文件,设置为 false,并尝试向文件组件发送 null 正文,将抛出 'Cannot write null body 的 GenericFileWriteException。'如果 fileExist 选项设为 'Override',则该文件将被截断,如果设为附加该文件,则该文件将保持不变。 | false | 布尔值 |
| chmod (producer (advanced)) | 指定制作者发送的文件权限,chmod 值必须在 000 和 777 之间;如果存在前导数字,如 0755,我们将忽略它。 | 字符串 | |
| chmodDirectory (producer (advanced)) | 指定制作者创建缺失目录时使用的目录权限,chmod 值必须在 000 和 777 之间;如果存在前导位,如 0755,我们将忽略它。 | 字符串 | |
| eagerDeleteTargetFile (producer (advanced)) | 是否强制删除任何现有目标文件。这个选项仅在使用 fileExists=Override 和 tempFileName 选项时才适用。您可以使用它来禁用(将其设置为 false)在写入临时文件前删除目标文件。例如,您可以编写大型文件,并希望在编写临时文件过程中存在目标文件。这样可确保目标文件仅在最后一次时间之前被删除,只需在临时文件重命名为目标文件名之前。此选项还用于控制在启用 fileExist=Move 时是否删除任何现有文件,并且存在现有的文件。如果此选项 copyAndDeleteOnRenameFails false,那么如果现有文件存在,则会抛出异常(如果为 true),则在移动操作前删除现有文件。 | true | 布尔值 |
| forceWrites (producer (advanced)) | 是否强制同步到文件系统。如果您不希望此级别的保证,您可以关闭此级别,例如,如果写入日志 / 审计日志等;这会产生更好的性能。 | true | 布尔值 |
| keepLastModified (producer (advanced)) | 将保留源文件的最后修改的时间戳(若有)。将使用 Exchange.FILE_LAST_MODIFIED 标头来定位时间戳。此标头可以包含 java.util.Date 或带有时间戳的长度。如果时间戳存在,并且启用了 选项,它将在写入的文件中设置此时间戳。注:此选项仅适用于文件制作者。您不能将此选项与任何 ftp producer 一起使用。 | false | 布尔值 |
| moveExistingFileStrategy (producer (advanced)) | 用于在配置 fileExist=Move 时使用特殊命名令牌的策略(自定义策略)。默认情况下,如果没有提供自定义策略,则使用实施。 | FileMoveExistingStrategy | |
| auto create (advanced) | 在文件的路径中自动创建缺少的目录。对于文件消费者,这意味着创建启动目录。对于文件制作者,这意味着应将文件写入的目录。 | true | 布尔值 |
| BufferSize ( advanced) | 用于编写文件的缓冲区大小(或者 FTP 用于下载和上传文件)。 | 131072 | int |
| copyAndDeleteOnRenameFail (advanced) | 是否在无法直接重命名文件时,回退以及执行复制和删除文件。FTP 组件无法使用这个选项。 | true | 布尔值 |
| renameUsingCopy (advanced) | 使用复制和删除策略执行重命名操作。这主要用于常规重命名操作不可靠(例如在不同文件系统或网络中)。这个选项优先于 copyAndDeleteOnRenameFail 参数,该参数将自动回退到复制和删除策略,但只有在额外的延迟后。 | false | 布尔值 |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| antExclude (filter) | ant 风格的过滤器排除。如果同时使用 antInclude 和 antExclude,则 antExclude 优先于 antInclude。可以使用以逗号分隔的格式指定多个排除项。 | 字符串 | |
| antFilterCaseSensitive (filter) | 在 ant 过滤器上设置区分大小写标志。 | true | 布尔值 |
| antInclude (filter) | ant 风格的过滤器包括。可使用以逗号分隔的格式指定多个 include。 | 字符串 | |
| eagerMaxMessagesPerPoll (filter) | 允许控制 maxMessagesPerPoll 的限制是 eager。如果 eager,则在扫描文件的过程中会进行限制。其中为 false 将扫描所有文件,然后执行排序。将这个选项设置为 false 允许首先排序所有文件,然后限制轮询。请注意,这需要更高的内存用量,因为所有文件详情都在内存中执行排序。 | true | 布尔值 |
| exclude (filter) | 用于排除文件(如果文件名与正则表达式模式匹配)(匹配不区分大小写)。请注意,如果您使用加号等符号,如果将其配置为端点 uri,则需要使用 RAW ()语法进行配置。有关配置端点 uri 的更多信息,请参阅。 | 字符串 | |
| excludeExt (filter) | 用于排除与文件扩展名名称匹配的文件(不区分大小写)。例如,要排除 bak 文件,则使用 excludeExt=bak。可以使用逗号分隔多个扩展,例如排除 bak 和 dat 文件,使用 excludeExt=bak,dat。请注意,文件扩展名包含所有部分,例如,有一个名为 mydata.tar.gz 的文件将扩展为 tar.gz。要获得更大的灵活性,请使用 include/exclude 选项。 | 字符串 | |
| filter (filter) | 可插拔过滤器作为 org.apache.camel.component.file.GenericFileFilter 类。如果过滤器在 accept ()方法中返回 false,则会跳过文件。 | GenericFileFilter | |
| filterDirectory (filter) | 根据简单语言过滤目录。例如,要过滤当前日期,您可以使用简单的日期模式,如 $\\{date:now:yyyMMdd}。 | 字符串 | |
| filterFile (filter) | 根据简单语言过滤文件。例如,要过滤文件大小,您可以使用 $\\{file:size} 5000。 | 字符串 | |
| 幂等 (过滤) | 使用 Idempotent Consumer EIP 模式的选项,以便 Camel 跳过已经处理的文件。默认情况下,将使用基于内存的 LRUCache,其中包含 1000 个条目。如果 noop=true 也会启用,以避免再次消耗相同的文件。 | false | 布尔值 |
| idempotentKey (filter) | 使用自定义幂等键,请执行以下操作:默认情况下,使用该文件的绝对路径。您可以使用 File Language,例如使用文件名和文件大小,您可以执行以下操作:OnlydKey=$\\{file:name}-$\\{file:size}。 | 字符串 | |
| idempotentRepository (filter) | 可插拔存储库 org.apache.camel.spi.IdempotentRepository,它默认使用 MemoryIdempotentRepository (如果没有指定),且幂等性为 true。 | IdempotentRepository | |
| include (filter) | 用于包含文件,如果文件名与正则表达式模式匹配(匹配不区分大小写)。请注意,如果您使用加号等符号,如果将其配置为端点 uri,则需要使用 RAW ()语法进行配置。有关配置端点 uri 的更多信息,请参阅。 | 字符串 | |
| includeExt (filter) | 用于包括匹配文件扩展名名称的文件(不区分大小写)。例如,要包含 txt 文件,则使用 includeExt=txt。可以使用逗号分隔多个扩展,例如包含 txt 和 xml 文件,请使用 includeExt=txt,xml。请注意,文件扩展名包含所有部分,例如,有一个名为 mydata.tar.gz 的文件将扩展为 tar.gz。要获得更大的灵活性,请使用 include/exclude 选项。 | 字符串 | |
| maxDepth (filter) | 递归处理目录时要遍历的最大深度。 | 2147483647 | int |
| maxMessagesPerPoll (filter) | 定义每次轮询收集的最大消息。默认情况下不设置最大值。可用于设置限制,例如 1000,以避免在启动有数千个文件的服务器时避免。将值设为 0 或负数设置为禁用它。注意:如果使用这个选项,则文件和 FTP 组件将在任何排序前受到限制。例如,如果您有 100000 文件并使用 maxMessagesPerPoll=500,则仅获取前 500 个文件,然后排序。您可以使用 eagerMaxMessagesPerPoll 选项,并将其设置为 false 以允许首先扫描所有文件,然后对文件进行排序。 | int | |
| minDepth (filter) | 递归处理目录时开始处理的最小深度。使用 minDepth=1 表示主目录。使用 minDepth=2 表示第一个子目录。 | int | |
| Move (filter) | 在处理后移动文件名的表达式(如简单语言)。将文件移到 .done 子目录中,只需输入 .done。 | 字符串 | |
| exclusiveReadLockStrategy (lock) | 可插拔读锁定作为 org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy 实现。 | GenericFileExclusiveReadLockStrategy | |
| readLock (lock) | 消费者使用,仅在文件有独占的 read-lock 时轮询文件(例如,该文件不是 in-progress 或 in-progress 或正在写入)。Camel 将等到赋予文件锁定。此选项在策略中提供构建: - none - No read lock is use - markFile - Camel 创建标记文件(fileName.camelLock),然后在其上保存锁定。FTP 组件无法使用这个选项 - Changed - Changed 使用文件长度/修改时间戳来检测文件当前是否复制。至少将使用 1 sec 来确定这一点,因此此选项无法像其他进程一样快速使用文件,但可能会更可靠,因为 JDK IO API 并不总是确定当前由其他进程使用的文件。选项 readLockCheckInterval 可用于设置检查频率。- fileLock - 使用 java.nio.channels.FileLock。这个选项不适用于 Windows OS 和 FTP 组件。在通过 mount/share 访问远程文件系统时,应该避免这种方法,除非该文件系统支持分布式文件锁定。- 重命名是使用尝试将文件重命名为测试(如果我们可以获得专用 read-lock. - 幂等的 - (仅用于文件组件)用于使用幂等结构作为读锁定。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定。- idempotent-changed - (仅限文件组件)幂等性更改是使用幂等的Repository,并作为组合的 read-lock 进行更改。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定。- idempotent-rename - (仅用于文件组件)幂等名称使用幂等权限,并重命名为组合的 read-lock。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定:各种读锁定并不是在集群模式下工作的,其中不同节点上的并发消费者对共享文件系统中的同一文件都是竞争的。使用一个接近原子操作的 markFile 来创建空标记文件,但无法保证在集群中工作。fileLock 可能更好,但文件系统需要支持分布式文件锁定等。如果幂等存储库支持集群,如 Hazelcast 组件或 Infinispan,则使用幂等读锁定支持集群。 Enum 值:
| none | 字符串 |
| readLockCheckInterval (lock) | read-lock 的 millis (如果读锁定支持)。这个间隔用于在尝试获取读锁定之间休眠。例如,在使用更改的读锁定时,您可以为较慢的写入设置更高的间隔周期。如果生成者非常慢,则默认值 1 sec. 可能太快。注意:对于 FTP,默认的 readLockCheckInterval 为 5000。readLockTimeout 值必须大于 readLockCheckInterval,但 thumb 的规则是具有至少 2 个或大于 readLockCheckInterval 的超时。这需要确保读锁定进程允许冻结时间,以便在超时命中前尝试获取锁定。 | 1000 | long |
| readLockDeleteOrphanLockFiles (lock) | 如果 Camel 没有正确关闭,则是否应在启动时读取带有标记文件(比如 JVM 崩溃)删除任何孤立的读锁定文件(如果 Camel 没有被正确关闭)。如果将此选项设置为 false,则任何孤立的锁定文件将导致 Camel 不尝试获取该文件,这可能是因为另一个节点同时从同一共享目录读取文件。 | true | 布尔值 |
| readLockIdempotentReleaseAsync (lock) | 延迟发行任务是否应同步还是异步。请参阅 readLockIdempotentReleaseDelay 选项的详情。 | false | 布尔值 |
| readLockIdempotentReleaseAsyncPoolSize (lock) | 使用异步发行任务时调度的线程池中的线程数量。在几乎所有用例中,使用默认的 1 个内核线程应该足够了,只有在更新幂等存储库缓慢或者有大量文件可以处理时,才会将其设置为更高的值。如果您通过配置 readLockIdempotentReleaseExecutorService 选项使用共享线程池,则此选项不会被使用。请参阅 readLockIdempotentReleaseDelay 选项的详情。 | int | |
| readLockIdempotentReleaseDelay (lock) | 是否在 millis 期间延迟发行任务。当文件被视为读锁定时,这可用于延迟发行任务来扩展窗口,在使用共享幂等存储库的主动/主动集群场景中,以确保其他节点无法扫描并获取同一文件,因为竞争条件。通过延长发行任务的时间时间有助于防止这些情况。请注意,只有在将 readLockRemoveOnCommit 配置为 true 时,才需要延迟。 | int | |
| readLockIdempotentReleaseExecutorService (lock) | 使用自定义和共享线程池进行异步发行任务。请参阅 readLockIdempotentReleaseDelay 选项的详情。 | ScheduledExecutorService | |
| readLockLoggingLevel (lock) | 无法获取读取锁定时使用的日志记录级别。默认情况下,会记录 DEBUG。您可以更改此级别,例如 OFF 没有任何日志记录。这个选项仅适用于 readLock 类型: changed, fileLock, idempotent, idempotent-changed, idempotent-rename, rename。 Enum 值:
| DEBUG | LoggingLevel |
| readLockMarkerFile (lock) | 是否将标记文件与更改、重命名或专用读取锁定类型一起使用。默认情况下,使用标记文件来保护其他进程获取同一文件。通过将这个选项设置为 false,可以关闭此行为。例如,如果您不想由 Camel 应用程序将标记文件写入文件系统。 | true | 布尔值 |
| readLockMinAge (lock) | 这个选项仅适用于 readLock=changed。它允许在尝试获取读取锁定前指定该文件的最短期限。例如,使用 readLockMinAge=300s 来要求文件持续 5 分钟。这可加快更改的读锁定速度,因为它将尝试获取至少给定时间的文件。 | 0 | long |
| readLockMinLength (lock) | 这个选项仅适用于 readLock=changed。它允许您配置最小文件长度。默认情况下,Camel 期望文件包含数据,因此默认值为 1。您可以将这个选项设置为零,以允许消耗零长度文件。 | 1 | long |
| readLockRemoveOnCommit (lock) | 这个选项仅适用于 readLock=idempotent。它允许在处理文件成功并发生提交时指定是否从幂等存储库中删除文件名条目。默认情况下,该文件不会被删除,这样可确保不会发生任何竞争条件,因此另一个活跃节点可能会尝试获取该文件。相反,幂等存储库可以支持驱除策略,您可以在 X 分钟后驱除文件名条目 - 这样可确保出现竞争条件的问题。请参阅 readLockIdempotentReleaseDelay 选项的详情。 | false | 布尔值 |
| readLockRemoveOnRollback (lock) | 这个选项仅适用于 readLock=idempotent。它允许在处理文件失败时指定是否从幂等存储库中删除文件名条目,并且进行回滚。如果此选项为 false,则确认文件名条目(就像文件进行了提交一样)。 | true | 布尔值 |
| readLockTimeout (lock) | 可选的 timeout (如果 read-lock 支持)用于读锁定。如果无法授予 read-lock 并触发超时,则 Camel 将跳过该文件。下一次轮询 Camel 时,将再次尝试 文件,这一次可能会授予读锁定。使用 0 或较低值来指示永久值。当前 fileLock、change 和 rename 支持超时。注意:对于 FTP,默认的 readLockTimeout 值为 20000,而不是 10000。readLockTimeout 值必须大于 readLockCheckInterval,但 thumb 的规则是具有至少 2 个或大于 readLockCheckInterval 的超时。这需要确保读锁定进程允许冻结时间,以便在超时命中前尝试获取锁定。 | 10000 | long |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| shuffle (sort) | 影响文件列表(按随机顺序排列)。 | false | 布尔值 |
| sortBy (sort) | 使用文件语言内置排序。支持嵌套排序,以便您可以按文件名排序,并作为按修改日期排序的第二个组。 | 字符串 | |
| 排序 者(排序) | 可插拔排序器作为 java.util.Comparator 类。 | 比较器 |
文件生成者的默认行为
默认情况下,它会覆盖任何已存在的、带有相同名称的文件。
24.5. 移动和删除操作 复制链接链接已复制到粘贴板!
任何移动或删除操作都会在(post 命令)完成后执行;因此在处理 交换 过程中,该文件仍然位于 inbox 文件夹中。
通过一个示例来演示这一点:
from("file://inbox?move=.done").to("bean:handleOrder");
from("file://inbox?move=.done").to("bean:handleOrder");
当文件在 inbox 文件夹中丢弃时,文件消费者会注意到这一点,并创建一个新的 FileExchange,它路由到 handleOrder bean。然后 bean 处理 File 对象。此时,该文件仍然位于 inbox 文件夹中。在 bean 完成后,路由完成后,文件消费者将执行 move 操作,并将文件移到 .done 子文件夹。
move 和 preMove 选项被视为目录名称(但是,如果您使用一个表达式(如 文件 语言)或 Simple,则表达式评估的结果是要使用的文件名。例如,如果设置了:
move=../backup/copy-of-${file:name}
move=../backup/copy-of-${file:name}
然后,使用的文件语言返回要使用的文件名,可以是相对或绝对的。https://access.redhat.com/documentation/zh-cn/red_hat_integration/2023.q2/html-single/camel_spring_boot_reference/index#csb-camel-file-language-starter如果相对,则该目录创建为使用该文件的文件夹的子文件夹。
默认情况下,Camel 会将消耗的文件移到相对于文件消耗的目录的 .camel 子文件夹。
如果要在处理后删除该文件,路由应该是:
from("file://inbox?delete=true").to("bean:handleOrder");
from("file://inbox?delete=true").to("bean:handleOrder");
在处理文件 前,我们引入了一个 预 移动操作来移动文件。这可让您在处理前标记哪些文件被扫描,因为这些文件将移到这个子文件夹中。
from("file://inbox?preMove=inprogress").to("bean:handleOrder");
from("file://inbox?preMove=inprogress").to("bean:handleOrder");
您可以组合 预 移动和常规移动:
from("file://inbox?preMove=inprogress&move=.done").to("bean:handleOrder");
from("file://inbox?preMove=inprogress&move=.done").to("bean:handleOrder");
因此,在这种情况下,文件在处理时位于 inprogress 文件夹中,并在处理后移至 .done 文件夹。
24.6. 对 Move 和 PreMove 选项进行精细控制 复制链接链接已复制到粘贴板!
move 和 preMove 选项基于表达式,因此我们拥有 文件 语言的完整功能,以执行目录和名称模式的高级配置。
实际上,Camel 会在内部将您输入的目录名称转换为 文件 语言表达式。因此,当我们输入 move=.done Camel 时,会将其转换为 :${file:parent}/.done/${file:onlyname}。这只有在 Camel 检测到您没有自行在选项值中提供 $\{ } 时才完成。因此,当您输入 $\{ } Camel 时,不会 转换它,因此您有完整的电源。
因此,如果我们想将文件移到备份文件夹中,且现在作为模式,我们可以:
move=backup/${date:now:yyyyMMdd}/${file:name}
move=backup/${date:now:yyyyMMdd}/${file:name}
24.7. 关于 moveFailed 复制链接链接已复制到粘贴板!
moveFailed 选项允许您将无法成功处理的文件移到其他位置,如您选择的错误文件夹。例如,要移动带有时间戳的错误文件夹中的文件,您可以使用 moveFailed=/error/${}。
file:name.noext}-${date:now:yyyyMMddHHmmssSSS}.${\'\'file:ext
请参阅更多示例
24.8. 消息标头 复制链接链接已复制到粘贴板!
此组件支持以下标头:
24.8.1. 仅限文件制作者 复制链接链接已复制到粘贴板!
| 标头 | 描述 |
|---|---|
|
|
指定要写入的文件的名称(相对于端点目录)。此名称可以是 |
|
| 所写入的输出文件的实际绝对文件路径(路径 + 名称)。此标头由 Camel 设置,其用途是为最终用户提供所写入文件的名称。 |
|
|
用于过度检测 |
24.8.2. 仅限文件消费者 复制链接链接已复制到粘贴板!
| 标头 | 描述 |
|---|---|
|
| 使用的文件名称作为相对文件路径,从端点上配置的起始目录中偏移。 |
|
| 仅包括文件名(没有前导路径的名称)。 |
|
|
指定消耗的文件是否表示绝对路径 |
|
| 文件的绝对路径。对于相对文件,这个路径保存相对路径。 |
|
| 文件路径。对于相对文件,这是起始目录 + 相对文件名。对于绝对文件,这是绝对路径。 |
|
| 相对路径。 |
|
| 父路径。 |
|
|
包含文件大小 |
|
|
包含文件最后一次修改时间戳的 |
24.9. Batch Consumer 复制链接链接已复制到粘贴板!
这个组件实现了 Batch Consumer。
24.10. 交换属性,仅限文件消费者 复制链接链接已复制到粘贴板!
由于文件消费者实施 BatchConsumer,它支持批处理它轮询的文件。通过批处理,我们意味着 Camel 将在交换中添加以下额外属性,因此您知道轮询的文件数量、当前索引以及批处理是否已完成。
| 属性 | 描述 |
|---|---|
|
| 在此批处理中轮询的文件总数。 |
|
| 批处理的当前索引。从 0 开始。 |
|
|
指示批处理中最后一个交换的 |
这可让您让实例知道此批处理中存在多少个文件,例如,让聚合器2 聚合此数量的文件。
24.11. 使用 charset 复制链接链接已复制到粘贴板!
charset 选项允许在消费者和制作者端点上配置文件编码。例如,如果您读取 utf-8 文件,并希望将文件转换为 iso-8859-1,您可以执行以下操作:
from("file:inbox?charset=utf-8")
.to("file:outbox?charset=iso-8859-1")
from("file:inbox?charset=utf-8")
.to("file:outbox?charset=iso-8859-1")
您还可以在路由中使用 convertBodyTo。在以下示例中,我们仍然以 utf-8 格式输入文件,但我们希望将文件内容转换为 iso-8859-1 格式的字节数组。然后,让 bean 处理数据。在使用当前 charset 将内容写入 outbox 文件夹之前。
from("file:inbox?charset=utf-8")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.to("file:outbox");
from("file:inbox?charset=utf-8")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.to("file:outbox");
如果您省略了消费者端点上的 charset,则 Camel 不知道文件的 charset,默认情况下会使用 "UTF-8"。但是,您可以配置 JVM 系统属性来覆盖和使用带有 org.apache.camel.default.charset 键的不同默认编码。
在以下示例中,如果文件不在 UTF-8 编码中,这可能是一个问题,这是读取文件的默认编码。
在这个示例中,在编写文件时,内容已转换为字节数组,因此会将内容直接写入(无需进一步的编码)。
from("file:inbox")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.to("file:outbox");
from("file:inbox")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.to("file:outbox");
您还可以通过使用密钥 Exchange.CHARSET_NAME 在交换上设置属性来覆盖和控制编码动态。例如,在下面的路由中,我们使用消息标头中的值设置属性。
from("file:inbox")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.setProperty(Exchange.CHARSET_NAME, header("someCharsetHeader"))
.to("file:outbox");
from("file:inbox")
.convertBodyTo(byte[].class, "iso-8859-1")
.to("bean:myBean")
.setProperty(Exchange.CHARSET_NAME, header("someCharsetHeader"))
.to("file:outbox");
我们建议保持简单操作,因此如果您选择具有相同编码的文件,并希望以特定编码写入文件,那么最好在端点上使用 charset 选项。
请注意,如果您在端点上明确配置了 charset 选项,则无论 Exchange.CHARSET_NAME 属性是什么,都会使用该配置。
如果您有一些问题,您可以在 org.apache.camel.component.file 上启用 DEBUG 日志记录,并在其使用特定的 charset 读取/写入文件时 Camel 日志。
例如,以下示例将记录以下内容:
from("file:inbox?charset=utf-8")
.to("file:outbox?charset=iso-8859-1")
from("file:inbox?charset=utf-8")
.to("file:outbox?charset=iso-8859-1")
和日志:
DEBUG GenericFileConverter - Read file /Users/davsclaus/workspace/camel/camel-core/target/charset/input/input.txt with charset utf-8 DEBUG FileOperations - Using Reader to write file: target/charset/output.txt with charset: iso-8859-1
DEBUG GenericFileConverter - Read file /Users/davsclaus/workspace/camel/camel-core/target/charset/input/input.txt with charset utf-8
DEBUG FileOperations - Using Reader to write file: target/charset/output.txt with charset: iso-8859-1
24.12. 常用带有文件夹和文件名的 getchas 复制链接链接已复制到粘贴板!
当 Camel 生成文件时(写入文件)有一些影响如何设置您选择的文件名。默认情况下,Camel 将使用消息 ID 作为文件名,因为消息 ID 通常是唯一的 ID,因此您将以文件名结尾,例如: ID-MACHINENAME-2443-1211718892437-1-0。如果不需要这样的文件名,则必须在 CamelFileName 消息标头中提供一个文件名。也可以使用 constant ( Exchange.FILE_NAME )。
以下示例代码使用消息 ID 作为文件名生成文件:
from("direct:report").to("file:target/reports");
from("direct:report").to("file:target/reports");
要使用 report.txt 作为您必须做的文件名:
from("direct:report").setHeader(Exchange.FILE_NAME, constant("report.txt")).to( "file:target/reports");
from("direct:report").setHeader(Exchange.FILE_NAME, constant("report.txt")).to( "file:target/reports");
-
与上述相同,但使用
CamelFileName:
from("direct:report").setHeader("CamelFileName", constant("report.txt")).to( "file:target/reports");
from("direct:report").setHeader("CamelFileName", constant("report.txt")).to( "file:target/reports");
和语法,我们使用 fileName URI 选项在端点上设置文件名。
from("direct:report").to("file:target/reports/?fileName=report.txt");
from("direct:report").to("file:target/reports/?fileName=report.txt");
24.13. 文件名表达式 复制链接链接已复制到粘贴板!
文件名可以使用 expression 选项或作为 Camel File Name 标头中的基于文件的文件语言表达式进行设置。有关语法和示例,请参阅 文件 语言。
24.14. 从其他文件直接丢弃的文件夹中消耗文件 复制链接链接已复制到粘贴板!
如果您使用其他应用程序将文件直接写入的文件夹中的文件,则 beware。查看不同的 readLock 选项以查看您的用例。最好方法是写入另一个文件夹,并在写入移动 drop 文件夹中的文件后写入。但是,如果您直接将文件写入 drop 文件夹,则选项更改可能会更好地检测文件当前是否被写入/记录,因为它使用文件更改的算法来查看文件大小/修改更改。其他 readLock 选项依赖于 Java 文件 API,这些文件在检测时并不好。您可能还希望查看 doneFileName 选项,该选项在文件完成后使用标志文件(解压文件)来信号,并可供使用。
24.15. 使用 done 文件 复制链接链接已复制到粘贴板!
另请参阅下面 编写 done 文件 的部分。
如果您只想在文件存在时消耗文件,您可以在端点上使用 doneFileName 选项。
from("file:bar?doneFileName=done");
from("file:bar?doneFileName=done");
如果在目标文件的同一个目录中存在一个 done 文件,将仅使用 bar 文件夹中的文件。在完成使用文件或,Camel 将自动删除 done 文件。如果配置了 noop=true,Camel 不会删除 done 文件。
但是,每个目标文件有一个 完整的文件 更为常见。这意味着有一个 1:1 个关联。要做到这一点,您必须在 doneFileName 选项中使用动态占位符。目前,Camel 支持以下动态令牌: file:name 和 file:name.noext,这些令牌必须用 $\{ } 括起来。消费者只支持以前缀或后缀(不支持两者) 完成的文件名 的静态部分。
from("file:bar?doneFileName=${file:name}.done");
from("file:bar?doneFileName=${file:name}.done");
在本例中,只有在存在名为 .done 的文件时,仅轮询 文件。例如:
-
hello.txt- 是要使用的文件 -
hello.txt.done- 是关联的 done 文件
您还可以将前缀用于 done 文件,例如:
from("file:bar?doneFileName=ready-${file:name}");
from("file:bar?doneFileName=ready-${file:name}");
-
hello.txt- 是要使用的文件 -
ready-hello.txt- 是关联的 done 文件
24.16. 编写完成的文件 复制链接链接已复制到粘贴板!
编写一个文件后,您可能希望将额外的 done文件 写为一种标记,以指示该文件已完成并已写入的其他人。为此,您可以在文件制作者端点上使用 doneFileName 选项。
.to("file:bar?doneFileName=done");
.to("file:bar?doneFileName=done");
将简单地在与目标文件相同的目录中创建名为 done 的文件。
但是,每个目标文件有一个完整的文件更为常见。这意味着有一个 1:1 个关联。要做到这一点,您必须在 doneFileName 选项中使用动态占位符。目前,Camel 支持以下动态令牌: file:name 和 file:name.noext,这些令牌必须用 $\{ } 括起来。
.to("file:bar?doneFileName=done-${file:name}");
.to("file:bar?doneFileName=done-${file:name}");
如果目标文件是在与目标文件所在的相同目录中的 foo.txt 文件,则会创建一个名为 done-foo.txt 的文件。
.to("file:bar?doneFileName=${file:name}.done");
.to("file:bar?doneFileName=${file:name}.done");
如果目标文件是在与目标文件所在的相同目录中的 foo.txt 文件,则会创建一个名为 foo.txt.done 的文件。
.to("file:bar?doneFileName=${file:name.noext}.done");
.to("file:bar?doneFileName=${file:name.noext}.done");
如果目标文件是在与目标文件所在的相同目录中的 foo.txt 文件,则会创建一个名为 foo.done 的文件。
24.17. Samples 复制链接链接已复制到粘贴板!
24.17.1. 从目录读取和写入到另一个目录 复制链接链接已复制到粘贴板!
from("file://inputdir/?delete=true").to("file://outputdir")
from("file://inputdir/?delete=true").to("file://outputdir")
24.17.2. 从目录读取并使用 overrule 动态名称写入另一个目录 复制链接链接已复制到粘贴板!
from("file://inputdir/?delete=true").to("file://outputdir?overruleFile=copy-of-${file:name}")
from("file://inputdir/?delete=true").to("file://outputdir?overruleFile=copy-of-${file:name}")
侦听目录,并为在那里丢弃的每个文件创建一个消息。将内容复制到 outputdir,并删除 inputdir 中的文件。
24.17.3. 从目录中递归读取并写入另一个目录 复制链接链接已复制到粘贴板!
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")
侦听目录,并为在那里丢弃的每个文件创建一个消息。将内容复制到 outputdir,并删除 inputdir 中的文件。将递归扫描到子目录中。将把文件放在与 input 的目录结构中,包括任何子目录。
dir 相同
inputdir/foo.txt inputdir/sub/bar.txt
inputdir/foo.txt
inputdir/sub/bar.txt
将导致以下输出布局:
outputdir/foo.txt outputdir/sub/bar.txt
outputdir/foo.txt
outputdir/sub/bar.txt
24.18. 使用扁平化 复制链接链接已复制到粘贴板!
如果要将文件存储在同一目录中的 outputdir 目录中,请忽略源目录布局(例如扁平化路径),只需在文件制作者侧添加 flatten=true 选项:
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir?flatten=true")
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir?flatten=true")
将导致以下输出布局:
outputdir/foo.txt outputdir/bar.txt
outputdir/foo.txt
outputdir/bar.txt
24.19. 从目录和默认移动操作读取 复制链接链接已复制到粘贴板!
默认情况下,Camel 将任何处理的文件移到文件使用的目录中的 .camel 子目录中。
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")
from("file://inputdir/?recursive=true&delete=true").to("file://outputdir")
按如下所示影响布局:
前
inputdir/foo.txt inputdir/sub/bar.txt
inputdir/foo.txt
inputdir/sub/bar.txt
after
inputdir/.camel/foo.txt inputdir/sub/.camel/bar.txt outputdir/foo.txt outputdir/sub/bar.txt
inputdir/.camel/foo.txt
inputdir/sub/.camel/bar.txt
outputdir/foo.txt
outputdir/sub/bar.txt
24.20. 从目录读取并处理 java 中的消息 复制链接链接已复制到粘贴板!
正文将是一个 File 对象,它指向刚刚放入到 inputdir 目录中的文件。
24.21. 写入文件 复制链接链接已复制到粘贴板!
Camel 也能够编写文件,即生成文件。在以下示例中,我们将在将进程写入目录前收到有关 SEDA 队列的一些报告。
24.21.1. 使用 Exchange.FILE_NAME写入子目录 复制链接链接已复制到粘贴板!
通过使用单个路由,可以将文件写入任意数量的子目录。如果您有路由设置,如下所示:
<route> <from uri="bean:myBean"/> <to uri="file:/rootDirectory"/> </route>
<route>
<from uri="bean:myBean"/>
<to uri="file:/rootDirectory"/>
</route>
您可以将 header Exchange.FILE_NAME 设置为值,例如:
Exchange.FILE_NAME = hello.txt => /rootDirectory/hello.txt Exchange.FILE_NAME = foo/bye.txt => /rootDirectory/foo/bye.txt
Exchange.FILE_NAME = hello.txt => /rootDirectory/hello.txt
Exchange.FILE_NAME = foo/bye.txt => /rootDirectory/foo/bye.txt
这可让您有一个路由来将文件写入多个目的地。
24.21.2. 通过相对于最终目的地的临时目录写入文件 复制链接链接已复制到粘贴板!
有时您需要临时将文件写入相对于目标目录的一些目录。当某些具有有限过滤功能的外部进程是从您要写入的目录中读取时,通常会发生这种情况。在以下示例中,文件将写入 /var/myapp/filesInProgress 目录,并在进行数据传输后,将以原子方式移到' /var/myapp/finalDirectory 'directory。
from("direct:start").
to("file:///var/myapp/finalDirectory?tempPrefix=/../filesInProgress/");
from("direct:start").
to("file:///var/myapp/finalDirectory?tempPrefix=/../filesInProgress/");
24.22. 将表达式用于文件名 复制链接链接已复制到粘贴板!
在这个示例中,我们希望将消耗的文件移到备份文件夹中,使用当前的日期作为子文件夹名称:
from("file://inbox?move=backup/${date:now:yyyyMMdd}/${file:name}").to("...");
from("file://inbox?move=backup/${date:now:yyyyMMdd}/${file:name}").to("...");
如需了解更多示例,请参阅 文件语言。
24.23. 避免多次读取同一文件(隐藏消费者) 复制链接链接已复制到粘贴板!
Camel 直接在组件内支持 Idempotent Consumer,以便跳过已经处理的文件。可以通过设置 idempotent=true 选项来启用此功能。
from("file://inbox?idempotent=true").to("...");
from("file://inbox?idempotent=true").to("...");
Camel 使用绝对文件名作为幂等键,以检测重复的文件。您可以使用 idempotentKey 选项中的表达式来自定义此密钥。例如,将名称和文件大小用作键
<route>
<from uri="file://inbox?idempotent=true&idempotentKey=${file:name}-${file:size}"/>
<to uri="bean:processInbox"/>
</route>
<route>
<from uri="file://inbox?idempotent=true&idempotentKey=${file:name}-${file:size}"/>
<to uri="bean:processInbox"/>
</route>
默认情况下,Camel 使用基于内存的存储来跟踪消耗的文件,它使用最近保留 1000 个条目的缓存。您可以使用值中的 explicit Repository 选项来插件您自己的存储实现,以指示它在 Registry 中引用具有指定 id 的 Registry 中的 bean。
如果 Camel 跳过文件,则 Camel 将在 DEBUG 级别记录,因为它之前已被消耗:
DEBUG FileConsumer is idempotent and the file has been consumed before. Will skip this file: target\idempotent\report.txt
DEBUG FileConsumer is idempotent and the file has been consumed before. Will skip this file: target\idempotent\report.txt
24.24. 使用基于文件的幂等存储库 复制链接链接已复制到粘贴板!
在本节中,我们将使用基于文件的幂等存储库 org.apache.camel.processor.idempotent.FileIdempotentRepository,而不是默认基于内存的内存中。
此仓库使用第一级缓存以避免读取文件存储库。它将仅使用文件存储库来存储第一级别缓存的内容。因此,存储库可以在服务器重启后保留。它将在启动时将文件的内容加载到第一级缓存中。文件结构非常简单,因为它将密钥存储在文件中的单独行中。默认情况下,文件存储的大小限制为 1mb。当文件增长较大的 Camel 会截断文件存储时,通过将 1st 级别缓存刷新到一个新的空文件来重建内容。
我们使用 Spring XML 创建我们的存储库来创建我们的文件幂等存储库,并定义我们的文件消费者使用我们的存储库与 幂等 权限一起使用,以表示 Registry 查找:
24.25. 使用基于 JPA 的幂等存储库 复制链接链接已复制到粘贴板!
在本节中,我们将使用基于 JPA 的幂等存储库,而不是默认使用的内存中。
首先,我们需要在 META-INF/persistence.xml 中有一个 persistence-unit,其中需要使用类 org.apache.camel.processor.idempotent.jpa.MessageProcessed 作为模型。
接下来,也可以在 spring XML 文件中创建 JPA 幂等存储库:
然后,这是的,只需要使用 sVirt 语法选项引用文件消费者端点中的 jpaStore bean:
<route> <from uri="file://inbox?idempotent=true&idempotentRepository=#jpaStore"/> <to uri="bean:processInbox"/> </route>
<route>
<from uri="file://inbox?idempotent=true&idempotentRepository=#jpaStore"/>
<to uri="bean:processInbox"/>
</route>
Camel 支持可插拔过滤策略。然后,您可以使用此类过滤器配置端点,以跳过被处理的某些文件。
在示例中,我们构建了自己的过滤器,它会跳过其文件名是以 skip 开始的文件:
然后,我们可以使用 filter 属性配置路由,以引用我们在 spring XML 文件中定义的过滤器(使用 spring 表示法):
24.27. 使用 ANT 路径匹配程序进行过滤 复制链接链接已复制到粘贴板!
ANT 路径匹配程序基于 AntPathMatcher。
文件路径与以下规则匹配:
-
?匹配一个字符 -
DNAT匹配零个或多个字符 -
Tailoring匹配路径中的零个或多个目录
antInclude 和 antExclude 选项可以轻松地指定 ANT 风格的 include/exclude,而无需定义过滤器。如需更多信息,请参阅上面的 URI 选项。
以下示例演示了如何使用它:
24.27.1. 使用 Comparator 进行排序 复制链接链接已复制到粘贴板!
Camel 支持可插拔排序策略。此策略在 Java 中的 java.util.Comparator 中使用构建。然后,您可以使用这样的比较器配置端点,并在处理前对文件进行排序。
在示例中,我们构建了自己的比较器,只需按照文件名排序:
然后,我们可以使用 sorter 选项配置路由,以引用我们在 spring XML 文件中定义的排序器(mySorter):
URI 选项可以使用 # 语法来引用 bean
在 Spring DSL 路由中,可以通过在 id 前使用 # 前缀来引用 Registry 中的 beans。因此,编写 sorter=114mySorter 将指示 Camel 在 Registry 中查找 ID 为 mySorter 的 bean。
24.27.2. 使用 sortBy 排序 复制链接链接已复制到粘贴板!
Camel 支持可插拔排序策略。此策略使用 文件 语言来配置排序。sortBy 选项配置如下:
sortBy=group 1;group 2;group 3;...
sortBy=group 1;group 2;group 3;...
其中,每个组都用分号分开。在简单的情形中,您只使用一个组,因此一个简单的示例可以是:
sortBy=file:name
sortBy=file:name
这将根据文件名排序,您可以通过前缀 reverseing reverse: 到组来撤销顺序,因此排序现在是 Z..A :
sortBy=reverse:file:name
sortBy=reverse:file:name
因为我们拥有完整的 文件 语言功能,我们可以使用一些额外的参数,因此如果我们希望根据文件大小排序:
sortBy=file:length
sortBy=file:length
您可以将配置为忽略问题单,使用 ignoreCase: 进行字符串比较,因此如果您想要使用文件排序但忽略这种情况,则我们这样做:
sortBy=ignoreCase:file:name
sortBy=ignoreCase:file:name
您可以组合忽略问题单和反向,但必须首先指定反向:
sortBy=reverse:ignoreCase:file:name
sortBy=reverse:ignoreCase:file:name
在以下示例中,我们希望按上次修改的文件排序,因此我们这样做:
sortBy=file:modified
sortBy=file:modified
然后,我们希望将名称作为 2 个选项进行分组,以便具有相同修改的文件按照名称排序:
sortBy=file:modified;file:name
sortBy=file:modified;file:name
现在,此处存在一个问题,您可以发现它吗?对文件的修改的时间戳太正常,但如果我们只想根据日期排序,那么根据名称对子组进行排序,那么什么?
另外,我们拥有 文件语言的真实 功能,我们还可以使用其支持模式的 date 命令。因此,您可以通过以下方法解决:
sortBy=date:file:yyyyMMdd;file:name
sortBy=date:file:yyyyMMdd;file:name
Yeah 是非常强大的,根据您还可为每个组使用反向方式,因此我们可以撤销文件名:
sortBy=date:file:yyyyMMdd;reverse:file:name
sortBy=date:file:yyyyMMdd;reverse:file:name
24.28. 使用 GenericFileProcessStrategy 复制链接链接已复制到粘贴板!
选项 processStrategy 可用于使用自定义 GenericFileProcessStrategy,允许您实现自己的 开始、提交 和回滚 逻辑。
例如,假设系统在应使用的文件夹中写入文件。但是,在写另一个 就绪 文件之前,您不应该开始使用文件。
因此,通过实施自己的 GenericFileProcessStrategy,我们可以根据以下方法实现它:
-
在 start
()方法中,我们可以测试是否存在特殊的 就绪 文件。start 方法返回一个布尔值,以指示我们是否可以消耗该文件。 -
在
abort()方法中,当begin操作返回false时,可以执行特殊的逻辑,例如清理资源等。 -
在
commit ()方法中,我们可以移动实际的文件,同时删除 可用的 文件。
24.29. 使用过滤器 复制链接链接已复制到粘贴板!
filter 选项允许您通过实施 org.apache.camel.component.file.GenericFileFilter 接口在 Java 代码中实施自定义过滤器。此接口具有返回布尔值的 accept 方法。返回 true 以包含该文件,使用 false 来跳过该文件。GenericFile 有 isDirectory 方法,无论是目录。这可让您过滤不需要的目录,以避免遍历不需要的目录。
例如,要跳过名称中以 "skip" 开头的任何目录,如下所示:
24.30. 使用 bridgeErrorHandler 复制链接链接已复制到粘贴板!
如果要使用 Camel Error Handler 处理文件消费者中发生的任何异常,您可以启用 bridgeErrorHandler 选项,如下所示:
因此,您要做的只是启用此选项,路由中的错误处理程序将从那里获取它。
当使用 bridgeErrorHandler
时,在使用 bridgeErrorHandler 时,OnCompletions 不会被应用。Exchange 由 Camel Error Handler 直接处理,不允许之前的操作(如拦截器)执行操作。
24.31. 调试日志记录 复制链接链接已复制到粘贴板!
此组件具有日志级别 TRACE,如果您出现问题,这非常有用。
24.32. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用文件时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-file-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-file-starter</artifactId>
</dependency>
组件支持 11 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.cluster.file.acquire-lock-delay | 开始尝试获取锁定前等待的时间。 | 字符串 | |
| camel.cluster.file.acquire-lock-interval | 尝试获取锁定之间等待的时间。 | 字符串 | |
| camel.cluster.file.attributes | 自定义服务属性。 | Map | |
| camel.cluster.file.enabled | 设置是否应启用集群集群服务,默认为 false。 | false | 布尔值 |
| camel.cluster.file.id | 集群服务 ID。 | 字符串 | |
| camel.cluster.file.order | 服务查找顺序/优先级。 | 整数 | |
| camel.cluster.file.root | 根路径。 | 字符串 | |
| camel.component.file.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.file.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.file.enabled | 是否启用文件组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.file.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 25 章 FTP 复制链接链接已复制到粘贴板!
支持生成者和消费者
这个组件通过 FTP 和 SFTP 协议提供对远程文件系统的访问。
当从远程 FTP 服务器消耗时,请确保在进一步 消耗文件时读取名为 Default 的部分,以了解与消耗文件相关的详细信息。
不支持 绝对路径。Camel 通过修剪 directoryname 的所有前导斜杠来将绝对路径转换为相对。日志中会打印 WARN 消息。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
25.1. URI 格式 复制链接链接已复制到粘贴板!
ftp://[username@]hostname[:port]/directoryname[?options] sftp://[username@]hostname[:port]/directoryname[?options] ftps://[username@]hostname[:port]/directoryname[?options]
ftp://[username@]hostname[:port]/directoryname[?options]
sftp://[username@]hostname[:port]/directoryname[?options]
ftps://[username@]hostname[:port]/directoryname[?options]
其中 directoryname 代表底层目录。目录名称是相对路径。不支持 绝对路径。相对路径可以包含嵌套文件夹,如 /inbox/us。
支持 autoCreate 选项。当消费者启动时,在轮询前执行额外的 FTP 操作来创建端点配置的目录。autoCreate 的默认值为 true。
如果没有提供 用户名,则尝试 使用任何密码的匿名 登录。
如果没有提供 端口号,Camel 将根据协议提供默认值(ftp = 21, sftp = 22, ftps = 2222)。
您可以将查询选项附加到 URI 中,格式为 ?option=value&option=value&…
这个组件使用两个不同的库进行实际 FTP 工作。FTP 和 FTPS 使用 Apache Commons Net,而 SFTP 使用 JCraft JSCH。
FTPS (也称为 FTP 安全)是 FTP 的扩展,它增加了对传输层安全(TLS)和安全套接字层(SSL)加密协议的支持。
25.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
25.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
25.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
25.3. 组件选项 复制链接链接已复制到粘贴板!
FTP 组件支持 3 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
25.4. 端点选项 复制链接链接已复制到粘贴板!
FTP 端点使用 URI 语法进行配置:
ftp:host:port/directoryName
ftp:host:port/directoryName
使用以下路径和查询参数:
25.4.1. 路径参数(3 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| host (common) | 必需 FTP 服务器的主机名。 | 字符串 | |
| port (common) | FTP 服务器的端口。 | int | |
| directoryName (common) | 启动目录。 | 字符串 |
25.4.2. 查询参数(111 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| 二进制 (common) | 指定文件传输模式、BINARY 或 ASCII。默认为 ASCII (false)。 | false | 布尔值 |
| charset (common) | 此选项用于指定文件编码。您可以在消费者上使用此功能,以指定文件的编码,它允许 Camel 在访问文件内容时加载文件内容。在编写文件时,您可以使用此选项指定写入该文件的 charset。请注意,当编写 Camel 文件时,可能需要将消息内容读取在内存中才能将数据转换为配置的 charset,因此如果您有大量消息,则不要使用它。 | 字符串 | |
| disconnect (common) | 使用后是否断开与远程 FTP 服务器的连接。断开连接将仅断开当前与 FTP 服务器的连接。如果您有要停止的消费者,则需要停止 consumer/route。 | false | 布尔值 |
| doneFileName (common) | producer :如果提供,则 Camel 将在编写原始文件时写入第二次完成的文件。done 文件为空。这个选项配置要使用的文件名。您可以指定固定名称。或者,您可以使用动态占位符。done 文件将始终写在与原始文件相同的文件夹中。consumer :如果提供,Camel 仅在文件存在时使用文件。这个选项配置要使用的文件名。您可以指定固定名称。或者,您可以使用动态占位符。done 文件始终预期在与原始文件相同的文件夹中。仅支持 $\\{file.name} 和 $\\{file.name.next} 作为动态占位符。 | 字符串 | |
| fileName (common) | 使用 Expression (如文件语言)来动态设置文件名。对于消费者,它用作文件名过滤器。对于生成者,它用于评估要写入的文件名。如果设置了表达式,它将优先于 CamelFileName 标头。(注意:标头本身也可以是 Expression)。表达式选项支持 String 和 Expression 类型。如果表达式是字符串类型,则始终使用 File Language 来评估。如果表达式是 Expression 类型,则会使用指定的 Expression 类型 - 例如,您可以使用 OGNL 表达式。对于消费者,您可以使用它来过滤文件名,因此您可以使用 File Language 语法:mydata-$\\{date:now:yyyyMMdd}.txt 来使用现在使用的文件。producers 支持 CamelOverruleFileName 标头,其优先于任何现有 CamelFileName 标头;CamelOverruleFileName 是一个仅一次的标头,并便于避免临时存储 CamelFileName 并在以后恢复它。 | 字符串 | |
| passiveMode (common) | 设置被动模式连接。默认为活动模式连接。 | false | 布尔值 |
| 分隔符 (common) | 设置要使用的路径分隔符。unix = 使用 unix 风格的路径分隔符 Windows = 使用窗口风格路径分隔符 Auto = (默认)在文件名中使用现有路径分隔符。 Enum 值:
| UNIX | PathSeparator |
| transferLoggingIntervalSeconds (common) | 在记录上传和下载操作的进度时,配置使用的时间间隔(以秒为单位)。这可用于在操作需要更长的时间时记录进度。 | 5 | int |
| transferLoggingLevel (common) | 配置日志记录在记录上传和下载操作进度时要使用的日志级别。 Enum 值:
| DEBUG | LoggingLevel |
| transferLoggingVerbose (common) | 配置上传和下载操作进度执行详细(粒度)日志记录。 | false | 布尔值 |
| fastExistsCheck (common (advanced)) | 如果将此选项设为 true,则 camel-ftp 将直接使用列表文件来检查是否存在该文件。由于某些 FTP 服务器可能不支持直接列出文件,如果选项为 false,则 camel-ftp 将使用旧方法列出目录并检查该文件是否存在。此选项还会影响 readLock=changed,以控制它是否执行快速检查来更新文件信息。如果 FTP 服务器有很多文件,则这可用于加快进程。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| delete (consumer) | 如果为 true,则会在成功处理文件后删除该文件。 | false | 布尔值 |
| moveFailed (consumer) | 根据简单语言设置移动失败表达式。例如,要将文件移到 .error 子目录使用:.error。注意:将文件移到失败位置 Camel 将处理错误时,不会再次获取该文件。 | 字符串 | |
| noop (consumer) | 如果为 true,则文件不会以任何方式移动或删除。这个选项适用于只读数据,或 ETL 类型要求。如果 noop=true,Camel 也设置幂等=true,以避免再次消耗相同的文件。 | false | 布尔值 |
| preMove (consumer) | 在处理前移动文件名的表达式(如文件语言)。例如,要将 in-progress 文件移到 order 目录中,将此值设置为 order。 | 字符串 | |
| preSort (consumer) | 启用预排序后,消费者将在轮询过程中对文件和目录名称进行排序,这从文件系统检索。如果您需要按照排序的顺序对文件进行操作,您可能需要执行此操作。预排序是在消费者开始过滤前执行的,并接受由 Camel 处理的文件。这个选项是 default=false 表示禁用。 | false | 布尔值 |
| recursion (consumer) | 如果某个目录,也会在所有子目录中查找文件。 | false | 布尔值 |
| resumeDownload (consumer) | 配置是否启用了恢复下载。这必须被 FTP 服务器支持(大多数 FTP 服务器都支持它)。此外,还必须配置本地WorkDirectory 选项,以便下载的文件存储在本地目录中,且必须启用选项二进制文件,这是支持恢复下载所必需的。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。 | false | 布尔值 |
| streamDownload (consumer) | 设置不使用本地工作目录时要使用的下载方法。如果设置为 true,则在读取时将远程文件流传输到路由。当设置为 false 时,远程文件会在发送到路由前被加载到内存中。如果启用这个选项,则必须设置 stepwise=false,因为无法同时启用这两个步骤。 | false | 布尔值 |
| 下载 (consumer (advanced)) | FTP 使用者是否应下载该文件。如果此选项设为 false,则消息正文将为空,但消费者仍会触发具有文件详情的 Camel Exchange,如文件名、文件大小等。只是不下载该文件。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| handleDirectoryParserAbsoluteResult (consumer (advanced)) | 如果目录解析器以绝对路径导致,则允许设置消费者如何处理路径中的子文件夹和文件。因此,有些 FTP 服务器可能会用绝对路径返回文件名,那么 FTP 组件需要通过将返回的路径转换为相对路径来应对这一点。 | false | 布尔值 |
| ignoreFileNotFoundOrPermissionError (consumer (advanced)) | 是否忽略(尝试列出目录中的文件还是下载文件时),这些文件不存在还是因为权限错误。默认情况下,当某个目录或文件不存在或权限不足时,会抛出异常。将这个选项设置为 true 允许忽略它。 | false | 布尔值 |
| inProgressRepository (consumer (advanced)) | 可插拔 in-progress 存储库 org.apache.camel.spi.IdempotentRepository。in-progress 存储库用于考虑当前正在使用的进程文件中。默认使用基于内存的存储库。 | IdempotentRepository | |
| localWorkDirectory (consumer (advanced)) | 消耗时,本地工作目录可用于直接将远程文件内容存储在本地文件中,以避免将内容加载到内存中。这很有用,如果您消耗非常大的远程文件,因此可以节省内存。 | 字符串 | |
| onCompletionExceptionHandler (consumer (advanced)) | 要使用自定义 org.apache.camel.spi.ExceptionHandler 来处理在消费者进行提交或回滚的完成过程中发生的任何抛出异常。默认实现将在 WARN 级别和忽略时记录任何异常。 | ExceptionHandler | |
| pollStrategy (consumer (advanced)) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。 | PollingConsumerPollStrategy | |
| processStrategy (consumer (advanced)) | 一个可插拔的 org.apache.camel.component.file.GenericFileProcessStrategy,允许您实现自己的 readLock 选项或类似。在消耗文件之前,也可以使用特殊条件,如存在特殊的就绪文件。如果设置了这个选项,则不会应用 readLock 选项。 | GenericFileProcessStrategy | |
| useList (consumer (advanced)) | 在下载文件时,是否使用 LIST 命令。默认值为 true。在某些情况下,您可能想要下载特定的文件,且不允许使用 LIST 命令,因此您可以将这个选项设置为 false。请注意,使用这个选项时,要下载的具体文件不包括 meta-data 信息,如文件大小、时间戳、权限等,因为这些信息只能在使用 LIST 命令时检索。 | true | 布尔值 |
| fileExist (producer) | 如果文件已存在具有相同名称的文件,则该怎么办。覆盖(这是默认设置)替换现有文件。- Append - 将内容添加到现有文件中。- Fail - 抛出一个 GenericFileOperationException,表示已有的文件。- Ignore - 静默忽略问题,且不会覆盖现有的文件,但假设所有内容正常。- Move - 选项需要使用 moveExisting 选项。选项 eagerDeleteTargetFile 可以用来控制移动文件时要执行的操作,并且已存在现有文件,否则会导致移动操作失败。Move 选项将在编写目标文件前移动任何现有文件。- 只有在使用 tempFileName 选项时才适用 TryRename。这允许尝试将文件从临时名称重命名为实际名称,而无需执行任何存在检查。对于某些文件系统,这个检查可能会更快,特别是 FTP 服务器。 Enum 值:
| 覆盖 | GenericFileExist |
| flatten (producer) | 扁平化用于扁平化任何前导路径的文件名路径,因此它只是文件名。这样,您可以递归地将文件写入子目录中,但当您将文件写入另一个目录中时,它们将写入到单个目录中。在制作者上将其设置为 true 可强制在 CamelFileName 标头中为任何前导路径去除任何文件名。 | false | 布尔值 |
| jailStartingDirectory (producer) | 仅用于 jailing (限制)将文件写入启动目录(和子)。默认情况下,这不允许 Camel 将文件写入外部目录(其开箱即用)。您可以将其关闭,以允许将文件写入启动目录之外的目录,如父目录或根文件夹。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| moveExisting (producer) | 配置 fileExist=Move 时使用的表达式(如文件语言)用于计算文件名。将文件移到备份子目录中,只需输入备份。这个选项只支持以下文件语言令牌: file:name、file:name.ext、file:name.noext、file:onlyname、file:onlyname.noext、file:ext 和 file:parent。请注意,FTP 组件不支持 file:parent,因为 FTP 组件只能将任何现有文件移至基于当前 dir 作为基础的相对目录中。 | 字符串 | |
| tempFileName (producer) | 与 tempPrefix 选项相同,但提供对临时文件名命名更加精细的控制,因为它使用 File 语言。tempFilename 的位置相对于选项 'fileName' 中的最终文件位置,而不是基础 uri 中的目标目录。例如,如果选项 fileName 包含一个目录前缀:dir/finalFilename,则 tempFileName 相对于该子目录 dir。 | 字符串 | |
| tempPrefix (producer) | 此选项用于使用临时名称写入文件,然后在写入完成后将其重命名为实际名称。可用于识别正在写入的文件,并避免消费者(不使用专用读锁定)读取进度文件中。FTP 通常在上传大型文件时使用。 | 字符串 | |
| allowNullBody (producer (advanced)) | 用于指定在文件写入过程中是否允许 null 正文。如果设置为 true,则会创建一个空文件,设置为 false,并尝试向文件组件发送 null 正文,将抛出 'Cannot write null body 的 GenericFileWriteException。'如果 fileExist 选项设为 'Override',则该文件将被截断,如果设为附加该文件,则该文件将保持不变。 | false | 布尔值 |
| chmod (producer (advanced)) | 允许您在存储的文件上设置 chmod。例如 chmod=640。 | 字符串 | |
| disconnectOnBatchComplete (producer (advanced)) | Batch 上传完成后是否与远程 FTP 服务器断开连接。disconnectOnBatchComplete 只会断开当前与 FTP 服务器的连接。 | false | 布尔值 |
| eagerDeleteTargetFile (producer (advanced)) | 是否强制删除任何现有目标文件。这个选项仅在使用 fileExists=Override 和 tempFileName 选项时才适用。您可以使用它来禁用(将其设置为 false)在写入临时文件前删除目标文件。例如,您可以编写大型文件,并希望在编写临时文件过程中存在目标文件。这样可确保目标文件仅在最后一次时间之前被删除,只需在临时文件重命名为目标文件名之前。此选项还用于控制在启用 fileExist=Move 时是否删除任何现有文件,并且存在现有的文件。如果此选项 copyAndDeleteOnRenameFails false,那么如果现有文件存在,则会抛出异常(如果为 true),则在移动操作前删除现有文件。 | true | 布尔值 |
| keepLastModified (producer (advanced)) | 将保留源文件的最后修改的时间戳(若有)。将使用 Exchange.FILE_LAST_MODIFIED 标头来定位时间戳。此标头可以包含 java.util.Date 或带有时间戳的长度。如果时间戳存在,并且启用了 选项,它将在写入的文件中设置此时间戳。注:此选项仅适用于文件制作者。您不能将此选项与任何 ftp producer 一起使用。 | false | 布尔值 |
| moveExistingFileStrategy (producer (advanced)) | 用于在配置 fileExist=Move 时使用特殊命名令牌的策略(自定义策略)。默认情况下,如果没有提供自定义策略,则使用实施。 | FileMoveExistingStrategy | |
| sendNoop (producer (advanced)) | 在将文件上传到 FTP 服务器前,是否将 noop 命令作为预写检查发送。这默认是启用的,因为连接的验证仍有效,这样可以静默地重新连接可以上传该文件。但是,如果这会导致问题,您可以关闭这个选项。 | true | 布尔值 |
| activePortRange (advanced) | 在活跃模式下设置客户端端口范围。语法为:minPort-maxPort Both 端口号,包含 10000-19999,使其包含所有 1xxxx 端口。 | 字符串 | |
| auto create (advanced) | 在文件的路径中自动创建缺少的目录。对于文件消费者,这意味着创建启动目录。对于文件制作者,这意味着应将文件写入的目录。 | true | 布尔值 |
| BufferSize ( advanced) | 用于编写文件的缓冲区大小(或者 FTP 用于下载和上传文件)。 | 131072 | int |
| connectTimeout (advanced) | 设置等待连接建立由 FTPClient 和 JSCH 使用的连接超时。 | 10000 | int |
| ftpClient (advanced) | 使用 FTPClient 的自定义实例。 | FTPClient | |
| ftpClientConfig (advanced) | 要使用 FTPClientConfig 的自定义实例来配置端点应使用的 FTP 客户端。 | FTPClientConfig | |
| ftpClientConfigParameters (advanced) | FtpComponent 用来为 FTPClientConfig 提供额外的参数。 | Map | |
| ftpClientParameters (advanced) | FtpComponent 用来为 FTPClient 提供额外的参数。 | Map | |
| maximumReconnectAttempts (advanced) | 指定当 Camel 尝试连接到远程 FTP 服务器时的最大重新连接尝试。使用 0 禁用此行为。 | int | |
| reconnectDelay (advanced) | 在执行重新连接尝试前,millis Camel 将等待的时间。 | 1000 | long |
| siteCommand (advanced) | 设置在成功登录后要执行的可选站点命令。可以使用新行字符分隔多个站点命令。 | 字符串 | |
| soTimeout (advanced) | 设置 so timeout FTP 和 FTPS 是 millis 中的 SocketOptions.SO_TIMEOUT 值。建议将其设置为 300000,因为没有挂起的连接。在 SFTP 上,此选项被设置为 JSCH Session 实例上的超时。 | 300000 | int |
| 步骤( 高级) | 设置在下载文件时,还是在将文件上传到目录时,是否应先更改目录结构。例如,当您因为安全原因而无法更改 FTP 服务器上的目录时,您可以禁用此设置。步骤不能与 streamDownload 一起使用。 | true | 布尔值 |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| throwExceptionOnConnectFailed (advanced) | 如果连接失败(dhausted) By 默认异常,则不会抛出异常,并记录 WARN。您可以使用它来启用异常,并处理 org.apache.camel.spi.PollingConsumerPollStrategy 回滚方法的抛出异常。 | false | 布尔值 |
| timeout (advanced) | 为等待 FTPClient 使用的回复设置数据超时。 | 30000 | int |
| antExclude (filter) | ant 风格的过滤器排除。如果同时使用 antInclude 和 antExclude,则 antExclude 优先于 antInclude。可以使用以逗号分隔的格式指定多个排除项。 | 字符串 | |
| antFilterCaseSensitive (filter) | 在 ant 过滤器上设置区分大小写标志。 | true | 布尔值 |
| antInclude (filter) | ant 风格的过滤器包括。可使用以逗号分隔的格式指定多个 include。 | 字符串 | |
| eagerMaxMessagesPerPoll (filter) | 允许控制 maxMessagesPerPoll 的限制是 eager。如果 eager,则在扫描文件的过程中会进行限制。其中为 false 将扫描所有文件,然后执行排序。将这个选项设置为 false 允许首先排序所有文件,然后限制轮询。请注意,这需要更高的内存用量,因为所有文件详情都在内存中执行排序。 | true | 布尔值 |
| exclude (filter) | 用于排除文件(如果文件名与正则表达式模式匹配)(匹配不区分大小写)。请注意,如果您使用加号等符号,如果将其配置为端点 uri,则需要使用 RAW ()语法进行配置。有关配置端点 uri 的更多信息,请参阅。 | 字符串 | |
| excludeExt (filter) | 用于排除与文件扩展名名称匹配的文件(不区分大小写)。例如,要排除 bak 文件,则使用 excludeExt=bak。可以使用逗号分隔多个扩展,例如排除 bak 和 dat 文件,使用 excludeExt=bak,dat。请注意,文件扩展名包含所有部分,例如,有一个名为 mydata.tar.gz 的文件将扩展为 tar.gz。要获得更大的灵活性,请使用 include/exclude 选项。 | 字符串 | |
| filter (filter) | 可插拔过滤器作为 org.apache.camel.component.file.GenericFileFilter 类。如果过滤器在 accept ()方法中返回 false,则会跳过文件。 | GenericFileFilter | |
| filterDirectory (filter) | 根据简单语言过滤目录。例如,要过滤当前日期,您可以使用简单的日期模式,如 $\\{date:now:yyyMMdd}。 | 字符串 | |
| filterFile (filter) | 根据简单语言过滤文件。例如,要过滤文件大小,您可以使用 $\\{file:size} 5000。 | 字符串 | |
| 幂等 (过滤) | 使用 Idempotent Consumer EIP 模式的选项,以便 Camel 跳过已经处理的文件。默认情况下,将使用基于内存的 LRUCache,其中包含 1000 个条目。如果 noop=true 也会启用,以避免再次消耗相同的文件。 | false | 布尔值 |
| idempotentKey (filter) | 使用自定义幂等键,请执行以下操作:默认情况下,使用该文件的绝对路径。您可以使用 File Language,例如使用文件名和文件大小,您可以执行以下操作:OnlydKey=$\\{file:name}-$\\{file:size}。 | 字符串 | |
| idempotentRepository (filter) | 可插拔存储库 org.apache.camel.spi.IdempotentRepository,它默认使用 MemoryIdempotentRepository (如果没有指定),且幂等性为 true。 | IdempotentRepository | |
| include (filter) | 用于包含文件,如果文件名与正则表达式模式匹配(匹配不区分大小写)。请注意,如果您使用加号等符号,如果将其配置为端点 uri,则需要使用 RAW ()语法进行配置。有关配置端点 uri 的更多信息,请参阅。 | 字符串 | |
| includeExt (filter) | 用于包括匹配文件扩展名名称的文件(不区分大小写)。例如,要包含 txt 文件,则使用 includeExt=txt。可以使用逗号分隔多个扩展,例如包含 txt 和 xml 文件,请使用 includeExt=txt,xml。请注意,文件扩展名包含所有部分,例如,有一个名为 mydata.tar.gz 的文件将扩展为 tar.gz。要获得更大的灵活性,请使用 include/exclude 选项。 | 字符串 | |
| maxDepth (filter) | 递归处理目录时要遍历的最大深度。 | 2147483647 | int |
| maxMessagesPerPoll (filter) | 定义每次轮询收集的最大消息。默认情况下不设置最大值。可用于设置限制,例如 1000,以避免在启动有数千个文件的服务器时避免。将值设为 0 或负数设置为禁用它。注意:如果使用这个选项,则文件和 FTP 组件将在任何排序前受到限制。例如,如果您有 100000 文件并使用 maxMessagesPerPoll=500,则仅获取前 500 个文件,然后排序。您可以使用 eagerMaxMessagesPerPoll 选项,并将其设置为 false 以允许首先扫描所有文件,然后对文件进行排序。 | int | |
| minDepth (filter) | 递归处理目录时开始处理的最小深度。使用 minDepth=1 表示主目录。使用 minDepth=2 表示第一个子目录。 | int | |
| Move (filter) | 在处理后移动文件名的表达式(如简单语言)。将文件移到 .done 子目录中,只需输入 .done。 | 字符串 | |
| exclusiveReadLockStrategy (lock) | 可插拔读锁定作为 org.apache.camel.component.file.GenericFileExclusiveReadLockStrategy 实现。 | GenericFileExclusiveReadLockStrategy | |
| readLock (lock) | 消费者使用,仅在文件有独占的 read-lock 时轮询文件(例如,该文件不是 in-progress 或 in-progress 或正在写入)。Camel 将等到赋予文件锁定。此选项在策略中提供构建: - none - No read lock is use - markFile - Camel 创建标记文件(fileName.camelLock),然后在其上保存锁定。FTP 组件无法使用这个选项 - Changed - Changed 使用文件长度/修改时间戳来检测文件当前是否复制。至少将使用 1 sec 来确定这一点,因此此选项无法像其他进程一样快速使用文件,但可能会更可靠,因为 JDK IO API 并不总是确定当前由其他进程使用的文件。选项 readLockCheckInterval 可用于设置检查频率。- fileLock - 使用 java.nio.channels.FileLock。这个选项不适用于 Windows OS 和 FTP 组件。在通过 mount/share 访问远程文件系统时,应该避免这种方法,除非该文件系统支持分布式文件锁定。- 重命名是使用尝试将文件重命名为测试(如果我们可以获得专用 read-lock. - 幂等的 - (仅用于文件组件)用于使用幂等结构作为读锁定。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定。- idempotent-changed - (仅限文件组件)幂等性更改是使用幂等的Repository,并作为组合的 read-lock 进行更改。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定。- idempotent-rename - (仅用于文件组件)幂等名称使用幂等权限,并重命名为组合的 read-lock。如果幂等存储库实现支持集群,这允许使用支持集群的读锁定:各种读锁定并不是在集群模式下工作的,其中不同节点上的并发消费者对共享文件系统中的同一文件都是竞争的。使用一个接近原子操作的 markFile 来创建空标记文件,但无法保证在集群中工作。fileLock 可能更好,但文件系统需要支持分布式文件锁定等。如果幂等存储库支持集群,如 Hazelcast 组件或 Infinispan,则使用幂等读锁定支持集群。 Enum 值:
| none | 字符串 |
| readLockCheckInterval (lock) | read-lock 的 millis (如果读锁定支持)。这个间隔用于在尝试获取读锁定之间休眠。例如,在使用更改的读锁定时,您可以为较慢的写入设置更高的间隔周期。如果生成者非常慢,则默认值 1 sec. 可能太快。注意:对于 FTP,默认的 readLockCheckInterval 为 5000。readLockTimeout 值必须大于 readLockCheckInterval,但 thumb 的规则是具有至少 2 个或大于 readLockCheckInterval 的超时。这需要确保读锁定进程允许冻结时间,以便在超时命中前尝试获取锁定。 | 1000 | long |
| readLockDeleteOrphanLockFiles (lock) | 如果 Camel 没有正确关闭,则是否应在启动时读取带有标记文件(比如 JVM 崩溃)删除任何孤立的读锁定文件(如果 Camel 没有被正确关闭)。如果将此选项设置为 false,则任何孤立的锁定文件将导致 Camel 不尝试获取该文件,这可能是因为另一个节点同时从同一共享目录读取文件。 | true | 布尔值 |
| readLockLoggingLevel (lock) | 无法获取读取锁定时使用的日志记录级别。默认情况下,会记录 DEBUG。您可以更改此级别,例如 OFF 没有任何日志记录。这个选项仅适用于 readLock 类型: changed, fileLock, idempotent, idempotent-changed, idempotent-rename, rename。 Enum 值:
| DEBUG | LoggingLevel |
| readLockMarkerFile (lock) | 是否将标记文件与更改、重命名或专用读取锁定类型一起使用。默认情况下,使用标记文件来保护其他进程获取同一文件。通过将这个选项设置为 false,可以关闭此行为。例如,如果您不想由 Camel 应用程序将标记文件写入文件系统。 | true | 布尔值 |
| readLockMinAge (lock) | 这个选项仅适用于 readLock=changed。它允许在尝试获取读取锁定前指定该文件的最短期限。例如,使用 readLockMinAge=300s 来要求文件持续 5 分钟。这可加快更改的读锁定速度,因为它将尝试获取至少给定时间的文件。 | 0 | long |
| readLockMinLength (lock) | 这个选项仅适用于 readLock=changed。它允许您配置最小文件长度。默认情况下,Camel 期望文件包含数据,因此默认值为 1。您可以将这个选项设置为零,以允许消耗零长度文件。 | 1 | long |
| readLockRemoveOnCommit (lock) | 这个选项仅适用于 readLock=idempotent。它允许在处理文件成功并发生提交时指定是否从幂等存储库中删除文件名条目。默认情况下,该文件不会被删除,这样可确保不会发生任何竞争条件,因此另一个活跃节点可能会尝试获取该文件。相反,幂等存储库可以支持驱除策略,您可以在 X 分钟后驱除文件名条目 - 这样可确保出现竞争条件的问题。请参阅 readLockIdempotentReleaseDelay 选项的详情。 | false | 布尔值 |
| readLockRemoveOnRollback (lock) | 这个选项仅适用于 readLock=idempotent。它允许在处理文件失败时指定是否从幂等存储库中删除文件名条目,并且进行回滚。如果此选项为 false,则确认文件名条目(就像文件进行了提交一样)。 | true | 布尔值 |
| readLockTimeout (lock) | 可选的 timeout (如果 read-lock 支持)用于读锁定。如果无法授予 read-lock 并触发超时,则 Camel 将跳过该文件。下一次轮询 Camel 时,将再次尝试 文件,这一次可能会授予读锁定。使用 0 或较低值来指示永久值。当前 fileLock、change 和 rename 支持超时。注意:对于 FTP,默认的 readLockTimeout 值为 20000,而不是 10000。readLockTimeout 值必须大于 readLockCheckInterval,但 thumb 的规则是具有至少 2 个或大于 readLockCheckInterval 的超时。这需要确保读锁定进程允许冻结时间,以便在超时命中前尝试获取锁定。 | 10000 | long |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间(毫秒)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。 | 1000 | long |
| repeatCount (scheduler) | 指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。 | 0 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 Enum 值:
| TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。 | ScheduledExecutorService | |
| scheduler (scheduler) | 要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。 | none | 对象 |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 Enum 值:
| MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
| 帐户 (安全) | 用于登录的帐户。 | 字符串 | |
| 密码 (安全) | 用于登录的密码。 | 字符串 | |
| 用户名 (安全) | 用于登录的用户名。 | 字符串 | |
| shuffle (sort) | 影响文件列表(按随机顺序排列)。 | false | 布尔值 |
| sortBy (sort) | 使用文件语言内置排序。支持嵌套排序,以便您可以按文件名排序,并作为按修改日期排序的第二个组。 | 字符串 | |
| 排序 者(排序) | 可插拔排序器作为 java.util.Comparator 类。 | 比较器 |
25.5. FTPS 组件默认信任存储 复制链接链接已复制到粘贴板!
当将与 SSL 相关的 ftpClient. 属性与 FTPS 组件搭配使用时,信任存储会接受所有证书。如果您只想信任选择的证书,则必须使用 ftpClient.trustStore.xxx 选项或配置自定义 ftpClient 来配置信任存储。
在使用 sslContextParameters 时,信任存储由提供的 SSLContextParameters 实例的配置来管理。
您可以使用 ftpClient. 或 ftpClientConfig. 前缀直接在 URI 上配置 ftpClient 和 ftpClientConfig 上的附加选项。
例如,要将 FTPClient 上的 setDataTimeout 设置为 30 秒,您可以执行以下操作:
from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000").to("bean:foo");
from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000").to("bean:foo");
您可以混合和匹配,并使用这两个前缀,例如配置日期格式或时区。
from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr").to("bean:foo");
from("ftp://foo@myserver?password=secret&ftpClient.dataTimeout=30000&ftpClientConfig.serverLanguageCode=fr").to("bean:foo");
您可以根据需要拥有尽可能多的选项。
有关可能的选项以及更多详情,请参阅 Apache Commons FTPClientConfig 文档。另外,对于 Apache Commons FTPClient。
如果您不想在 url 中有多个和较长的配置,您可以通过让 Registry 中的 Camel 查找供 registry 引用要使用的 ftpClient 或 ftpClientConfig。
例如:
<bean id="myConfig" class="org.apache.commons.net.ftp.FTPClientConfig">
<property name="lenientFutureDates" value="true"/>
<property name="serverLanguageCode" value="fr"/>
</bean>
<bean id="myConfig" class="org.apache.commons.net.ftp.FTPClientConfig">
<property name="lenientFutureDates" value="true"/>
<property name="serverLanguageCode" value="fr"/>
</bean>
然后,当您在 url 中使用 sVirt 表示法时,请让 Camel 查找此 bean。
from("ftp://foo@myserver?password=secret&ftpClientConfig=#myConfig").to("bean:foo");
from("ftp://foo@myserver?password=secret&ftpClientConfig=#myConfig").to("bean:foo");
25.6. 例子 复制链接链接已复制到粘贴板!
ftp://someone@someftpserver.com/public/upload/images/holiday2008?password=secret&binary=true ftp://someoneelse@someotherftpserver.co.uk:12049/reports/2008/password=secret&binary=false ftp://publicftpserver.com/download
ftp://someone@someftpserver.com/public/upload/images/holiday2008?password=secret&binary=true
ftp://someoneelse@someotherftpserver.co.uk:12049/reports/2008/password=secret&binary=false
ftp://publicftpserver.com/download
25.7. 并发 复制链接链接已复制到粘贴板!
FTP Consumer 不支持并发
FTP 使用者(具有相同端点)不支持并发(后备 FTP 客户端不安全)。
您可以使用多个 FTP 用户从不同的端点轮询。它只是不支持并发消费者的单一端点。
FTP 制作者 没有 这个问题,它支持并发。
25.8. 更多信息 复制链接链接已复制到粘贴板!
这个组件是 File 组件的扩展。因此,File 组件页面中还有更多样本和详情。
25.9. 使用文件时的默认 复制链接链接已复制到粘贴板!
FTP 使用者默认会将消耗的文件留在远程 FTP 服务器上。如果您希望删除文件或将它们移动到其他位置,则必须明确配置它。例如,您可以使用 delete=true 删除文件,或使用 move=.done 将文件移到隐藏的子目录中。
常规文件消费者与默认情况下,该文件将文件移到 .camel 子目录。对于 FTP 消费者,Camel 默认 不会 执行此操作的原因是,默认情况下可能会缺少权限来移动或删除文件。
25.9.1. 限制 复制链接链接已复制到粘贴板!
选项 readLock 可用于强制 Camel 不 消耗当前正在写入中的文件。但是,此选项默认关闭,因为它要求用户具有写入访问权限。有关读取锁定的详情,请查看 File2 中的选项表。
其他解决方案可以避免当前通过 FTP 写入的文件;例如,您可以写入一个临时目的地并在文件被写入后移动该文件。
使用 move 或 preMove 选项移动文件时,文件仅限于 FTP_ROOT 文件夹。这可防止您在 FTP 区域外移动文件。如果要将文件移动到另一个区域,您可以使用软链接并将文件移到软链接文件夹中。
25.10. 消息标头 复制链接链接已复制到粘贴板!
以下消息标头可用于影响组件的行为
| 标头 | 描述 |
|---|---|
|
| 指定发送到端点时用于输出消息的输出文件名(相对于端点目录)。如果这不存在且没有表达式,则生成的消息 ID 将用作文件名。 |
|
| 所写入的输出文件的实际文件路径(路径 + 名称)。此标头由 Camel 设置,其用途是为最终用户提供所写入文件的名称。 |
|
| 消耗的文件的文件名 |
|
| 远程主机名。 |
|
| 使用本地工作目录的路径(如果使用本地工作目录)。 |
此外,FTP/FTPS 使用者和制作者还将增强带有以下标头的 Camel 消息
| 标头 | 描述 |
|---|---|
|
| FTP 客户端回复代码(类型是一个整数) |
|
| FTP 客户端回复字符串 |
25.10.1. 交换属性 复制链接链接已复制到粘贴板!
Camel 设置以下交换属性
| 标头 | 描述 |
|---|---|
|
| 当前索引在这个批处理中消耗的文件总数中。 |
|
| 在这个批处理中消耗的文件总数。 |
|
| 如果此批处理中没有更多文件,则为 true。 |
25.11. 关于超时 复制链接链接已复制到粘贴板!
两组库(请参阅 top)有不同的 API 来设置超时。您可以使用这两者的 connectTimeout 选项在 millis 中设置超时来建立网络连接。也可以在 FTP/FTPS 上设置单独的 soTimeout,它与使用 ftpClient.soTimeout 对应。注意 SFTP 将自动使用 connectTimeout 作为其 soTimeout。timeout 选项仅适用于 FTP/FTPS 作为数据超时,对应于 ftpClient.dataTimeout 值。所有超时值都为 millis。
25.12. 使用本地工作目录 复制链接链接已复制到粘贴板!
Camel 支持从远程 FTP 服务器消耗,并将文件直接下载到本地工作目录中。这可避免将整个远程文件内容读取在内存中,因为它使用 FileOutputStream 直接流传输到本地文件。
Camel 将存储到名称与远程文件相同的本地文件,但在下载文件时使用 .inprogress 与扩展名。之后,文件被重命名为删除 .inprogress 后缀。最后,当 Exchange 完成后,将删除本地文件。
因此,如果要从远程 FTP 服务器下载文件并将其存储为文件,则需要路由到文件端点,例如:
from("ftp://someone@someserver.com?password=secret&localWorkDirectory=/tmp").to("file://inbox");
from("ftp://someone@someserver.com?password=secret&localWorkDirectory=/tmp").to("file://inbox");
以上路由效率更高,因为它可避免将整个文件内容读取到内存中。它将直接将远程文件下载到本地文件流。java.io.File 处理随后用作交换正文。文件制作者利用此事实,可以直接用于工作文件 java.io.File handle,并对目标文件名执行 java.io.File.rename。由于 Camel 知道它是一个本地的工作文件,它可以优化并使用重命名而不是文件副本,因为工作文件旨在删除。
25.13. 步骤更改目录 复制链接链接已复制到粘贴板!
在消耗文件(例如下载)或生成文件(例如上传)时,Camel FTP 可以在两个模式下运行。
- stepwise
- 没有步骤
您可能希望根据您的情况和安全问题选择一个。有些 Camel 最终用户只能在使用步骤时下载文件,而其他一些用户只能下载这些文件。
您可以使用 stepwise 选项来控制行为。
请注意,当大多数情况下,只有在用户仅限于主目录以及将主目录报告为 "/" 时,才会更改目录。
这两者之间的区别最好在示例中演示。假设我们需要在远程 FTP 服务器上有以下目录结构,我们需要遍历并下载文件:
/ /one /one/two /one/two/sub-a /one/two/sub-b
/
/one
/one/two
/one/two/sub-a
/one/two/sub-b
我们在每个子 A (a.txt)和 sub-b (b.txt)文件夹中都有一个文件。
25.14. 使用 stepwise=true (默认模式) 复制链接链接已复制到粘贴板!
如在启用步骤时可以看到,它会遍历使用 CD xxx 的目录结构。
25.15. 使用 stepwise=false 复制链接链接已复制到粘贴板!
如您在不使用步骤时可以看到,根本不调用 CD 操作。
25.16. Samples 复制链接链接已复制到粘贴板!
在以下示例中,我们设置 Camel 以每小时(60 分钟)从 FTP 服务器下载所有报告作为 BINARY 内容,并将它存储为本地文件系统中的文件。
和使用 XML DSL 的路由:
<route>
<from uri="ftp://scott@localhost/public/reports?password=tiger&binary=true&delay=60000"/>
<to uri="file://target/test-reports"/>
</route>
<route>
<from uri="ftp://scott@localhost/public/reports?password=tiger&binary=true&delay=60000"/>
<to uri="file://target/test-reports"/>
</route>
25.16.1. 使用远程 FTPS 服务器(指示 SSL)和客户端身份验证 复制链接链接已复制到粘贴板!
from("ftps://admin@localhost:2222/public/camel?password=admin&securityProtocol=SSL&implicit=true
&ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to("bean:foo");
from("ftps://admin@localhost:2222/public/camel?password=admin&securityProtocol=SSL&implicit=true
&ftpClient.keyStore.file=./src/test/resources/server.jks
&ftpClient.keyStore.password=password&ftpClient.keyStore.keyPassword=password")
.to("bean:foo");
25.16.2. 使用远程 FTPS 服务器(explicit TLS)和自定义信任存储配置 复制链接链接已复制到粘贴板!
from("ftps://admin@localhost:2222/public/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password")
.to("bean:foo");
from("ftps://admin@localhost:2222/public/camel?password=admin&ftpClient.trustStore.file=./src/test/resources/server.jks&ftpClient.trustStore.password=password")
.to("bean:foo");
25.17. 自定义过滤 复制链接链接已复制到粘贴板!
Camel 支持可插拔过滤策略。此策略使用 Java 中的 org.apache.camel.component.file.GenericFileFilter 中的构建。然后,您可以使用这样的过滤器配置端点,以在处理前跳过某些过滤器。
在示例中,我们构建了自己的过滤器,该过滤器仅接受文件名中以 report 开头的文件。
然后,我们可以使用 filter 属性配置路由,以引用我们在 spring XML 文件中定义的过滤器(使用 spring 表示法):
25.18. 使用 ANT 路径匹配程序进行过滤 复制链接链接已复制到粘贴板!
ANT 路径匹配程序是在 camel-spring jar 中提供的开箱即用的过滤器。因此,如果您使用 Maven,则需要依赖于 camel-spring。
我们利用 Spring 的 AntPathMatcher 进行实际匹配的原因。
文件路径与以下规则匹配:
-
?匹配一个字符 -
DNAT匹配零个或多个字符 -
Tailoring匹配路径中的零个或多个目录
以下示例演示了如何使用它:
25.19. 使用带有 SFTP 的代理 复制链接链接已复制到粘贴板!
要使用 HTTP 代理连接到远程主机,您可以使用以下方法配置路由:
如果需要,您还可以为代理分配用户名和密码。请参考 com.jcraft.jsch.Proxy 文档来发现所有选项。
25.20. 设置首选 SFTP 验证方法 复制链接链接已复制到粘贴板!
如果要明确指定 sftp 组件应使用的身份验证方法列表,请使用 preferredAuthentications 选项。例如,如果您希望 Camel 尝试使用私有/公共 SSH 密钥进行身份验证,并在没有公钥可用时回退到用户/密码身份验证,请使用以下路由配置:
from("sftp://localhost:9999/root?username=admin&password=admin&preferredAuthentications=publickey,password").
to("bean:processFile");
from("sftp://localhost:9999/root?username=admin&password=admin&preferredAuthentications=publickey,password").
to("bean:processFile");
25.21. 使用固定名称消耗单个文件 复制链接链接已复制到粘贴板!
当您想下载单个文件并知道文件名时,您可以使用 fileName=myFileName.txt 告知 Camel 要下载的文件的名称。默认情况下,消费者仍会执行 FTP LIST 命令来执行目录列表,然后根据 fileName 选项过滤这些文件。虽然在这种情况下,可能需要通过设置 useList=false 来关闭目录列表。例如,用于登录到 FTP 服务器的用户帐户可能没有执行 FTP LIST 命令的权限。因此,您可以使用 useList=false 将其关闭,然后提供要下载的文件的固定名称 fileName=myFileName.txt,然后 FTP 使用者仍然可以下载该文件。如果由于某种原因的文件不存在,则 Camel 默认抛出异常,您可以关闭此异常,并通过设置 ignoreFileNotFoundOrPermissionError=true 来忽略此文件。
例如,要有一个 Camel 路由来提取单个文件,并在使用后将其删除
from("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true")
.to("activemq:queue:report");
from("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true")
.to("activemq:queue:report");
请注意,我们使用了上面讨论的所有选项。
您还可以将其用于 ConsumerTemplate。例如,要下载单个文件(如果存在),并将文件内容作为 String 类型获取:
String data = template.retrieveBodyNoWait("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true", String.class);
String data = template.retrieveBodyNoWait("ftp://admin@localhost:21/nolist/?password=admin&stepwise=false&useList=false&ignoreFileNotFoundOrPermissionError=true&fileName=report.txt&delete=true", String.class);
25.22. 调试日志记录 复制链接链接已复制到粘贴板!
此组件具有日志级别 TRACE,如果您出现问题,这非常有用。
25.23. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 ftp 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-ftp-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-ftp-starter</artifactId>
</dependency>
组件支持 13 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.ftp.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.ftp.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.ftp.enabled | 是否启用 ftp 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.ftp.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.ftps.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.ftps.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.ftps.enabled | 是否启用 ftps 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.ftps.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.ftps.use-global-ssl-context-parameters | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
| camel.component.sftp.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.sftp.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.sftp.enabled | 是否启用 sftp 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.sftp.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
第 26 章 Google BigQuery 复制链接链接已复制到粘贴板!
从 Camel 2.20 开始
仅支持生成者。
Google Bigquery 组件通过 link:https://developers.google.com/api-client-library/java/apis/bigquery/v2 [Google Client Services API] 提供对 Cloud BigQuery Infrastructure 的访问。
当前实施不使用 gRPC。
当前实施不支持查询 BigQuery,它只是一个制作者。
将以下依赖项添加到此组件的 pom.xml 中:
26.1. 身份验证配置 复制链接链接已复制到粘贴板!
Google BigQuery 组件身份验证主要用于 GCP 服务帐户。如需更多信息,请参阅 Google Cloud Platform Auth Guide。
Google 安全凭证可以通过提供到 GCP 凭证文件位置的路径来明确设置。
或者它们被隐式设置,其中连接工厂回退到 应用程序默认凭据。
具有 服务帐户密钥 时,您可以为应用程序代码提供身份验证凭据。Google 安全凭证可以通过组件端点设置:
String endpoint = "google-bigquery://project-id:datasetId[:tableId]?serviceAccountKey=/home/user/Downloads/my-key.json";
String endpoint = "google-bigquery://project-id:datasetId[:tableId]?serviceAccountKey=/home/user/Downloads/my-key.json";
如果您不想设置文件系统路径,您还可以使用身份验证凭证文件的 base64 编码内容。
String endpoint = "google-bigquery://project-id:datasetId[:tableId]?serviceAccountKey=base64:<base64 encoded>";
String endpoint = "google-bigquery://project-id:datasetId[:tableId]?serviceAccountKey=base64:<base64 encoded>";
或者设置环境变量 GOOGLE_APPLICATION_CREDENTIALS :
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
26.2. URI 格式 复制链接链接已复制到粘贴板!
google-bigquery://project-id:datasetId[:tableId]?[options]
google-bigquery://project-id:datasetId[:tableId]?[options]
26.3. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
26.3.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
26.3.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
26.4. 组件选项 复制链接链接已复制到粘贴板!
Google BigQuery 组件支持 5 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| ConnectionFactory (producer) | Autowired ConnectionFactory 获取与 Bigquery 服务的连接。如果没有提供默认值,则使用默认值。 | GoogleBigQueryConnectionFactory | |
| datasetId (producer) | BigQuery Dataset Id. | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| projectID ( producer) | Google Cloud Project Id。 | 字符串 | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
26.5. 端点选项 复制链接链接已复制到粘贴板!
Google BigQuery 端点使用 URI 语法进行配置:
google-bigquery:projectId:datasetId:tableId
google-bigquery:projectId:datasetId:tableId
使用以下路径和查询参数:
26.5.1. 路径参数(3 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| projectID ( common) | 所需的 Google Cloud Project Id。 | 字符串 | |
| datasetId (common) | 所需的 BigQuery Dataset Id。 | 字符串 | |
| tableid (common) | BigQuery 表 ID。 | 字符串 |
26.5.2. 查询参数(4 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| ConnectionFactory (producer) | Autowired ConnectionFactory 获取与 Bigquery 服务的连接。如果没有提供默认值,则使用默认值。 | GoogleBigQueryConnectionFactory | |
| useAsInsertId (producer) | 用作插入 id 的字段名称。 | 字符串 | |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| serviceAccountKey (security) | 使用 json 格式的服务帐户密钥,将应用程序验证为 google 云平台的服务帐户。 | 字符串 |
26.6. 消息标头 复制链接链接已复制到粘贴板!
Google BigQuery 组件支持 4 个消息标头,如下所列:
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| CamelGoogleBigQueryTableSuffix (producer) 常数:T ABLE_SUFFIX | 插入数据时使用的表后缀。 | 字符串 | |
| CamelGoogleBigQueryTableId (producer) 常数:T ABLE_ID | 表 ID,数据将被提交。如果指定将覆盖端点配置。 | 字符串 | |
| CamelGoogleBigQueryInsertId (producer) 常量: INSERT_ID | 插入数据时要使用的 InsertId。 | 字符串 | |
| CamelGoogleBigQueryPartitionDecorator (producer) | 分区 decorator 来指示插入数据时要使用的分区。 | 字符串 |
26.7. 制作者端点 复制链接链接已复制到粘贴板!
生产者端点可以接受并交付对 个人,并分组交换。组交换设置了 Exchange.GROUPED_EXCHANGE 属性集。
Google BigQuery producer 将在单个 api 调用中发送一个分组交换,除非指定了不同的表后缀或分区修饰符,这样可将其中断,以确保数据使用正确的后缀或分区 decorator 编写。
Google BigQuery 端点预期有效负载是映射或映射列表。包含映射的有效负载将插入一行,包含映射列表的有效负载将在列表中为每个条目插入一行。
26.8. 模板表 复制链接链接已复制到粘贴板!
模板表可以使用 GoogleBigQueryConstants.TABLE_SUFFIX 标头来指定。例如,以下路由将创建表并插入每天分片的记录:
from("direct:start")
.header(GoogleBigQueryConstants.TABLE_SUFFIX, "_${date:now:yyyyMMdd}")
.to("google-bigquery:sampleDataset:sampleTable")
from("direct:start")
.header(GoogleBigQueryConstants.TABLE_SUFFIX, "_${date:now:yyyyMMdd}")
.to("google-bigquery:sampleDataset:sampleTable")
建议您将此分区用于这个用例。
有关模板表的更多信息,请参阅 模板表。
26.9. 分区 复制链接链接已复制到粘贴板!
在创建表时指定分区,如果设置的数据将自动分区到单独的表中。在插入数据时,可通过设置交换上的 GoogleBigQueryConstants.PARTITION_DECORATOR 标头来指定特定分区。
有关分区的更多信息,请参阅创建分区表。
26.10. 确保数据一致性 复制链接链接已复制到粘贴板!
可以在带有标头 GoogleBigQueryConstants.INSERT_ID 的交换上设置插入 id,或者指定查询参数 useAsInsertId。因为插入 id 需要每行指定,当有效负载是一个列表时,将不会使用插入的交换标头。如果有效负载是一个列表,则将忽略 GoogleBigQueryConstants.INSERT_ID。在这种情况下,使用查询参数 useAsInsertId。
如需更多信息,请参阅 数据一致性
26.11. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 google-bigquery 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-google-bigquery-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-google-bigquery-starter</artifactId>
</dependency>
组件支持 11 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.google-bigquery-sql.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.google-bigquery-sql.connection-factory | ConnectionFactory 获取与 Bladequery 服务的连接。如果没有提供默认值,则使用默认值。选项是一个 org.apache.camel.component.google.bigquery.GoogleBigQueryConnectionFactory 类型。 | GoogleBigQueryConnectionFactory | |
| camel.component.google-bigquery-sql.enabled | 是否启用 google-bigquery-sql 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.google-bigquery-sql.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.google-bigquery-sql.project-id | Google Cloud Project Id。 | 字符串 | |
| camel.component.google-bigquery.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.google-bigquery.connection-factory | ConnectionFactory 获取与 Bladequery 服务的连接。如果没有提供默认值,则使用默认值。选项是一个 org.apache.camel.component.google.bigquery.GoogleBigQueryConnectionFactory 类型。 | GoogleBigQueryConnectionFactory | |
| camel.component.google-bigquery.dataset-id | BigQuery Dataset Id. | 字符串 | |
| camel.component.google-bigquery.enabled | 是否启用 google-bigquery 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.google-bigquery.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.google-bigquery.project-id | Google Cloud Project Id。 | 字符串 |
第 27 章 Google Pubsub 复制链接链接已复制到粘贴板!
从 Camel 2.19 开始
支持生成者和消费者。
Google Pubsub 组件通过 Google Cloud Java Client for Google Cloud Pub/Sub 提供对 Cloud Pub/Sub Infrastructure 的访问。
将以下依赖项添加到此组件的 pom.xml 中:
27.1. URI 格式 复制链接链接已复制到粘贴板!
Google Pubsub 组件使用以下 URI 格式:
google-pubsub://project-id:destinationName?[options]
google-pubsub://project-id:destinationName?[options]
目的地名称可以是主题或订阅名称。
27.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
27.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
27.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
27.3. 组件选项 复制链接链接已复制到粘贴板!
Google Pubsub 组件支持 10 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| Authentication (common) | 与 PubSub 服务交互时使用凭证(在使用仿真器时不需要身份验证)。 | true | 布尔值 |
| endpoint (common) | 用于本地 Pub/Sub 模拟器的端点。 | 字符串 | |
| serviceAccountKey (common) | Service account key,可用作 PubSub publisher/subscriber 的凭证。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| synchronousPullRetryableCodes (consumer) | 用于同步拉取的额外可重试错误代码列表。默认情况下,PubSub 客户端库重试 ABORTED、UNAVAILABLE、UNKNOWN。 | 字符串 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| publisherCacheSize (producer) | 要缓存的最大制作者数。如果您有许多不同主题的制作者,则可以增加。 | int | |
| publisherCacheTimeout (producer) | 每个制作者在缓存中保持活跃的毫秒。 | int | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| publisherTerminationTimeout (advanced) | 允许生成者终止的毫秒数。 | int |
27.4. 端点选项 复制链接链接已复制到粘贴板!
Google Pubsub 端点使用 URI 语法进行配置:
google-pubsub:projectId:destinationName
google-pubsub:projectId:destinationName
使用以下路径和查询参数:
27.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| projectID ( common) | 需要 Google Cloud PubSub Project Id。 | 字符串 | |
| destinationName (common) | 必需 目的地名称。对于消费者,这是订阅名称,而对于生成者而言,这是主题名称。 | 字符串 |
27.4.2. 查询参数(15 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| Authentication (common) | 与 PubSub 服务交互时使用凭证(在使用仿真器时不需要身份验证)。 | true | 布尔值 |
| loggerId (common) | 与父路由匹配的日志记录器 ID。 | 字符串 | |
| serviceAccountKey (common) | Service account key,可用作 PubSub publisher/subscriber 的凭证。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| ackMode (consumer) | AUTO = 交换在完成后被 ack'ed/nack'ed。NONE = 下游进程必须明确 ack/nack。 Enum 值:
| AUTO | AckMode |
| concurrentConsumers (consumer) | 来自订阅的并行流数量。 | 1 | 整数 |
| maxAckExtensionPeriod (consumer) | 设置消息 ack deadline 将扩展的最大周期。值(以秒为单位)。 | 3600 | int |
| maxMessagesPerPoll (consumer) | 在单个 API 调用中从服务器接收的最大消息数。 | 1 | 整数 |
| synchronousPull (consumer) | 同步拉取批处理消息。 | false | 布尔值 |
| bridgeErrorHandler (consumer (advanced)) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| messageOrderingEnabled (producer (advanced)) | 应该启用消息排序。 | false | 布尔值 |
| pubsubEndpoint (producer (advanced)) | 要使用的 pub/Sub 端点。使用消息排序时需要,并确保即使使用多个发布者,也会按顺序接收消息。 | 字符串 | |
| serializer (producer (advanced)) | Autowired A 自定义 GooglePubsubSerializer,用于在制作者中序列化消息有效负载。 | GooglePubsubSerializer |
27.5. 消息标头 复制链接链接已复制到粘贴板!
Google Pubsub 组件支持 5 个消息标头,如下所列:
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| CamelGooglePubsubMessageId (common) 常量: MESSAGE_ID | 服务器发布消息时分配的消息的 ID。 | 字符串 | |
| CamelGooglePubsubMsgAckId (consumer) 常数: ACK_ID | 用于确认收到的消息的 ID。 | 字符串 | |
| CamelGooglePubsubPublishTime (consumer) 常数: PUBLISH_TIME | 发布消息的时间。 | Timestamp | |
| CamelGooglePubsubAttributes (common) 常量: ATTRIBUTES | 消息的属性。 | Map | |
| CamelGooglePubsubOrderingKey (producer) 常量: ORDERING_KEY | 如果非空,请识别应遵守发布订购的相关消息。 | 字符串 |
27.6. 制作者端点 复制链接链接已复制到粘贴板!
制作者端点可以接受并传送到 PubSub 个人并分组交换。组交换设置了 Exchange.GROUPED_EXCHANGE 属性集。
Google PubSub 期望有效负载为 byte[] 数组,Producer 端点将发送:
- 字符串正文作为 byte[] 编码,格式为 UTF-8
- byte[] body,如下所示
- 其他所有内容将序列化为 byte[] 数组
将 Map 设置为消息标头 GooglePubsubConstants.ATTRIBUTES 将作为 PubSub 属性发送。
Google PubSub 支持排序消息发送。
要启用此设置,将选项 messageOrderingEnabled 设置为 true,并将 pubsubEndpoint 设置为 GCP 区域。
生成消息时,设置消息标头 GooglePubsubConstants.ORDERING_KEY。这将设置为消息的 PubSub sortKey。
有关 订购消息 的更多信息。
交换传送到 PubSub 后,PubSub 消息 ID 将分配给标头 GooglePubsubConstants.MESSAGE_ID。
27.7. 消费者端点 复制链接链接已复制到粘贴板!
如果在订阅上的配置选项内未确认,Google PubSub 将重新发送消息。
在交换处理完成后,组件将确认消息。
如果路由抛出异常,则交换将标记为失败,组件将 NACK 消息 - 它将立即重新连接。
要对消息进行 ack/nack 操作,组件使用 Acknowledgement ID 作为标头 GooglePubsubConstants.ACK_ID。如果删除了或篡改了标头,ack 将失败,并在 ack 截止时间后再次通知消息。
27.8. 消息正文 复制链接链接已复制到粘贴板!
消费者端点将消息的内容返回为 byte[] - 与底层系统发送一样。它是转换/退出所有内容的路由。
27.9. 身份验证配置 复制链接链接已复制到粘贴板!
默认情况下,此组件使用 GoogleCredentials.getApplicationDefault () 获取凭证。通过将 authentication 选项设置为 false 来禁用此行为,在这种情况下,将在没有身份验证详情的情况下对 Google API 的请求进行。这只在针对模拟器开发时才需要。可以通过提供服务帐户密钥文件的路径来更改此行为。
27.10. 回滚和重新发送 复制链接链接已复制到粘贴板!
Google PubSub 的回滚取决于 Acknowledgement Deadline 的概念 - Google PubSub 希望接收确认的时间周期。如果未收到确认,则会通知消息。
Google 提供了一个 API 来扩展消息的截止时间。
因此,回滚实际上是一个带有零值的截止扩展 API 调用 - i.e. 期限现在就达到,消息可以恢复到下一个消费者。
通过将消息标头 GooglePubsubConstants.ACK_DEADLINE 设置为值(以秒为单位),可以将消息标头 GooglePubsubConstants.ACK_DEADLINE 设置为值来延迟消息重新发送。
27.11. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 google-pubsub 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-google-pubsub-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-google-pubsub-starter</artifactId>
</dependency>
组件支持 11 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.google-pubsub.authenticate | 与 PubSub 服务交互时使用凭证(在使用仿真器时不需要身份验证)。 | true | 布尔值 |
| camel.component.google-pubsub.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.google-pubsub.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.google-pubsub.enabled | 是否启用 google-pubsub 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.google-pubsub.endpoint | 用于本地 Pub/Sub 模拟器的端点。 | 字符串 | |
| camel.component.google-pubsub.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.google-pubsub.publisher-cache-size | 要缓存的最大制作者数。如果您有许多不同主题的制作者,则可以增加。 | 整数 | |
| camel.component.google-pubsub.publisher-cache-timeout | 每个制作者在缓存中保持活跃的毫秒。 | 整数 | |
| camel.component.google-pubsub.publisher-termination-timeout | 允许生成者终止的毫秒数。 | 整数 | |
| camel.component.google-pubsub.service-account-key | Service account key,可用作 PubSub publisher/subscriber 的凭证。默认情况下从 classpath 加载,但您可以使用 classpath:、file: 或 http: 前缀来加载来自不同系统的资源。 | 字符串 | |
| camel.component.google-pubsub.synchronous-pull-retryable-codes | 用于同步拉取的额外可重试错误代码列表。默认情况下,PubSub 客户端库重试 ABORTED、UNAVAILABLE、UNKNOWN。 | 字符串 |
第 28 章 HTTP 复制链接链接已复制到粘贴板!
仅支持生成者
HTTP 组件提供基于 HTTP 的端点,用于调用外部 HTTP 资源(作为客户端使用 HTTP 调用外部服务器)。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
28.1. URI 格式 复制链接链接已复制到粘贴板!
http:hostname[:port][/resourceUri][?options]
http:hostname[:port][/resourceUri][?options]
将默认使用端口 80 作为 HTTP,443 用于 HTTPS。
28.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
28.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
28.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
28.3. 组件选项 复制链接链接已复制到粘贴板!
HTTP 组件支持 37 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| cookieStore (producer) | 使用自定义 org.apache.http.client.CookieStore。默认情况下,使用 org.apache.http.impl.client.BasicCookieStore,这是仅内存的 Cookie 存储。请注意,如果 bridgeEndpoint=true,则 Cookie 存储被强制成为 noop cookie 存储,因为 Cookie 不应存储,因为我们只是桥接(例如作为代理)。 | CookieStore | |
| copyHeaders (producer) | 如果此选项为 true,则 IN 交换标头将根据复制策略复制到 OUT 交换标头中。把它设置为 false,允许仅包含 HTTP 响应中的标头(不传播 IN 标头)。 | true | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| responsePayloadStreamingThreshold (producer) | 这种阈值(以字节为单位)控制响应有效负载是否应该以字节阵列形式存储在内存中,还是基于流。把它设置为 -1 以始终使用流模式。 | 8192 | int |
| skipRequestHeaders (producer (advanced)) | 是否跳过将所有 Camel 标头映射为 HTTP 请求标头。如果 HTTP 请求中没有来自 Camel 标头的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| skipResponseHeaders (producer (advanced)) | 是否跳过将所有 HTTP 响应标头映射到 Camel 标头。如果没有 HTTP 标头需要的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| allowJavaSerializedObject (advanced) | 当请求使用 context-type=application/x-java-serialized-object 时,是否允许 java 序列化。默认情况下关闭。如果您启用此功能,则 Java 会将传入的数据从请求反序列化到 Java,这可能会存在潜在的安全风险。 | false | 布尔值 |
| authCachingDisabled (advanced) | 禁用身份验证方案缓存。 | false | 布尔值 |
| automaticRetriesDisabled (advanced) | 禁用自动请求恢复和重新执行。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| clientConnectionManager (advanced) | 使用自定义和共享 HttpClientConnectionManager 来管理连接。如果已经进行了配置,则这总是用于此组件创建的所有端点。 | HttpClientConnectionManager | |
| connectionsPerRoute (advanced) | 每个路由的最大连接数。 | 20 | int |
| connectionStateDisabled (advanced) | 禁用连接状态跟踪。 | false | 布尔值 |
| connectionTimeToLive (advanced) | 连接实时的时间(时间单位为毫秒),默认值始终保持处于活动状态。 | long | |
| ContentCompressionDisabled (advanced) | 禁用自动内容解压缩。 | false | 布尔值 |
| cookieManagementDisabled (advanced) | 禁用状态(cookie)管理。 | false | 布尔值 |
| defaultUserAgentDisabled (advanced) | 如果用户未提供,则禁用此构建器设置的默认用户代理。 | false | 布尔值 |
| httpBinding (advanced) | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。 | HttpBinding | |
| httpClientConfigurer (advanced) | 使用自定义 HttpClientConfigurer 执行要使用的 HttpClientConfigurer 的配置。 | HttpClientConfigurer | |
| httpConfiguration (advanced) | 使用共享 HttpConfiguration 作为基础配置。 | HttpConfiguration | |
| httpContext (advanced) | 在执行请求时使用自定义 org.apache.http.protocol.HttpContext。 | HttpContext | |
| maxTotalConnections (advanced) | 连接的最大数量。 | 200 | int |
| redirectHandlingDisabled (advanced) | 禁用自动重定向处理。 | false | 布尔值 |
| HeaderFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| proxyAuthDomain (proxy) | 要使用的代理身份验证域。 | 字符串 | |
| proxyAuthHost (proxy) | 代理身份验证主机。 | 字符串 | |
| proxyAuthMethod (proxy) | 要使用的代理验证方法。 Enum 值:
| 字符串 | |
| proxyAuthNtHost (proxy) | 用于 NTML 的代理身份验证域(工作站名称)。 | 字符串 | |
| proxyAuthPassword (proxy) | 代理身份验证密码。 | 字符串 | |
| proxyAuthPort (proxy) | 代理身份验证端口。 | 整数 | |
| proxyAuthUsername (proxy) | 代理身份验证用户名。 | 字符串 | |
| sslContextParameters (security) | 使用 SSLContext 参数配置安全性:重要: 每个 HttpComponent 仅支持一个 org.apache.camel.support.jsse.SSLContextParameters 的实例。如果您需要使用 2 个或更多不同的实例,则需要定义您需要的每个实例的新 HttpComponent。 | SSLContextParameters | |
| useGlobalSslContextParameters (security) | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
| x509HostnameVerifier (security) | 使用自定义 X509HostnameVerifier,如 DefaultHostnameVerifier 或 NoopHostnameVerifier。 | HostnameVerifier | |
| connectionRequestTimeout (timeout) | 从连接管理器请求连接时使用的超时时间(毫秒)。超时值为零被解释为无限超时。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | int |
| connectTimeout (timeout) | 决定连接建立前的超时时间(毫秒)。超时值为零被解释为无限超时。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | int |
| socketTimeout (timeout) | 以毫秒为单位定义套接字超时,这是等待数据的超时时间,不同,在两个连续数据包之间有最长不活跃周期。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | int |
28.4. 端点选项 复制链接链接已复制到粘贴板!
HTTP 端点使用 URI 语法进行配置:
http://httpUri
http://httpUri
使用以下路径和查询参数:
28.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| httpUri (common) | 需要 要调用的 HTTP 端点的 url。 | URI |
28.4.2. 查询参数(51 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| chunked (producer) | 如果此选项为 false,则 Servlet 将禁用 HTTP 流,并在响应上设置 content-length 标头。 | true | 布尔值 |
| disableStreamCache (common) | 确定来自 Servlet 的原始输入流是否缓存(Camel 会将流读取到内存/出口流到文件中,流缓存)缓存中。默认情况下,Camel 将缓存 Servlet 输入流,以支持多次读取它,以确保 Camel 可以从流检索所有数据。但是,当您需要访问原始流(如将其直接流传输到文件或其他持久性存储)时,您可以将此选项设置为 true。DefaultHttpBinding 将请求输入流复制到流缓存中,如果此选项为 false,则将其放在消息正文中,以支持多次读取流。如果您使用 Servlet 网桥/代理端点,请考虑启用此选项来提高性能,以防不需要多次读取消息有效负载。默认情况下,http producer 将缓存响应正文流。如果将此选项设置为 true,则制作者不会缓存响应正文流,而是将响应流用作消息正文。 | false | 布尔值 |
| HeaderFilterStrategy (common) | 使用自定义 HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| httpBinding (common (advanced)) | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。 | HttpBinding | |
| bridgeEndpoint (producer) | 如果选项为 true,HttpProducer 将忽略 Exchange.HTTP_URI 标头,并使用端点的 URI 进行请求。您还可以将 throwExceptionOnFailure 选项设置为 false,以便 HttpProducer 发送所有错误响应。 | false | 布尔值 |
| clearExpiredCookies (producer) | 在发送 HTTP 请求前,是否清除已过期的 Cookie。这样可确保 Cookie 存储不会通过添加新的 Cookie 在过期时被删除。如果组件禁用了 Cookie 管理,这个选项也会禁用。 | true | 布尔值 |
| connectionClose (producer) | 指定是否必须将 Connection Close 标头添加到 HTTP 请求中。默认情况下,connectionClose 为 false。 | false | 布尔值 |
| copyHeaders (producer) | 如果此选项为 true,则 IN 交换标头将根据复制策略复制到 OUT 交换标头中。把它设置为 false,允许仅包含 HTTP 响应中的标头(不传播 IN 标头)。 | true | 布尔值 |
| customHostHeader (producer) | 将自定义主机标头用于制作者。如果没有在查询中设置,将被忽略。当设置将覆盖从 url 中派生的主机标头。 | 字符串 | |
| httpMethod (producer) | 配置要使用的 HTTP 方法。如果设置,HttpMethod 标头将无法覆盖这个选项。 Enum 值:
| HttpMethods | |
| ignoreResponseBody (producer) | 如果此选项为 true,http producer 不会读取响应正文并缓存输入流。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| preserveHostHeader (producer) | 如果选项为 true,HttpProducer 会将 Host 标头设置为当前交换主机标头中包含的值,在您希望下游服务器接收的 Host 标头来反映上游客户端调用的 URL,这将允许使用 Host 标头为代理服务生成准确的 URL。 | false | 布尔值 |
| throwExceptionOnFailure (producer) | 在从远程服务器的响应失败时禁用抛出 HttpOperationFailedException 的选项。这样,无论 HTTP 状态代码是什么,您都可以获得所有响应。 | true | 布尔值 |
| transferException (producer) | 如果在消费者端启用和交换失败的处理,如果原因的例外在响应中以 application/x-java-serialized-object 内容类型发送回序列化。在制作者一侧,异常会被反序列化并抛出,而不是 HttpOperationFailedException。需要对原因的异常进行序列化。默认情况下关闭。如果您启用此功能,则 Java 会将传入的数据从请求反序列化到 Java,这可能会存在潜在的安全风险。 | false | 布尔值 |
| cookieHandler (producer (advanced)) | 配置 Cookie 处理程序来维护 HTTP 会话。 | CookieHandler | |
| cookieStore (producer (advanced)) | 使用自定义 CookieStore。默认情况下,使用 BasicCookieStore,这是仅内存的 Cookie 存储。请注意,如果 bridgeEndpoint=true,则 Cookie 存储被强制成为 noop cookie 存储,因为 Cookie 不应存储,因为我们只是桥接(例如作为代理)。如果设置了 CookieHandler,则 Cookie 存储也会强制成为 noop cookie 存储,因为 Cookie 处理由 CookieHandler 执行。 | CookieStore | |
| deleteWithBody (producer (advanced)) | HTTP DELETE 是否应该包含消息正文。默认情况下,HTTP DELETE 不包含任何 HTTP 正文。但是,在一些个别情况下,用户可能需要包含消息正文。 | false | 布尔值 |
| getWithBody (producer (advanced)) | HTTP GET 是否应该包含消息正文。默认情况下,HTTP GET 不包含任何 HTTP 正文。但是,在一些个别情况下,用户可能需要包含消息正文。 | false | 布尔值 |
| okStatusCodeRange (producer (advanced)) | 被视为成功响应的状态代码。该值包含。可以定义多个范围,用逗号分开,例如 200-204,209,301-304。每个范围都必须是一个数字或 from-to,其中包含横线。 | 200-299 | 字符串 |
| skipRequestHeaders (producer (advanced)) | 是否跳过将所有 Camel 标头映射为 HTTP 请求标头。如果 HTTP 请求中没有来自 Camel 标头的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| skipResponseHeaders (producer (advanced)) | 是否跳过将所有 HTTP 响应标头映射到 Camel 标头。如果没有 HTTP 标头需要的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| userAgent (producer (advanced)) | 设置自定义 HTTP User-Agent 请求标头: | 字符串 | |
| ClientBuilder (advanced) | 提供对此端点的制作者或消费者使用的新 RequestConfig 实例中使用的 http 客户端请求参数的访问权限。 | HttpClientBuilder | |
| clientConnectionManager (advanced) | 使用自定义 HttpClientConnectionManager 管理连接。 | HttpClientConnectionManager | |
| connectionsPerRoute (advanced) | 每个路由的最大连接数。 | 20 | int |
| httpClient (advanced) | 设置制作者要使用的自定义 HttpClient。 | HttpClient | |
| httpClientConfigurer (advanced) | 为生成者或消费者(如配置身份验证机制等)创建的新 HttpClient 实例注册自定义配置策略。 | HttpClientConfigurer | |
| httpClientOptions (advanced) | 使用映射中的键/值来配置 HttpClient: | Map | |
| httpContext (advanced) | 使用自定义 HttpContext 实例。 | HttpContext | |
| maxTotalConnections (advanced) | 连接的最大数量。 | 200 | int |
| useSystemProperties (advanced) | 使用系统属性作为配置的回退。 | false | 布尔值 |
| proxyAuthDomain (proxy) | 用于 NTML 的代理身份验证域。 | 字符串 | |
| proxyAuthHost (proxy) | 代理身份验证主机。 | 字符串 | |
| proxyAuthMethod (proxy) | 要使用的代理验证方法。 Enum 值:
| 字符串 | |
| proxyAuthNtHost (proxy) | 用于 NTML 的代理身份验证域(工作站名称)。 | 字符串 | |
| proxyAuthPassword (proxy) | 代理身份验证密码。 | 字符串 | |
| proxyAuthPort (proxy) | 代理身份验证端口。 | int | |
| proxyAuthScheme (proxy) | 要使用的代理身份验证方案。 Enum 值:
| 字符串 | |
| proxyAuthUsername (proxy) | 代理身份验证用户名。 | 字符串 | |
| proxyHost (proxy) | 要使用的代理主机名。 | 字符串 | |
| proxyPort (proxy) | 要使用的代理端口。 | int | |
| authDomain (security) | 与 NTML 一起使用的身份验证域。 | 字符串 | |
| authenticationPreemptive (security) | 如果此选项为 true,则 camel-http 会将抢占基本身份验证发送到服务器。 | false | 布尔值 |
| authHost (security) | 与 NTML 一起使用的身份验证主机。 | 字符串 | |
| authmethod (security) | 允许用作以逗号分隔的值列表的身份验证方法 Basic、Digest 或 NTLM。 | 字符串 | |
| authMethodPriority (security) | 要优先使用哪个身份验证方法,可以是 Basic、Digest 或 NTLM。 Enum 值:
| 字符串 | |
| authPassword (security) | 身份验证密码。 | 字符串 | |
| authUsername (security) | 身份验证用户名。 | 字符串 | |
| sslContextParameters (security) | 使用 SSLContext 参数配置安全性:重要: 每个 HttpComponent 仅支持一个 org.apache.camel.util.jsse.SSLContextParameters 的实例。如果您需要使用 2 个或更多不同的实例,则需要定义您需要的每个实例的新 HttpComponent。 | SSLContextParameters | |
| x509HostnameVerifier (security) | 使用自定义 X509HostnameVerifier,如 DefaultHostnameVerifier 或 NoopHostnameVerifier。 | HostnameVerifier |
28.5. 消息标头 复制链接链接已复制到粘贴板!
| Name | 类型 | 描述 |
|---|---|---|
|
|
| 要调用的 URI。将覆盖直接在端点上设置的现有 URI。此 uri 是要调用的 http 服务器的 uri。它与 Camel 端点 uri 不同,您可以在其中配置端点选项,如安全性等。此标头不支持,它只支持 http 服务器的 uri。 |
|
|
| 请求 URI 路径,标头将使用 HTTP_URI 构建请求 URI。 |
|
|
| URI 参数。将覆盖直接在端点上设置的现有 URI 参数。 |
|
|
| 来自外部服务器的 HTTP 响应代码。对于 OK,为 200。 |
|
|
| 来自外部服务器的 HTTP 响应文本。 |
|
|
| 字符编码。 |
|
|
|
HTTP 内容类型。在 IN 和 OUT 消息上设置,以提供内容类型,如 |
|
|
|
HTTP 内容编码。在 IN 和 OUT 消息上设置,以提供内容编码,如 |
28.6. 消息正文 复制链接链接已复制到粘贴板!
Camel 将从外部服务器的 HTTP 响应存储在 OUT 正文上。IN 消息中的所有标头都会被复制到 OUT 消息,因此在路由过程中保留标头。此外,Camel 会将 HTTP 响应标头和 OUT 消息标头添加到 OUT 消息标头中。
28.7. 使用系统属性 复制链接链接已复制到粘贴板!
当将 useSystemProperties 设置为 true 时,HTTP 客户端将查找以下系统属性,它将使用它:
- ssl.TrustManagerFactory.algorithm
- javax.net.ssl.trustStoreType
- javax.net.ssl.trustStore
- javax.net.ssl.trustStoreProvider
- javax.net.ssl.trustStorePassword
- java.home
- ssl.KeyManagerFactory.algorithm
- javax.net.ssl.keyStoreType
- javax.net.ssl.keyStore
- javax.net.ssl.keyStoreProvider
- javax.net.ssl.keyStorePassword
- http.proxyHost
- http.proxyPort
- http.nonProxyHosts
- http.keepAlive
- http.maxConnections
28.8. 响应代码 复制链接链接已复制到粘贴板!
Camel 将根据 HTTP 响应代码进行处理:
- 响应代码位于 100..299 之间,Camel 会将它视为成功响应。
-
响应代码位于 300..399 之间,Camel 会将它视为重定向响应,并将抛出带有信息的
HttpOperationFailedException。 -
响应代码为 400+,Camel 会将它视为外部服务器故障,并将抛出一个带有信息的
HttpOperationFailedException。
throwExceptionOnFailure 选项 throwExceptionOnFailure 可以设置为 false,以防止 HttpOperationFailedException 抛出失败响应代码。这可让您从远程服务器获取任何响应。
下面是一个示例。
28.9. 例外 复制链接链接已复制到粘贴板!
HttpOperationFailedException 异常包含以下信息:
- HTTP 状态代码
- HTTP 状态行(状态代码的文本)
- 重定向位置,如果服务器返回重定向
-
如果服务器提供正文作为响应,则以
java.lang.String形式响应正文
28.10. 使用哪个 HTTP 方法 复制链接链接已复制到粘贴板!
以下算法用于决定应使用什么 HTTP 方法:
1。使用作为端点配置提供的方法(httpMethod)。
2.使用标头中提供的方法(Exchange.HTTP_METHOD)。
3.GET 如果标头中提供了查询字符串。
4.如果端点配置了查询字符串,则 GET。
5.如果有 要发送的数据(任何人不是 null)。
6.否则,GET。
28.11. 如何访问 HttpServletRequest 和 HttpServletResponse 复制链接链接已复制到粘贴板!
您可以使用 Camel 类型转换器系统访问这两个
HttpServletRequest request = exchange.getIn().getBody(HttpServletRequest.class); HttpServletResponse response = exchange.getIn().getBody(HttpServletResponse.class);
HttpServletRequest request = exchange.getIn().getBody(HttpServletRequest.class);
HttpServletResponse response = exchange.getIn().getBody(HttpServletResponse.class);
您可以在 camel-jetty 或 camel-cxf 端点后从处理器获取请求和响应。
28.12. 配置 URI 来调用 复制链接链接已复制到粘贴板!
您可以直接组成端点 URI 设置 HTTP producer 的 URI。在以下路由中,Camel 将使用 HTTP 调用外部服务器 oldhost。
from("direct:start")
.to("http://oldhost");
from("direct:start")
.to("http://oldhost");
以及等效的 Spring 示例:
您可以通过在消息中添加带有键 Exchange.HTTP_URI 的标头来覆盖 HTTP 端点 URI。
from("direct:start")
.setHeader(Exchange.HTTP_URI, constant("http://newhost"))
.to("http://oldhost");
from("direct:start")
.setHeader(Exchange.HTTP_URI, constant("http://newhost"))
.to("http://oldhost");
在上例中,Camel 会调用 http://newhost/,尽管端点配置了 http://oldhost/。
如果 http 端点在网桥模式下工作,它将忽略 Exchange.HTTP_URI 的消息标头。
28.13. 配置 URI 参数 复制链接链接已复制到粘贴板!
http producer 支持将 URI 参数发送到 HTTP 服务器。URI 参数可以直接在端点 URI 或消息中使用键 Exchange.HTTP_QUERY 的标头设置。
from("direct:start")
.to("http://oldhost?order=123&detail=short");
from("direct:start")
.to("http://oldhost?order=123&detail=short");
或标头中提供的选项:
from("direct:start")
.setHeader(Exchange.HTTP_QUERY, constant("order=123&detail=short"))
.to("http://oldhost");
from("direct:start")
.setHeader(Exchange.HTTP_QUERY, constant("order=123&detail=short"))
.to("http://oldhost");
HTTP 组件提供了一种通过设置消息标头来设置 HTTP 请求方法的方法。下面是一个示例:
from("direct:start")
.setHeader(Exchange.HTTP_METHOD, constant(org.apache.camel.component.http.HttpMethods.POST))
.to("http://www.google.com")
.to("mock:results");
from("direct:start")
.setHeader(Exchange.HTTP_METHOD, constant(org.apache.camel.component.http.HttpMethods.POST))
.to("http://www.google.com")
.to("mock:results");
使用字符串常量可以编写方法稍短:
.setHeader("CamelHttpMethod", constant("POST"))
.setHeader("CamelHttpMethod", constant("POST"))
以及等效的 Spring 示例:
28.15. 使用客户端超时 - SO_TIMEOUT 复制链接链接已复制到粘贴板!
请参阅 HttpSOTimeoutTest 单元测试。
28.16. 配置代理 复制链接链接已复制到粘贴板!
HTTP 组件提供了一种配置代理的方法。
from("direct:start")
.to("http://oldhost?proxyAuthHost=www.myproxy.com&proxyAuthPort=80");
from("direct:start")
.to("http://oldhost?proxyAuthHost=www.myproxy.com&proxyAuthPort=80");
还支持通过 proxyAuthUsername 和 proxyAuthPassword 选项进行代理身份验证。
28.16.1. 使用 URI 之外的代理设置 复制链接链接已复制到粘贴板!
为避免系统属性冲突,您只能从 CamelContext 或 URI 设置代理配置。
Java DSL :
context.getGlobalOptions().put("http.proxyHost", "172.168.18.9");
context.getGlobalOptions().put("http.proxyPort", "8080");
context.getGlobalOptions().put("http.proxyHost", "172.168.18.9");
context.getGlobalOptions().put("http.proxyPort", "8080");
Spring XML
Camel 首先从 Java System 或 CamelContext 属性设置设置,然后设置端点代理选项(如果提供)。
因此,您可以使用端点选项覆盖系统属性。
另外,您还可以设置 http.proxyScheme 属性来明确配置要使用的方案。
28.17. 配置 charset 复制链接链接已复制到粘贴板!
如果使用 POST 发送数据,您可以使用 Exchange 属性配置 charset :
exchange.setProperty(Exchange.CHARSET_NAME, "ISO-8859-1");
exchange.setProperty(Exchange.CHARSET_NAME, "ISO-8859-1");
28.17.1. 带有调度的轮询示例 复制链接链接已复制到粘贴板!
这个示例每 10 秒轮询 Google 主页,并将页面写入文件 message.html :
from("timer://foo?fixedRate=true&delay=0&period=10000")
.to("http://www.google.com")
.setHeader(FileComponent.HEADER_FILE_NAME, "message.html")
.to("file:target/google");
from("timer://foo?fixedRate=true&delay=0&period=10000")
.to("http://www.google.com")
.setHeader(FileComponent.HEADER_FILE_NAME, "message.html")
.to("file:target/google");
28.17.2. 来自端点 URI 的 URI 参数 复制链接链接已复制到粘贴板!
在本例中,我们有完整的 URI 端点,它只是您在 Web 浏览器中输入的内容。可以使用 & 作为分隔符设置多个 URI 参数,就像您在 Web 浏览器中一样。Camel 不会在此处造成混淆。
// we query for Camel at the Google page
template.sendBody("http://www.google.com/search?q=Camel", null);
// we query for Camel at the Google page
template.sendBody("http://www.google.com/search?q=Camel", null);
28.17.3. 来自消息的 URI 参数 复制链接链接已复制到粘贴板!
Map headers = new HashMap();
headers.put(Exchange.HTTP_QUERY, "q=Camel&lr=lang_en");
// we query for Camel and English language at Google
template.sendBody("http://www.google.com/search", null, headers);
Map headers = new HashMap();
headers.put(Exchange.HTTP_QUERY, "q=Camel&lr=lang_en");
// we query for Camel and English language at Google
template.sendBody("http://www.google.com/search", null, headers);
在上面的标头值中,它不应 带有前缀 ?, 您可以像 & amp; char 一样分隔参数。
28.17.4. 获取响应代码 复制链接链接已复制到粘贴板!
您可以通过使用 Exchange.HTTP_RESPONSE_CODE 从 Out 消息标头中获取 HTTP 响应代码。
28.18. 禁用 Cookie 复制链接链接已复制到粘贴板!
要禁用 Cookie,您可以通过添加此 URI 选项:httpClient.cookieSpec=ignoreCookies来设置 HTTP 客户端来忽略 Cookie
28.19. 带有流消息正文的基本身份验证 复制链接链接已复制到粘贴板!
为了避免 NonRepeatableRequestException,您需要通过添加选项:authenticationPreemptive=true来进行 Preemptive Basic Authentication
28.20. 高级用法 复制链接链接已复制到粘贴板!
如果您需要对 HTTP 生成者进行更多控制,您应该使用 HttpComponent,您可以在其中设置各种类来为您提供自定义行为。
28.20.1. 为 HTTP 客户端设置 SSL 复制链接链接已复制到粘贴板!
使用 JSSE 配置工具
HTTP 组件通过 Camel JSSE 配置实用程序支持 SSL/TLS 配置。这个工具可显著减少您需要编写的组件特定代码数量,并在端点和组件级别进行配置。以下示例演示了如何将实用程序与 HTTP 组件一起使用。
组件的编程配置
基于 Spring DSL 的端点配置
直接配置 Apache HTTP 客户端
基本上 camel-http 组件基于 Apache HttpClient 构建。详情请参阅 SSL/TLS 自定义,或查看 org.apache.camel.component.http.HttpsServerTestSupport 单元测试基本类。
您还可以实施自定义 org.apache.camel.component.http.HttpClientConfigurer,以便在需要完全控制 http 客户端上进行一些配置。
但是,如果您只想 指定密钥存储和信任存储,您可以使用 Apache HTTP HttpClientConfigurer 来执行此操作,例如:
KeyStore keystore = ...;
KeyStore truststore = ...;
SchemeRegistry registry = new SchemeRegistry();
registry.register(new Scheme("https", 443, new SSLSocketFactory(keystore, "mypassword", truststore)));
KeyStore keystore = ...;
KeyStore truststore = ...;
SchemeRegistry registry = new SchemeRegistry();
registry.register(new Scheme("https", 443, new SSLSocketFactory(keystore, "mypassword", truststore)));
然后,您需要创建一个实施 HttpClientConfigurer 的类,并注册前一个密钥存储或信任存储的 https 协议。然后,从 camel 路由构建器类进行 hook:
HttpComponent httpComponent = getContext().getComponent("http", HttpComponent.class);
httpComponent.setHttpClientConfigurer(new MyHttpClientConfigurer());
HttpComponent httpComponent = getContext().getComponent("http", HttpComponent.class);
httpComponent.setHttpClientConfigurer(new MyHttpClientConfigurer());
如果使用 Spring DSL 进行此操作,您可以使用 URI 指定 HttpClientConfigurer。例如:
<bean id="myHttpClientConfigurer" class="my.https.HttpClientConfigurer"> </bean> <to uri="https://myhostname.com:443/myURL?httpClientConfigurer=myHttpClientConfigurer"/>
<bean id="myHttpClientConfigurer"
class="my.https.HttpClientConfigurer">
</bean>
<to uri="https://myhostname.com:443/myURL?httpClientConfigurer=myHttpClientConfigurer"/>
只要您实施 HttpClientConfigurer,并配置密钥存储和信任存储,它将可以正常工作。
使用 HTTPS 验证 getchas
最终用户报告他在使用 HTTPS 进行身份验证时存在问题。最终,通过提供自定义配置的 org.apache.http.protocol.HttpContext 来解决这个问题:
- 1.为 HttpContexts 创建(Spring)工厂:
- 2.在 Spring 应用程序上下文文件中声明 HttpContext:
<bean id="myHttpContext" factory-bean="httpContextFactory" factory-method="getObject"/>
<bean id="myHttpContext" factory-bean="httpContextFactory" factory-method="getObject"/>
- 3.引用 http URL 中的上下文:
<to uri="https://myhostname.com:443/myURL?httpContext=myHttpContext"/>
<to uri="https://myhostname.com:443/myURL?httpContext=myHttpContext"/>
使用不同的 SSLContext 参数
HTTP 组件只支持每个组件的一个 org.apache.camel.support.jsse.SSLContextParameters 实例。如果您需要使用 2 个或更多不同的实例,则需要设置多个 HTTP 组件,如下所示。在这里,我们有 2 个组件,各自使用自己的 sslContextParameters 属性实例。
28.21. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 http 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-http-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-http-starter</artifactId>
</dependency>
组件支持 38 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.http.allow-java-serialized-object | 当请求使用 context-type=application/x-java-serialized-object 时,是否允许 java 序列化。默认情况下关闭。如果您启用此功能,则 Java 会将传入的数据从请求反序列化到 Java,这可能会存在潜在的安全风险。 | false | 布尔值 |
| camel.component.http.auth-caching-disabled | 禁用身份验证方案缓存。 | false | 布尔值 |
| camel.component.http.automatic-retries-disabled | 禁用自动请求恢复和重新执行。 | false | 布尔值 |
| camel.component.http.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.http.client-connection-manager | 使用自定义和共享 HttpClientConnectionManager 来管理连接。如果已经进行了配置,则这总是用于此组件创建的所有端点。选项是 org.apache.http.conn.HttpClientConnectionManager 类型。 | HttpClientConnectionManager | |
| camel.component.http.connect-timeout | 决定连接建立前的超时时间(毫秒)。超时值为零被解释为无限超时。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | 整数 |
| camel.component.http.connection-request-timeout | 从连接管理器请求连接时使用的超时时间(毫秒)。超时值为零被解释为无限超时。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | 整数 |
| camel.component.http.connection-state-disabled | 禁用连接状态跟踪。 | false | 布尔值 |
| camel.component.http.connection-time-to-live | 连接实时的时间(时间单位为毫秒),默认值始终保持处于活动状态。 | Long | |
| camel.component.http.connections-per-route | 每个路由的最大连接数。 | 20 | 整数 |
| camel.component.http.content-compression-disabled | 禁用自动内容解压缩。 | false | 布尔值 |
| camel.component.http.cookie-management-disabled | 禁用状态(cookie)管理。 | false | 布尔值 |
| camel.component.http.cookie-store | 使用自定义 org.apache.http.client.CookieStore。默认情况下,使用 org.apache.http.impl.client.BasicCookieStore,这是仅内存的 Cookie 存储。请注意,如果 bridgeEndpoint=true,则 Cookie 存储被强制成为 noop cookie 存储,因为 Cookie 不应存储,因为我们只是桥接(例如作为代理)。选项是 org.apache.http.client.CookieStore 类型。 | CookieStore | |
| camel.component.http.copy-headers | 如果此选项为 true,则 IN 交换标头将根据复制策略复制到 OUT 交换标头中。把它设置为 false,允许仅包含 HTTP 响应中的标头(不传播 IN 标头)。 | true | 布尔值 |
| camel.component.http.default-user-agent-disabled | 如果用户未提供,则禁用此构建器设置的默认用户代理。 | false | 布尔值 |
| camel.component.http.enabled | 是否启用 http 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.http.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.http.http-binding | 使用自定义 HttpBinding 控制 Camel 消息和 HttpClient 之间的映射。选项是 org.apache.camel.http.common.HttpBinding 类型。 | HttpBinding | |
| camel.component.http.http-client-configurer | 使用自定义 HttpClientConfigurer 执行要使用的 HttpClientConfigurer 的配置。选项是 org.apache.camel.component.http.HttpClientConfigurer 类型。 | HttpClientConfigurer | |
| camel.component.http.http-configuration | 使用共享 HttpConfiguration 作为基础配置。选项是 org.apache.camel.http.common.HttpConfiguration 类型。 | HttpConfiguration | |
| camel.component.http.http-context | 在执行请求时使用自定义 org.apache.http.protocol.HttpContext。选项是一个 org.apache.http.protocol.HttpContext 类型。 | HttpContext | |
| camel.component.http.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.http.max-total-connections | 连接的最大数量。 | 200 | 整数 |
| camel.component.http.proxy-auth-domain | 要使用的代理身份验证域。 | 字符串 | |
| camel.component.http.proxy-auth-host | 代理身份验证主机。 | 字符串 | |
| camel.component.http.proxy-auth-method | 要使用的代理验证方法。 | 字符串 | |
| camel.component.http.proxy-auth-nt-host | 用于 NTML 的代理身份验证域(工作站名称)。 | 字符串 | |
| camel.component.http.proxy-auth-password | 代理身份验证密码。 | 字符串 | |
| camel.component.http.proxy-auth-port | 代理身份验证端口。 | 整数 | |
| camel.component.http.proxy-auth-username | 代理身份验证用户名。 | 字符串 | |
| camel.component.http.redirect-handling-disabled | 禁用自动重定向处理。 | false | 布尔值 |
| camel.component.http.response-payload-streaming-threshold | 这种阈值(以字节为单位)控制响应有效负载是否应该以字节阵列形式存储在内存中,还是基于流。把它设置为 -1 以始终使用流模式。 | 8192 | 整数 |
| camel.component.http.skip-request-headers | 是否跳过将所有 Camel 标头映射为 HTTP 请求标头。如果 HTTP 请求中没有来自 Camel 标头的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| camel.component.http.skip-response-headers | 是否跳过将所有 HTTP 响应标头映射到 Camel 标头。如果没有 HTTP 标头需要的数据,这可以避免为 JVM 垃圾收集器解析许多对象分配的开销。 | false | 布尔值 |
| camel.component.http.socket-timeout | 以毫秒为单位定义套接字超时,这是等待数据的超时时间,不同,在两个连续数据包之间有最长不活跃周期。超时值为零被解释为无限超时。负值被解释为未定义(系统默认值)。 | -1 | 整数 |
| camel.component.http.ssl-context-parameters | 使用 SSLContext 参数配置安全性:重要: 每个 HttpComponent 仅支持一个 org.apache.camel.support.jsse.SSLContextParameters 的实例。如果您需要使用 2 个或更多不同的实例,则需要定义您需要的每个实例的新 HttpComponent。选项是 org.apache.camel.support.jsse.SSLContextParameters 类型。 | SSLContextParameters | |
| camel.component.http.use-global-ssl-context-parameters | 启用使用全局 SSL 上下文参数。 | false | 布尔值 |
| camel.component.http.x509-hostname-verifier | 使用自定义 X509HostnameVerifier,如 DefaultHostnameVerifier 或 NoopHostnameVerifier。选项是 javax.net.ssl.HostnameVerifier 类型。 | HostnameVerifier |
第 29 章 Infinispan 复制链接链接已复制到粘贴板!
支持生成者和消费者
此组件允许您使用 Hot Rod procol 与 Infinispan 分布式数据平面/缓存交互。Infinispan 是一个高度可扩展的、高度可用的键/值数据存储和使用 Java 编写的数据网格平台。
如果使用 Maven,您必须在 pom.xml 中添加以下依赖项:
29.1. URI 格式 复制链接链接已复制到粘贴板!
infinispan://cacheName?[options]
infinispan://cacheName?[options]
制作者允许使用 HotRod 协议向远程缓存发送消息。消费者允许使用 HotRod 协议从远程缓存中侦听事件。
29.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
29.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
29.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
29.3. 组件选项 复制链接链接已复制到粘贴板!
Infinispan 组件支持 26 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| configuration (common) | 组件配置. | InfinispanRemoteConfiguration | |
| hosts (common) | 指定 Infinispan 实例上缓存的主机。 | 字符串 | |
| queryBuilder (common) | 指定查询构建器。 | InfinispanQueryBuilder | |
| secure (common) | 定义我们是否连接到安全的 Infinispan 实例。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| customListener (consumer) | 如果提供,返回使用中的自定义监听程序。 | InfinispanRemoteCustomListener | |
| eventTypes (consumer) | 指定要由 consumer.Multiple 事件注册的事件类型集合,可以使用逗号分隔。可能的事件类型有:CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER。 | 字符串 | |
| defaultValue (producer) | 为某些制作者操作设置特定的默认值。 | 对象 | |
| key (producer) | 为制作者操作设置特定的密钥。 | 对象 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| oldValue (producer) | 为某些制作者操作设置特定的旧值。 | 对象 | |
| operation (producer) | 要执行的操作。 Enum 值:
| PUT | InfinispanOperation |
| value (producer) | 为制作者操作设置特定值。 | 对象 | |
| 密码 (安全) | 定义用于访问 infinispan 实例的密码。 | 字符串 | |
| saslMechanism (security) | 定义 SASL 机制来访问 infinispan 实例。 | 字符串 | |
| SecurityRealm ( security) | 定义访问 infinispan 实例的安全域。 | 字符串 | |
| securityServerName (security) | 定义用于访问 infinispan 实例的安全服务器名称。 | 字符串 | |
| 用户名 (安全) | 定义用于访问 infinispan 实例的用户名。 | 字符串 | |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| cacheContainer (advanced) | Autowired 指定要连接的缓存容器。 | RemoteCacheManager | |
| cacheContainerConfiguration (advanced) | Autowired CacheContainer 配置。如果没有定义 cacheContainer,则使用。 | Configuration | |
| configurationProperties (advanced) | 为 CacheManager 实施特定属性。 | Map | |
| ConfigurationUri (advanced) | CacheManager 的实施特定 URI。 | 字符串 | |
| 标记 (advanced) | 默认情况下,在每个缓存调用时应用以逗号分隔的 org.infinispan.client.hotrod.Flag 列表。 | 字符串 | |
| remappingFunction (advanced) | 设置要在计算操作中使用的特定 remappingFunction。 | BiFunction | |
| resultHeader (advanced) | 将操作结果存储在标头而不是消息正文中。默认情况下,结果 == null,查询结果存储在消息正文中,消息正文中的任何现有内容都会被丢弃。如果设置了 resultHeader,则该值将用作存储查询结果的标头名称,并保留原始消息正文。这个值可以被名为:CamelInfinispanOperationResultHeader 的消息标头覆盖。 | 字符串 |
29.4. 端点选项 复制链接链接已复制到粘贴板!
Infinispan 端点使用 URI 语法进行配置:
infinispan:cacheName
infinispan:cacheName
使用以下路径和查询参数:
29.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| cacheName (common) | 必需使用的缓存的名称。使用 current 来使用当前配置的缓存管理器中的现有缓存名称。或者,将 default 用于默认缓存管理器名称。 | 字符串 |
29.4.2. 查询参数(26 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| hosts (common) | 指定 Infinispan 实例上缓存的主机。 | 字符串 | |
| queryBuilder (common) | 指定查询构建器。 | InfinispanQueryBuilder | |
| secure (common) | 定义我们是否连接到安全的 Infinispan 实例。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| customListener (consumer) | 如果提供,返回使用中的自定义监听程序。 | InfinispanRemoteCustomListener | |
| eventTypes (consumer) | 指定要由 consumer.Multiple 事件注册的事件类型集合,可以使用逗号分隔。可能的事件类型有:CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER。 | 字符串 | |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| defaultValue (producer) | 为某些制作者操作设置特定的默认值。 | 对象 | |
| key (producer) | 为制作者操作设置特定的密钥。 | 对象 | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| oldValue (producer) | 为某些制作者操作设置特定的旧值。 | 对象 | |
| operation (producer) | 要执行的操作。 Enum 值:
| PUT | InfinispanOperation |
| value (producer) | 为制作者操作设置特定值。 | 对象 | |
| 密码 (安全) | 定义用于访问 infinispan 实例的密码。 | 字符串 | |
| saslMechanism (security) | 定义 SASL 机制来访问 infinispan 实例。 | 字符串 | |
| SecurityRealm ( security) | 定义访问 infinispan 实例的安全域。 | 字符串 | |
| securityServerName (security) | 定义用于访问 infinispan 实例的安全服务器名称。 | 字符串 | |
| 用户名 (安全) | 定义用于访问 infinispan 实例的用户名。 | 字符串 | |
| cacheContainer (advanced) | Autowired 指定要连接的缓存容器。 | RemoteCacheManager | |
| cacheContainerConfiguration (advanced) | Autowired CacheContainer 配置。如果没有定义 cacheContainer,则使用。 | Configuration | |
| configurationProperties (advanced) | 为 CacheManager 实施特定属性。 | Map | |
| ConfigurationUri (advanced) | CacheManager 的实施特定 URI。 | 字符串 | |
| 标记 (advanced) | 默认情况下,在每个缓存调用时应用以逗号分隔的 org.infinispan.client.hotrod.Flag 列表。 | 字符串 | |
| remappingFunction (advanced) | 设置要在计算操作中使用的特定 remappingFunction。 | BiFunction | |
| resultHeader (advanced) | 将操作结果存储在标头而不是消息正文中。默认情况下,结果 == null,查询结果存储在消息正文中,消息正文中的任何现有内容都会被丢弃。如果设置了 resultHeader,则该值将用作存储查询结果的标头名称,并保留原始消息正文。这个值可以被名为:CamelInfinispanOperationResultHeader 的消息标头覆盖。 | 字符串 |
29.5. Camel Operations 复制链接链接已复制到粘贴板!
本节列出所有可用的操作及其标头信息。
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.PUT | 将键/值对放在缓存中,可选使用过期 |
| InfinispanOperation.PUTASYNC | 异步将键/值对放在缓存中,可选地放置过期 |
| InfinispanOperation.PUTIFABSENT | 如果不存在,在缓存中放置一个键/值对,可以选择使用过期 |
| InfinispanOperation.PUTIFABSENTASYNC | 如果一个键/值对(如果不存在)在缓存中异步放置一个键/值对,可以选择使用过期 |
所需的标头 :
- CamelInfinispanKey
- CamelInfinispanValue
可选标头 :
- CamelInfinispanLifespanTime
- CamelInfinispanLifespanTimeUnit
- CamelInfinispanMaxIdleTime
- CamelInfinispanMaxIdleTimeUnit
结果标头 :
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.PUTALL | 在缓存中添加多个条目,可选过期 |
| CamelInfinispanOperation.PUTALLASYNC | 异步向缓存添加多个条目,可选使用过期 |
所需的标头 :
- CamelInfinispanMap
可选标头 :
- CamelInfinispanLifespanTime
- CamelInfinispanLifespanTimeUnit
- CamelInfinispanMaxIdleTime
- CamelInfinispanMaxIdleTimeUnit
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.GET | 从缓存中检索与特定键关联的值 |
| InfinispanOperation.GETORDEFAULT | 从缓存中检索与特定键关联的值或默认值 |
所需的标头 :
- CamelInfinispanKey
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.CONTAINSKEY | 确定缓存是否包含特定密钥 |
所需的标头
- CamelInfinispanKey
结果标头
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.CONTAINSVALUE | 确定缓存是否包含特定值 |
所需的标头 :
- CamelInfinispanKey
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.REMOVE | 从缓存中删除条目,只有值与给定值匹配时(可选) |
| InfinispanOperation.REMOVEASYNC | 异步从缓存中删除条目,只有值与给定值匹配时(可选) |
所需的标头 :
- CamelInfinispanKey
可选标头 :
- CamelInfinispanValue
结果标头 :
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.REPLACE | 有条件地替换缓存中的条目,可选地替换为过期 |
| InfinispanOperation.REPLACEASYNC | 异步地替换缓存中的条目,可以选择使用过期 |
所需的标头 :
- CamelInfinispanKey
- CamelInfinispanValue
- CamelInfinispanOldValue
可选标头 :
- CamelInfinispanLifespanTime
- CamelInfinispanLifespanTimeUnit
- CamelInfinispanMaxIdleTime
- CamelInfinispanMaxIdleTimeUnit
结果标头 :
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.CLEAR | 清除缓存 |
| InfinispanOperation.CLEARASYNC | 异步清除缓存 |
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.SIZE | 返回缓存中的条目数 |
结果标头
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.STATS | 返回有关缓存的统计信息 |
结果标头 :
- CamelInfinispanOperationResult
| 操作名称 | 描述 |
|---|---|
| InfinispanOperation.QUERY | 对缓存执行查询 |
所需的标头 :
- CamelInfinispanQueryBuilder
结果标头 :
- CamelInfinispanOperationResult
写入方法,如 put (key, value)和 remove (key)默认不会返回之前的值。
29.6. 消息标头 复制链接链接已复制到粘贴板!
| Name | 默认值 | 类型 | Context | 描述 |
|---|---|---|---|---|
| CamelInfinispanCacheName |
| 字符串 | 共享 | 参与操作或事件的缓存。 |
| CamelInfinispanOperation |
| InfinispanOperation | 制作者 | 要执行的操作。 |
| CamelInfinispanMap |
| Map | 制作者 | CamelInfinispanOperationPutAll 操作时要使用的 Map |
| CamelInfinispanKey |
| 对象 | 共享 | 执行操作的密钥或生成事件的密钥。 |
| CamelInfinispanValue |
| 对象 | 制作者 | 用于操作的值。 |
| CamelInfinispanEventType |
| 字符串 | 消费者 | 接收的事件的类型。 |
| CamelInfinispanLifespanTime |
| long | 制作者 | 缓存内某个值的 Lifespan 时间。负值解释为 infinity。 |
| CamelInfinispanTimeUnit |
| 字符串 | 制作者 | 条目生命周期的时间范围。 |
| CamelInfinispanMaxIdleTime |
| long | 制作者 | 在将条目被视为过期前允许闲置的最长时间。 |
| CamelInfinispanMaxIdleTimeUnit |
| 字符串 | 制作者 | 条目 Max Idle Time 的时间单位。 |
| CamelInfinispanQueryBuilder | null | InfinispanQueryBuilder | 制作者 | 用于 QUERY 命令的 QueryBuilde,如果没有显示命令默认为 InifinispanConfiguration's。 |
| CamelInfinispanOperationResultHeader | null | 字符串 | 制作者 | 将操作结果存储在标头而不是消息正文中 |
29.7. 例子 复制链接链接已复制到粘贴板!
将键/值放入命名缓存中:
from("direct:start") .setHeader(InfinispanConstants.OPERATION).constant(InfinispanOperation.PUT) (1) .setHeader(InfinispanConstants.KEY).constant("123") (2) .to("infinispan:myCacheName&cacheContainer=#cacheContainer"); (3)from("direct:start") .setHeader(InfinispanConstants.OPERATION).constant(InfinispanOperation.PUT) (1) .setHeader(InfinispanConstants.KEY).constant("123") (2) .to("infinispan:myCacheName&cacheContainer=#cacheContainer"); (3)Copy to Clipboard Copied! Toggle word wrap Toggle overflow 其中,
- 1 - 设置要执行的操作
- 2 - 设置用于识别缓存中元素的键
3 - 使用 registry 中配置的 cache manager
cacheContainer将元素放在名为myCacheName的缓存中可以在条目过期前配置生命周期和/或空闲时间,并从缓存中被驱除,例如:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
其中,
- 1 - 设置条目的生命周期
- 2 - 为生命周期设置时间单位
查询
域对象的 .proto 描述符必须注册到远程 Data Grid 服务器,请参阅官方 Infinispan 文档中的 Remote Query 示例。
自定义 Listeners
from("infinispan://?cacheContainer=#cacheManager&customListener=#myCustomListener")
.to("mock:result");
from("infinispan://?cacheContainer=#cacheManager&customListener=#myCustomListener")
.to("mock:result");
myCustomListener 实例必须存在,Camel 应该可以从 Registry 中查找它。建议用户扩展 org.apache.camel.component.infinispan.remote.InfinispanRemoteCustomListener 类,并使用 @ClientListener 注解生成的类,该类可以在软件包 org.infinispan.client.hotrod.annotation 中找到。
29.8. 使用基于 Infinispan 的幂等存储库 复制链接链接已复制到粘贴板!
在本小节中,我们将使用基于 Infinispan 的幂等存储库。
Java 示例
其中,
- 1 - 配置缓存
- 2 - 配置存储库 Bean
- 3 - 将存储库设置为路由
XML 示例
其中,
- 1 - 设置仓库要使用的缓存名称
- 2 - 配置存储库 Bean
- 3 - 将存储库设置为路由
29.9. 使用基于 Infinispan 的聚合存储库 复制链接链接已复制到粘贴板!
在本小节中,我们将使用基于 Infinispan 的聚合存储库。
Java 示例
其中,
- 1 - 配置缓存
- 2 - 创建存储库 Bean
- 3 - 将存储库设置为路由
XML 示例
其中,
- 1 - 设置仓库要使用的缓存名称
- 2 - 配置存储库 Bean
- 3 - 将存储库设置为路由
随着 Infinispan 11 的发布,需要在创建的任何缓存上设置编码配置。这对于消耗事件也至关重要。如需更多信息,请参阅官方 Infinispan 文档中的 Data Encoding 和 MediaTypes。
29.10. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 infinispan 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-infinispan-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-infinispan-starter</artifactId>
</dependency>
组件支持 23 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.infinispan.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.infinispan.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.infinispan.cache-container | 指定要连接的缓存容器。选项是一个 org.infinispan.client.hotrod.RemoteCacheManager 类型。 | RemoteCacheManager | |
| camel.component.infinispan.cache-container-configuration | CacheContainer 配置。如果没有定义 cacheContainer,则使用。选项是一个 org.infinispan.client.hotrod.configuration.Configuration 类型。 | Configuration | |
| camel.component.infinispan.configuration | 组件配置.选项是 org.apache.camel.component.infinispan.remote.InfinispanRemoteConfiguration 类型。 | InfinispanRemoteConfiguration | |
| camel.component.infinispan.configuration-properties | 为 CacheManager 实施特定属性。 | Map | |
| camel.component.infinispan.configuration-uri | CacheManager 的实施特定 URI。 | 字符串 | |
| camel.component.infinispan.custom-listener | 如果提供,返回使用中的自定义监听程序。选项是 org.apache.camel.component.infinispan.remote.InfinispanRemoteCustomListener 类型。 | InfinispanRemoteCustomListener | |
| camel.component.infinispan.enabled | 是否启用 infinispan 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.infinispan.event-types | 指定要由 consumer.Multiple 事件注册的事件类型集合,可以使用逗号分隔。可能的事件类型有:CLIENT_CACHE_ENTRY_CREATED, CLIENT_CACHE_ENTRY_MODIFIED, CLIENT_CACHE_ENTRY_REMOVED, CLIENT_CACHE_ENTRY_EXPIRED, CLIENT_CACHE_FAILOVER。 | 字符串 | |
| camel.component.infinispan.flags | 默认情况下,在每个缓存调用时应用以逗号分隔的 org.infinispan.client.hotrod.Flag 列表。 | 字符串 | |
| camel.component.infinispan.hosts | 指定 Infinispan 实例上缓存的主机。 | 字符串 | |
| camel.component.infinispan.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.infinispan.operation | 要执行的操作。 | InfinispanOperation | |
| camel.component.infinispan.password | 定义用于访问 infinispan 实例的密码。 | 字符串 | |
| camel.component.infinispan.query-builder | 指定查询构建器。选项是 org.apache.camel.component.infinispan.InfinispanQueryBuilder 类型。 | InfinispanQueryBuilder | |
| camel.component.infinispan.remapping-function | 设置要在计算操作中使用的特定 remappingFunction。选项是一个 java.util.function.BiFunction 类型。 | BiFunction | |
| camel.component.infinispan.result-header | 将操作结果存储在标头而不是消息正文中。默认情况下,结果 == null,查询结果存储在消息正文中,消息正文中的任何现有内容都会被丢弃。如果设置了 resultHeader,则该值将用作存储查询结果的标头名称,并保留原始消息正文。这个值可以被名为:CamelInfinispanOperationResultHeader 的消息标头覆盖。 | 字符串 | |
| camel.component.infinispan.sasl-mechanism | 定义 SASL 机制来访问 infinispan 实例。 | 字符串 | |
| camel.component.infinispan.secure | 定义我们是否连接到安全的 Infinispan 实例。 | false | 布尔值 |
| camel.component.infinispan.security-realm | 定义访问 infinispan 实例的安全域。 | 字符串 | |
| camel.component.infinispan.security-server-name | 定义用于访问 infinispan 实例的安全服务器名称。 | 字符串 | |
| camel.component.infinispan.username | 定义用于访问 infinispan 实例的用户名。 | 字符串 |
第 30 章 Jira 复制链接链接已复制到粘贴板!
支持生成者和消费者
JIRA 组件通过封装 Atlassian 的 REST Java Client for JIRA 来与 JIRA API 交互。它目前为新的问题和新评论提供轮询。它还能够创建新问题、添加评论、更改问题、添加/删除监视者、添加附加并转换问题的状态。
此端点依赖于简单的轮询,而不是 webhook。原因包括:
- 可靠性/稳定问题
- 我们轮询的有效负载类型通常并不大(另外,API 中提供了分页)
- 需要支持在 Webhook 失败时无法公开访问的应用程序
请注意,JIRA API 非常频繁地加快。因此,此组件可轻松扩展以提供额外的交互。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-jira</artifactId>
<version>${camel-version}</version>
</dependency>
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-jira</artifactId>
<version>${camel-version}</version>
</dependency>
30.1. URI 格式 复制链接链接已复制到粘贴板!
jira://type[?options]
jira://type[?options]
JIRA 类型接受以下操作:
对于消费者:
- newIssues:仅检索路由启动后的新问题
- newComments:仅检索路由启动后的新注释
- watchUpdates :仅根据提供的 jql 检索更新的字段/发布
对于制作者:
- addIssue:添加一个问题
- addComment:在给定问题中添加注释
- attach :在给定问题中添加附加
- deleteIssue:删除给定的问题
- updateIssue: 更新给定问题的字段
- ConvertIssue:转换给定问题的状态
- watchers:给定问题的添加/删除监视者
因为 JIRA 完全自定义,您必须确保项目和工作流存在字段 ID,因为它们可以在不同的 JIRA 服务器之间有所变化。
30.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
30.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
30.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
30.3. 组件选项 复制链接链接已复制到粘贴板!
JIRA 组件支持 12 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| delay (common) | 下一次轮询的时间(毫秒)。 | 6000 | 整数 |
| jiraUrl (common) | 需要 JIRA 服务器 url,例如: | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| 配置 (高级) | 使用共享基础 jira 配置。 | JiraConfiguration | |
| accessToken (security) | (仅限OAuth)由 JIRA 服务器生成的访问令牌。 | 字符串 | |
| consumerKey (security) | (仅限OAuth)来自 JIRA 设置的消费者密钥。 | 字符串 | |
| 密码 (安全) | (仅限基本身份验证)向 JIRA 服务器进行身份验证的密码。仅在使用用户名基本身份验证时使用。 | 字符串 | |
| PrivateKey ( security) | (仅限OAuth)客户端生成的私钥,以加密与服务器的对话。 | 字符串 | |
| 用户名 (安全) | (仅限基本身份验证)向 JIRA 服务器进行身份验证的用户名。仅在 JIRA 服务器上没有启用 OAuth 时使用。如果同时设置了 username 和 OAuth 令牌参数,则不要设置用户名和 OAuth 令牌参数,则用户名基本身份验证将具有优先权。 | 字符串 | |
| ValidationCode (security) | (仅限OAuth)从授权过程的第一个步骤中生成的 JIRA 验证代码。 | 字符串 |
30.4. 端点选项 复制链接链接已复制到粘贴板!
JIRA 端点使用 URI 语法进行配置:
jira:type
jira:type
使用以下路径和查询参数:
30.4.1. 路径参数(1 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| type (common) | 需要 执行的操作。消费者:newIssues、NewComments.producers: AddIssue, AttachFile, DeleteIssue, TransitionIssue, UpdateIssue, Watchers.如需更多信息,请参阅本类 javadoc 描述。 Enum 值:
| JiraType |
30.4.2. 查询参数 (16 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| delay (common) | 下一次轮询的时间(毫秒)。 | 6000 | 整数 |
| jiraUrl (common) | 需要 JIRA 服务器 url,例如: | 字符串 | |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| jql (consumer) | JQL 是 JIRA 的查询语言,允许您检索您想要的数据。例如,jql=project=MyProject where MyProject 是 JIRA 中的产品密钥。使用 RAW ()并设置 JQL 以防止 camel 解析它非常重要,例如: RAW (project in (MYP, COM) AND resolution = Unresolved)。 | 字符串 | |
| maxResults (consumer) | 要搜索的最大问题数。 | 50 | 整数 |
| sendOnlyUpdatedField (consumer) | 仅发送交换正文或问题对象中更改的字段的指标。默认情况下,使用者仅发送更改的字段。 | true | 布尔值 |
| watchedFields (consumer) | 监视更改的以逗号分隔的字段列表。status,Priority 是默认值。 | status,Priority | 字符串 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| accessToken (security) | (仅限OAuth)由 JIRA 服务器生成的访问令牌。 | 字符串 | |
| consumerKey (security) | (仅限OAuth)来自 JIRA 设置的消费者密钥。 | 字符串 | |
| 密码 (安全) | (仅限基本身份验证)向 JIRA 服务器进行身份验证的密码。仅在使用用户名基本身份验证时使用。 | 字符串 | |
| PrivateKey ( security) | (仅限OAuth)客户端生成的私钥,以加密与服务器的对话。 | 字符串 | |
| 用户名 (安全) | (仅限基本身份验证)向 JIRA 服务器进行身份验证的用户名。仅在 JIRA 服务器上没有启用 OAuth 时使用。如果同时设置了 username 和 OAuth 令牌参数,则不要设置用户名和 OAuth 令牌参数,则用户名基本身份验证将具有优先权。 | 字符串 | |
| ValidationCode (security) | (仅限OAuth)从授权过程的第一个步骤中生成的 JIRA 验证代码。 | 字符串 |
30.5. 客户端工厂 复制链接链接已复制到粘贴板!
您可以将 JIRARestClientFactory 与 registry 中名为 JIRARestClientFactory 的绑定,使其自动在 JIRA 端点中设置。
30.6. 身份验证 复制链接链接已复制到粘贴板!
Camel-jira 支持 基本身份验证 和 OAuth 3 委托身份验证。
我们建议尽可能使用 OAuth,因为它为您的用户和系统提供最佳安全性。
30.6.1. 基本身份验证要求: 复制链接链接已复制到粘贴板!
- 用户名和密码
30.6.2. OAuth 身份验证要求: 复制链接链接已复制到粘贴板!
按照 JIRA OAuth 文档中的 教程生成客户端私钥、使用者密钥、验证代码和访问令牌。
- 在您的系统上本地生成的私钥。
- 一个验证代码,由 JIRA 服务器生成。
- consumer 键,在 JIRA 服务器设置中设置。
- 由 JIRA 服务器生成的访问令牌。
30.7. JQL 复制链接链接已复制到粘贴板!
JQL URI 选项都由两个使用者端点使用。理论上,"project key"等项目可以是 URI 选项本身。但是,通过要求使用 JQL,消费者变得更灵活且强大。
至少,消费者需要以下内容:
jira://[type]?[required options]&jql=project=[project key]
jira://[type]?[required options]&jql=project=[project key]
需要注意的是 newIssues 消费者将自动将 JQL 设置为:
-
将
ORDER BY 键 desc附加到 JQL -
prepend
id > latestIssueId以检索在 camel 路由启动后添加的问题。
这是为了优化启动处理,而不必对项目中的每一 个问题进行索引。
另一个备注是,newComments 消费者也必须索引项目中每个单个问题 和注释。因此,对于大型项目,尽可能优化 JQL 表达式非常重要。例如,JIRA Toolkit 插件在查询中包含一个 "Number of comment" 自定义字段,用于您的查询中的 '"Number of comments" > 0'。另外,还会尝试根据状态(status=Open)最小化,增加轮询延迟等。Example:
jira://[type]?[required options]&jql=RAW(project=[project key] AND status in (Open, \"Coding In Progress\") AND \"Number of comments\">0)"
jira://[type]?[required options]&jql=RAW(project=[project key] AND status in (Open, \"Coding In Progress\") AND \"Number of comments\">0)"
30.8. 操作 复制链接链接已复制到粘贴板!
请参阅在使用 JIRA 操作时要设置的所需标头列表。producer 的 author 字段会在 JIRA 端自动设置为经过身份验证的用户。
如果没有设置任何必填字段,则会抛出 IllegalArgumentException。
对于字段需要 id,如问题类型、优先级、转换。检查 jira 项目上的有效 id,因为它们可能会在 jira 安装和项目工作流上有所不同。
30.9. AddIssue 复制链接链接已复制到粘贴板!
必需:
-
ProjectKey:项目键,例如:CAMEL、HHH、MYP。 -
IssueTypeId或IssueTypeName: 问题类型的id或问题类型的名称,您可以在http://jira_server/rest/api/2/issue/createmeta?projectKeys=SAMPLE_KEY中看到有效列表。 -
IssueSummary:问题摘要。
可选:
-
IssueAssignee:分配用户 -
IssuePriorityId或IssuePriorityName:问题的优先级,您可以在http://jira_server/rest/api/2/priority中看到有效列表。 -
IssueComponents:带有有效组件名称的字符串列表。 -
IssueWatchersAdd:带有要添加到 watcher 列表中的用户名的字符串列表。 -
IssueDescription:问题的描述。
30.10. AddComment 复制链接链接已复制到粘贴板!
必需:
-
IssueKey:问题密钥标识符。 - 交换的正文是描述。
30.11. attach 复制链接链接已复制到粘贴板!
每个调用只能有一个文件。
必需:
-
IssueKey:问题密钥标识符。 -
交换的正文应该是
文件类型
30.12. DeleteIssue 复制链接链接已复制到粘贴板!
必需:
-
IssueKey:问题密钥标识符。
30.13. TransitionIssue 复制链接链接已复制到粘贴板!
必需:
-
IssueKey:问题密钥标识符。 -
IssueTransitionId:问题转换id。 - 交换的正文是描述。
30.14. UpdateIssue 复制链接链接已复制到粘贴板!
-
IssueKey:问题密钥标识符。 -
IssueTypeId或IssueTypeName: 问题类型的id或问题类型的名称,您可以在http://jira_server/rest/api/2/issue/createmeta?projectKeys=SAMPLE_KEY中看到有效列表。 -
IssueSummary:问题摘要。 -
IssueAssignee:分配用户 -
IssuePriorityId或IssuePriorityName:问题的优先级,您可以在http://jira_server/rest/api/2/priority中看到有效列表。 -
IssueComponents:带有有效组件名称的字符串列表。 -
IssueDescription:问题的描述。
30.15. watcher 复制链接链接已复制到粘贴板!
-
IssueKey:问题密钥标识符。 -
IssueWatchersAdd:带有要添加到 watcher 列表中的用户名的字符串列表。 -
IssueWatchersRemove:带有要从观察列表中删除的用户名的字符串列表。
30.16. WatchUpdates (consumer) 复制链接链接已复制到粘贴板!
-
watchedFieldsComma 分隔的字段列表,以监视更改,如Status、Priority、Assignee、Components等。 -
sendOnlyUpdatedFieldBy 默认仅发送更改的字段作为正文。
所有消息还包含以下标头,用于添加有关更改的额外信息:
-
issueKey:更新的问题的密钥 -
已更改的: 更新字段的名称(例如 Status) -
watchedIssues: 列出更新时监视的所有问题密钥
30.17. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 jira 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-jira-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-jira-starter</artifactId>
</dependency>
组件支持 13 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.jira.access-token | (仅限OAuth)由 JIRA 服务器生成的访问令牌。 | 字符串 | |
| camel.component.jira.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.jira.bridge-error-handler | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
| camel.component.jira.configuration | 使用共享基础 jira 配置。选项是 org.apache.camel.component.jira.JiraConfiguration 类型。 | JiraConfiguration | |
| camel.component.jira.consumer-key | (仅限OAuth)来自 JIRA 设置的消费者密钥。 | 字符串 | |
| camel.component.jira.delay | 下一次轮询的时间(毫秒)。 | 6000 | 整数 |
| camel.component.jira.enabled | 是否启用 jira 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.jira.jira-url | JIRA 服务器 url,例如: http://my_jira.com:8081/。 | 字符串 | |
| camel.component.jira.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.jira.password | (仅限基本身份验证)向 JIRA 服务器进行身份验证的密码。仅在使用用户名基本身份验证时使用。 | 字符串 | |
| camel.component.jira.private-key | (仅限OAuth)客户端生成的私钥,以加密与服务器的对话。 | 字符串 | |
| camel.component.jira.username | (仅限基本身份验证)向 JIRA 服务器进行身份验证的用户名。仅在 JIRA 服务器上没有启用 OAuth 时使用。如果同时设置了 username 和 OAuth 令牌参数,则不要设置用户名和 OAuth 令牌参数,则用户名基本身份验证将具有优先权。 | 字符串 | |
| camel.component.jira.verification-code | (仅限OAuth)从授权过程的第一个步骤中生成的 JIRA 验证代码。 | 字符串 |
第 31 章 JMS 复制链接链接已复制到粘贴板!
支持生成者和消费者
此组件允许消息发送到(或从中消耗) JMS Queue 或 Topic。它使用 Spring 的 JMS 支持声明事务,包括用于发送的 Spring 的 JmsTemplate 和 MessageListenerContainer 以供使用。
Maven 用户需要将以下依赖项添加到其 pom.xml 中。
使用 ActiveMQ
,如果您使用 Apache ActiveMQ,您应该首选使用 ActiveMQ 组件,因为它已针对 ActiveMQ 进行了优化。此页面上的所有选项和示例也适用于 ActiveMQ 组件。
如果您在使用 JMS 的事务时,请参阅以下的事务和缓存级别
,因为它可能会影响性能。
请求/通过 JMS
,确保阅读本页面上 Request-reply 一节,以了解有关请求/回复的重要备注,因为 Camel 提供了很多选项来配置性能,以及集群环境。
31.1. URI 格式 复制链接链接已复制到粘贴板!
jms:[queue:|topic:]destinationName[?options]
jms:[queue:|topic:]destinationName[?options]
其中 destinationName 是 JMS 队列或主题名称。默认情况下,destinationName 被解释为队列名称。例如,要连接到队列,FOO.BAR 使用:
jms:FOO.BAR
jms:FOO.BAR
如果需要,您可以包含可选的 queue: 前缀:
jms:queue:FOO.BAR
jms:queue:FOO.BAR
要连接到某个主题,您必须 包含 topic: 前缀。例如,要连接到主题 Stocks.Prices,请使用:
jms:topic:Stocks.Prices
jms:topic:Stocks.Prices
您可以使用以下格式将查询选项附加到 URI 中,
?option=value&option=value&…
31.1.1. 使用 ActiveMQ 复制链接链接已复制到粘贴板!
JMS 组件重复使用 Spring 2 的 JmsTemplate 来发送消息。这不是在非J2EE 容器中使用的理想的选择,通常需要 JMS 供应商中的一些缓存以避免 性能不佳。
如果要使用 Apache ActiveMQ 作为您的消息代理,建议您进行以下操作之一:
- 使用 ActiveMQ 组件,该组件已优化为高效地使用 ActiveMQ
-
在 ActiveMQ 中使用
PoolingConnectionFactory。
31.1.2. 事务和缓存级别 复制链接链接已复制到粘贴板!
如果您使用消息并使用事务(transacted=true),缓存级别的默认设置可能会影响性能。
如果您使用 XA 事务,则无法缓存,因为它可能会导致 XA 事务无法正常工作。
如果您不使用 XA,那么您应该考虑缓存以加快性能,例如设置 cacheLevelName=CACHE_CONSUMER。
cacheLevelName 的默认设置是 CACHE_AUTO。这个默认自动检测模式,并相应地设置缓存级别:
-
CACHE_CONSUMERiftransacted=false -
CACHE_NONEiftransacted=true
因此,您可以说默认设置比较保守。如果您使用非 XA 事务,请考虑使用 cacheLevelName=CACHE_CONSUMER。
31.1.3. 可写订阅 复制链接链接已复制到粘贴板!
如果要使用持久主题订阅,则需要同时指定 clientId 和 durableSubscriptionName。clientId 的值必须是唯一的,且只能供整个网络中的单个 JMS 连接实例使用。您可能希望使用 Virtual Topics 来避免这个限制。此处 有关持久消息传递的更背景。
31.1.4. 消息标头映射 复制链接链接已复制到粘贴板!
在使用消息标头时,JMS 规格指出标头名称必须是有效的 Java 标识符。因此,请尝试将您的标头命名为有效的 Java 标识符。执行此操作的一个优点是,您可以在 JMS Selector 中使用您的标头(其 SQL92 语法强制使用标头的 Java 标识符语法)。
默认使用映射标头名称的简单策略。策略是替换标头名称中的任何点和连字符,如下所示,并在标头名称从通过线发送的 JMS 消息中恢复时反向替换。这意味着什么?在 bean 组件上没有更多调用的方法名称,不再丢失 File 组件的文件名标头,以此类推。
接受 Camel 中的标头名称的当前标头名称策略如下:
- 点被 'DOT' 替换,当 Camel 使用消息时,替换将被撤销
- 连字符由 'HYPHEN' 替代,并在 Camel 使用消息时撤销替换
您可以在 JMS 端点上配置许多不同的属性,该端点映射到 JMSConfiguration 对象上的属性。
映射到 Spring JMS
的许多属性映射到 Spring JMS 的属性,Camel 用来发送和接收信息。因此,您可以通过咨询相关的 Spring 文档来获取有关这些属性的更多信息。
31.2. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
31.2.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
31.2.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
31.3. 组件选项 复制链接链接已复制到粘贴板!
JMS 组件支持 98 选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clientId (common) | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| ConnectionFactory (common) | 要使用的连接工厂。必须在组件或端点上配置连接工厂。 | ConnectionFactory | |
| disableReplyTo (common) | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| durableSubscriptionName (common) | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| jmsMessageType (common) | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 Enum 值:
| JmsMessageType | |
| replyTo (common) | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| testConnectionOnStartup (common) | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| acknowledgementModeName (consumer) | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 Enum 值:
| AUTO_ACKNOWLEDGE | 字符串 |
| artemisConsumerPriority (consumer) | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | int | |
| asyncConsumer (consumer) | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| autoStartup (consumer) | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| cacheLevel (consumer) | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | int | |
| cacheLevelName (consumer) | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 Enum 值:
| CACHE_AUTO | 字符串 |
| concurrentConsumers (consumer) | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | int |
| maxConcurrentConsumers (consumer) | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | int | |
| replyToDeliveryPersistent (consumer) | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| selector (consumer) | 设置要使用的 JMS 选择器。 | 字符串 | |
| subscriptionDurable (consumer) | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| subscriptionName (consumer) | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| subscriptionShared (consumer) | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| acceptMessagesWhileStopping (consumer (advanced)) | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| allowReplyManagerQuickStop (consumer (advanced)) | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| consumerType (consumer (advanced)) | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| defaultTaskExecutorType (consumer (advanced)) | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 Enum 值:
| DefaultTaskExecutorType | |
| eagerLoadingOfProperties (consumer (advanced)) | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| eagerPoisonBody (consumer (advanced)) | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| exposeListenerSession (consumer (advanced)) | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| replyToSameDestinationAllowed (consumer (advanced)) | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| taskExecutor (consumer (advanced)) | 允许您指定自定义任务执行器以使用消息。 | TaskExecutor | |
| deliveryDelay (producer) | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | long |
| deliveryMode (producer) | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 Enum 值:
| 整数 | |
| deliveryPersistent (producer) | 指定默认使用持久性交付。 | true | 布尔值 |
| explicitQosEnabled (producer) | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| formatDateHeadersToIso8601 (producer) | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| preserveMessageQos (producer) | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| priority (producer) | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 Enum 值:
| 4 | int |
| replyToConcurrentConsumers (producer) | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | int |
| replyToMaxConcurrentConsumers (producer) | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | int | |
| replyToOnTimeoutMaxConcurrentConsumers (producer) | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | int |
| replyToOverride (producer) | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| replyToType (producer) | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 Enum 值:
| ReplyToType | |
| requestTimeout (producer) | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。 | 20000 | long |
| timeToLive (producer) | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | long |
| allowAdditionalHeaders (producer (advanced)) | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| allowNullBody (producer (advanced)) | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| alwaysCopyMessage (producer (advanced)) | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| correlationProperty (producer (advanced)) | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| disableTimeToLive (producer (advanced)) | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| forceSendOriginalMessage (producer (advanced)) | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| includeSentJMSMessageID (producer (advanced)) | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| replyToCacheLevelName (producer (advanced)) | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 Enum 值:
| 字符串 | |
| replyToDestinationSelectorName (producer (advanced)) | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| streamMessageTypeEnabled (producer (advanced)) | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| allowAutoWiredConnectionFactory (advanced) | 如果没有配置连接工厂,是否从 registry 自动发现 ConnectionFactory。如果只找到一个 ConnectionFactory 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| allowAutoWiredDestinationResolver (advanced) | 如果没有配置目标解析器,是否从 registry 自动发现 DestinationResolver。如果只找到一个 DestinationResolver 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| allowSerializedHeaders (advanced) | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| artemisStreamingEnabled (advanced) | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| asyncStartListener (advanced) | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| asyncStopListener (advanced) | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| autowiredEnabled (advanced) | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| 配置 (高级) | 使用共享的 JMS 配置。 | JmsConfiguration | |
| destinationResolver (advanced) | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。 | DestinationResolver | |
| errorHandler (advanced) | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。 | ErrorHandler | |
| exceptionListener (advanced) | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。 | ExceptionListener | |
| idleConsumerLimit (advanced) | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | int |
| idleTaskExecutionLimit (advanced) | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | int |
| includeAllJMSXProperties (advanced) | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| jmsKeyFormatStrategy (advanced) | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 Enum 值:
| JmsKeyFormatStrategy | |
| mapJmsMessage (advanced) | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| maxMessagesPerTask (advanced) | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | int |
| messageConverter (advanced) | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。 | MessageConverter | |
| messageCreatedStrategy (advanced) | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。 | MessageCreatedStrategy | |
| messageIdEnabled (advanced) | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| messageListenerContainerFactory (advanced) | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。 | MessageListenerContainerFactory | |
| messageTimestampEnabled (advanced) | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| pubSubNoLocal (advanced) | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| queueBrowseStrategy (advanced) | 在浏览队列时使用自定义 QueueBrowseStrategy。 | QueueBrowseStrategy | |
| receiveTimeout (advanced) | 接收消息的超时时间(以毫秒为单位)。 | 1000 | long |
| recoveryInterval (advanced) | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。 | 5000 | long |
| requestTimeoutCheckerInterval (advanced) | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。 | 1000 | long |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| transferException (advanced) | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| transferExchange (advanced) | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| useMessageIDAsCorrelationID (advanced) | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| waitForProvisionCorrelationToBeUpdatedCounter (advanced) | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | int |
| waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced) | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。 | 100 | long |
| HeaderFilterStrategy (filter) | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| errorHandlerLoggingLevel (logging) | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 Enum 值:
| WARN | LoggingLevel |
| errorHandlerLogStackTrace (logging) | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| 密码 (安全) | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| 用户名 (安全) | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| Transacted (transaction) | 指定是否使用转换模式。 | false | 布尔值 |
| TransactedInOut (transaction) | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| lazyCreateTransactionManager (transaction (advanced)) | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| transactionManager (transaction (advanced)) | 要使用的 Spring 事务管理器。 | PlatformTransactionManager | |
| transactionName (transaction (advanced)) | 要使用的事务的名称。 | 字符串 | |
| transactionTimeout (transaction (advanced)) | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | int |
31.4. 端点选项 复制链接链接已复制到粘贴板!
JMS 端点使用 URI 语法进行配置:
jms:destinationType:destinationName
jms:destinationType:destinationName
使用以下路径和查询参数:
31.4.1. 路径参数(2 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| destinationType (common) | 要使用的目标种类。 Enum 值:
| queue | 字符串 |
| destinationName (common) | 用作目的地的队列或主题 所需的 名称。 | 字符串 |
31.4.2. 查询参数(95 参数) 复制链接链接已复制到粘贴板!
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| clientId (common) | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| ConnectionFactory (common) | 要使用的连接工厂。必须在组件或端点上配置连接工厂。 | ConnectionFactory | |
| disableReplyTo (common) | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| durableSubscriptionName (common) | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| jmsMessageType (common) | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 Enum 值:
| JmsMessageType | |
| replyTo (common) | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| testConnectionOnStartup (common) | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| acknowledgementModeName (consumer) | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 Enum 值:
| AUTO_ACKNOWLEDGE | 字符串 |
| artemisConsumerPriority (consumer) | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | int | |
| asyncConsumer (consumer) | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| autoStartup (consumer) | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| cacheLevel (consumer) | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | int | |
| cacheLevelName (consumer) | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 Enum 值:
| CACHE_AUTO | 字符串 |
| concurrentConsumers (consumer) | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | int |
| maxConcurrentConsumers (consumer) | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | int | |
| replyToDeliveryPersistent (consumer) | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| selector (consumer) | 设置要使用的 JMS 选择器。 | 字符串 | |
| subscriptionDurable (consumer) | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| subscriptionName (consumer) | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| subscriptionShared (consumer) | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| acceptMessagesWhileStopping (consumer (advanced)) | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| allowReplyManagerQuickStop (consumer (advanced)) | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| consumerType (consumer (advanced)) | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 Enum 值:
| 默认值 | ConsumerType |
| defaultTaskExecutorType (consumer (advanced)) | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 Enum 值:
| DefaultTaskExecutorType | |
| eagerLoadingOfProperties (consumer (advanced)) | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| eagerPoisonBody (consumer (advanced)) | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
| exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
| exposeListenerSession (consumer (advanced)) | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| replyToSameDestinationAllowed (consumer (advanced)) | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| taskExecutor (consumer (advanced)) | 允许您指定自定义任务执行器以使用消息。 | TaskExecutor | |
| deliveryDelay (producer) | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | long |
| deliveryMode (producer) | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 Enum 值:
| 整数 | |
| deliveryPersistent (producer) | 指定默认使用持久性交付。 | true | 布尔值 |
| explicitQosEnabled (producer) | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| formatDateHeadersToIso8601 (producer) | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| lazyStartProducer (producer) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| preserveMessageQos (producer) | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| priority (producer) | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 Enum 值:
| 4 | int |
| replyToConcurrentConsumers (producer) | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | int |
| replyToMaxConcurrentConsumers (producer) | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | int | |
| replyToOnTimeoutMaxConcurrentConsumers (producer) | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | int |
| replyToOverride (producer) | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| replyToType (producer) | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 Enum 值:
| ReplyToType | |
| requestTimeout (producer) | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。 | 20000 | long |
| timeToLive (producer) | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | long |
| allowAdditionalHeaders (producer (advanced)) | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| allowNullBody (producer (advanced)) | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| alwaysCopyMessage (producer (advanced)) | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| correlationProperty (producer (advanced)) | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| disableTimeToLive (producer (advanced)) | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| forceSendOriginalMessage (producer (advanced)) | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| includeSentJMSMessageID (producer (advanced)) | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| replyToCacheLevelName (producer (advanced)) | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 Enum 值:
| 字符串 | |
| replyToDestinationSelectorName (producer (advanced)) | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| streamMessageTypeEnabled (producer (advanced)) | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| allowSerializedHeaders (advanced) | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| artemisStreamingEnabled (advanced) | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| asyncStartListener (advanced) | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| asyncStopListener (advanced) | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| destinationResolver (advanced) | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。 | DestinationResolver | |
| errorHandler (advanced) | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。 | ErrorHandler | |
| exceptionListener (advanced) | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。 | ExceptionListener | |
| HeaderFilterStrategy (advanced) | 使用自定义 HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。 | HeaderFilterStrategy | |
| idleConsumerLimit (advanced) | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | int |
| idleTaskExecutionLimit (advanced) | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | int |
| includeAllJMSXProperties (advanced) | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| jmsKeyFormatStrategy (advanced) | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 Enum 值:
| JmsKeyFormatStrategy | |
| mapJmsMessage (advanced) | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| maxMessagesPerTask (advanced) | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | int |
| messageConverter (advanced) | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。 | MessageConverter | |
| messageCreatedStrategy (advanced) | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。 | MessageCreatedStrategy | |
| messageIdEnabled (advanced) | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| messageListenerContainerFactory (advanced) | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。 | MessageListenerContainerFactory | |
| messageTimestampEnabled (advanced) | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| pubSubNoLocal (advanced) | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| receiveTimeout (advanced) | 接收消息的超时时间(以毫秒为单位)。 | 1000 | long |
| recoveryInterval (advanced) | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。 | 5000 | long |
| requestTimeoutCheckerInterval (advanced) | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。 | 1000 | long |
| Sync (advanced) | 设置是否应严格使用同步处理。 | false | 布尔值 |
| transferException (advanced) | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| transferExchange (advanced) | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| useMessageIDAsCorrelationID (advanced) | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| waitForProvisionCorrelationToBeUpdatedCounter (advanced) | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | int |
| waitForProvisionCorrelationToBeUpdatedThreadSleepingTime (advanced) | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。 | 100 | long |
| errorHandlerLoggingLevel (logging) | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 Enum 值:
| WARN | LoggingLevel |
| errorHandlerLogStackTrace (logging) | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| 密码 (安全) | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| 用户名 (安全) | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| Transacted (transaction) | 指定是否使用转换模式。 | false | 布尔值 |
| TransactedInOut (transaction) | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| lazyCreateTransactionManager (transaction (advanced)) | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| transactionManager (transaction (advanced)) | 要使用的 Spring 事务管理器。 | PlatformTransactionManager | |
| transactionName (transaction (advanced)) | 要使用的事务的名称。 | 字符串 | |
| transactionTimeout (transaction (advanced)) | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | int |
31.5. Samples 复制链接链接已复制到粘贴板!
JMS 也在许多示例中用于其他组件。但是,我们提供了几个示例来开始。
31.5.1. 从 JMS 接收 复制链接链接已复制到粘贴板!
在以下示例中,我们将配置一个路由,该路由接收 JMS 信息并将消息路由到 POJO:
from("jms:queue:foo").
to("bean:myBusinessLogic");
from("jms:queue:foo").
to("bean:myBusinessLogic");
您可以使用任何 EIP 模式,以便路由基于上下文。例如,这里的如何为大消耗器过滤订购主题:
from("jms:topic:OrdersTopic").
filter().method("myBean", "isGoldCustomer").
to("jms:queue:BigSpendersQueue");
from("jms:topic:OrdersTopic").
filter().method("myBean", "isGoldCustomer").
to("jms:queue:BigSpendersQueue");
31.5.2. 发送到 JMS 复制链接链接已复制到粘贴板!
在以下示例中,我们轮询文件文件夹,并将文件内容发送到 JMS 主题。当我们希望将文件的内容作为 TextMessage 而不是 BytesMessage 一样,我们需要将正文转换为 字符串 :
from("file://orders").
convertBodyTo(String.class).
to("jms:topic:OrdersTopic");
from("file://orders").
convertBodyTo(String.class).
to("jms:topic:OrdersTopic");
31.5.3. 使用注解 复制链接链接已复制到粘贴板!
Camel 还具有注释,因此您可以使用 POJO Consuming 和 POJO Producing。
31.5.4. Spring DSL 示例 复制链接链接已复制到粘贴板!
前面的示例使用 Java DSL。Camel 还支持 Spring XML DSL。以下是使用 Spring DSL 的大消耗的示例:
31.5.5. 其他示例 复制链接链接已复制到粘贴板!
JMS 出现在其他组件和 EIP 模式的许多示例中,以及此 Camel 文档。因此,可以浏览文档。
31.5.6. 使用 JMS 作为 Dead Letter Queue Store Exchange 复制链接链接已复制到粘贴板!
通常,当使用 JMS 作为传输时,它仅传输正文和标头作为有效负载。如果要将 JMS 与 Dead Letter Channel 搭配使用,使用 JMS 队列作为 Dead Letter Queue,则原因的例外通常不会存储在 JMS 消息中。但是,您可以在 JMS 死信队列中使用 transferExchange 选项来指示 Camel 将整个 Exchange 存储在队列中,作为包含 org.apache.camel.support.DefaultExchangeHolder 的 javax.jms.ObjectMessage。这可让您从 Dead Letter Queue 中使用,并使用密钥 Exchange.EXCEPTION_CAUGHT 从 Exchange 属性中检索原因异常。以下演示展示了这一点:
// setup error handler to use JMS as queue and store the entire Exchange
errorHandler(deadLetterChannel("jms:queue:dead?transferExchange=true"));
// setup error handler to use JMS as queue and store the entire Exchange
errorHandler(deadLetterChannel("jms:queue:dead?transferExchange=true"));
然后,您可以从 JMS 队列中消耗并分析问题:
31.5.7. 使用 JMS 作为只存储错误的 Dead Letter Channel 复制链接链接已复制到粘贴板!
您可以使用 JMS 存储原因错误消息或存储自定义正文,您可以自行初始化。以下示例使用 Message Translator EIP 在移到 JMS 死信队列前对失败的交换进行转换:
// we sent it to a seda dead queue first
errorHandler(deadLetterChannel("seda:dead"));
// and on the seda dead queue we can do the custom transformation before its sent to the JMS queue
from("seda:dead").transform(exceptionMessage()).to("jms:queue:dead");
// we sent it to a seda dead queue first
errorHandler(deadLetterChannel("seda:dead"));
// and on the seda dead queue we can do the custom transformation before its sent to the JMS queue
from("seda:dead").transform(exceptionMessage()).to("jms:queue:dead");
在这里,我们只会将原始原因错误消息存储在转换中。但是,您可以使用任何表达式来发送您需要的任何表达式。例如,您可以在 Bean 上调用方法或使用自定义处理器。
31.6. JMS 和 Camel 之间的消息映射 复制链接链接已复制到粘贴板!
Camel 自动映射 javax.jms.Message 和 org.apache.camel.Message 之间的消息。
发送 JMS 消息时,Camel 会将消息正文转换为以下 JMS 消息类型:
| 正文类型 | JMS Message | 注释 |
|---|---|---|
|
|
| |
|
|
|
DOM 将转换为 |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
在收到 JMS 消息时,Camel 会将 JMS 信息转换为以下正文类型:
| JMS Message | 正文类型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
31.6.1. 禁用自动映射 JMS 消息 复制链接链接已复制到粘贴板!
您可以使用 mapJmsMessage 选项禁用上述自动映射。如果禁用,Camel 不会尝试映射收到的 JMS 消息,而是直接将其用作有效负载。这可让您避免映射开销,并使 Camel 只是通过 JMS 消息传递。例如,它甚至允许您路由带有使用了没有包括在 classpath 中的类的 javax.jms.ObjectMessage JMS 消息。
31.6.2. 使用自定义 MessageConverter 复制链接链接已复制到粘贴板!
您可以使用 messageConverter 选项在 Spring org.springframework.jms.support.converter.MessageConverter 类中进行映射。
例如,在下面的路由中,在向 JMS order 队列发送消息时,使用自定义消息转换器:
from("file://inbox/order").to("jms:queue:order?messageConverter=#myMessageConverter");
from("file://inbox/order").to("jms:queue:order?messageConverter=#myMessageConverter");
在从 JMS 目的地消耗时,您还可以使用自定义消息转换器。
31.6.3. 控制所选的映射策略 复制链接链接已复制到粘贴板!
您可以使用端点 URL 上的 jmsMessageType 选项为所有消息强制使用特定的消息类型。
在以下路由中,从文件夹中轮询文件,并将其作为 javax.jms.TextMessage 发送,因为我们已强制 JMS producer 端点使用文本消息:
from("file://inbox/order").to("jms:queue:order?jmsMessageType=Text");
from("file://inbox/order").to("jms:queue:order?jmsMessageType=Text");
您还可以通过使用键 CamelJmsMessageType 设置标头来指定要用于每个消息的消息类型。例如:
from("file://inbox/order").setHeader("CamelJmsMessageType", JmsMessageType.Text).to("jms:queue:order");
from("file://inbox/order").setHeader("CamelJmsMessageType", JmsMessageType.Text).to("jms:queue:order");
可能的值在 enum 类 org.apache.camel.jms.JmsMessageType 中定义。
31.7. 发送时的消息格式 复制链接链接已复制到粘贴板!
通过 JMS 有线发送的交换必须符合 JMS 消息规格。
对于 exchange.in.header,以下规则适用于标头 键 :
-
从
JMS或JMSX开头的密钥将被保留。 -
exchange.in.headers键必须是字面数,并且全部都是有效的 Java 标识符(不要在密钥名称中使用点)。 -
Camel 在消耗 JMS 消息时替换句点和连字符,在 Camel 使用消息时被 'DOT' 替代,并在 Camel 使用消息时替换反向替换。
-被 'HYPHEN' 替换,并在 Camel 消耗消息时替换反向替换。
-
另请参阅
jmsKeyFormatStrategy选项,该选项允许使用您自己的自定义策略进行格式化密钥。
对于 exchange.in.header,以下规则适用于 标头值 :
-
值必须是 primitives 或其计数器对象(如
Integer、Long、Character)。类型、字符串、CharSequence、日期、MuterDecimal和BigInteger都转换为其toString ()表示。所有其他类型都会丢弃。
如果它丢弃给定标头值,Camel 会在 DEBUG 级别使用类别 org.apache.camel.component.jms.JmsBinding 记录。例如:
2008-07-09 06:43:04,046 [main ] DEBUG JmsBinding
- Ignoring non primitive header: order of class: org.apache.camel.component.jms.issues.DummyOrder with value: DummyOrder{orderId=333, itemId=4444, quantity=2}
2008-07-09 06:43:04,046 [main ] DEBUG JmsBinding
- Ignoring non primitive header: order of class: org.apache.camel.component.jms.issues.DummyOrder with value: DummyOrder{orderId=333, itemId=4444, quantity=2}
31.8. 接收时的消息格式 复制链接链接已复制到粘贴板!
Camel 在收到消息时向 交换 添加以下属性:
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 回复目的地。 |
Camel 在收到 JMS 消息时,在 In 消息标头中添加以下 JMS 属性:
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| JMS 关联 ID。 |
|
|
| JMS 交付模式。 |
|
|
| JMS 目的地。 |
|
|
| JMS 过期。 |
|
|
| JMS 唯一的消息 ID。 |
|
|
| JMS 优先级(0 作为最低优先级,9 为最高)。 |
|
|
| 是 JMS 消息,redelivered。 |
|
|
| JMS 回复到目的地。 |
|
|
| JMS 时间戳。 |
|
|
| JMS 类型。 |
|
|
| JMS 组 ID。 |
由于上述所有信息都是标准的 JMS,您可以检查 JMS 文档 以了解更多详情。
31.9. 关于使用 Camel 来发送和接收消息,以及 JMSReplyTo 复制链接链接已复制到粘贴板!
JMS 组件比较复杂,您必须特别注意它在某些情况下如何工作。因此,这是要查找的一些 Region/pitfalls 的简短摘要。
当 Camel 使用其 JMSProducer 发送消息时,它会检查以下条件:
- 消息交换模式,
-
在端点或消息标头中设置了
JMSReplyTo, -
是否在 JMS 端点上设置了以下选项:
disableReplyTo、preserveMessageQos,explicitQosEnabled。
所有这些都很复杂,理解并配置来支持您的用例。
31.9.1. JmsProducer 复制链接链接已复制到粘贴板!
JmsProducer 的行为如下,具体取决于配置:
| 交换模式 | 其他选项 | 描述 |
|---|---|---|
| InOut | - |
Camel 将期望回复,设置临时 |
| InOut |
|
Camel 将期望回复,并在发送消息后,它将开始侦听指定的 |
| InOnly | - | Camel 将发送邮件,而不是 预期回复。 |
| InOnly |
|
默认情况下,Camel 会丢弃 |
31.9.2. JmsConsumer 复制链接链接已复制到粘贴板!
JmsConsumer 的行为如下,具体取决于配置:
| 交换模式 | 其他选项 | 描述 |
|---|---|---|
| InOut | - |
Camel 将回复发送回 |
| InOnly | - | Camel 不会发送回复回来,因为模式是 InOnly。 |
| - |
| 这个选项会阻止回复。 |
请注意您在交换上设置的消息交换模式。
如果您在路由中间向 JMS 目的地发送消息,您可以指定要使用的交换模式,请参阅 Request Reply。
如果您要向 JMS 主题发送 InOnly 信息,这非常有用:
from("activemq:queue:in")
.to("bean:validateOrder")
.to(ExchangePattern.InOnly, "activemq:topic:order")
.to("bean:handleOrder");
from("activemq:queue:in")
.to("bean:validateOrder")
.to(ExchangePattern.InOnly, "activemq:topic:order")
.to("bean:handleOrder");
31.10. 重复使用端点并发送到在运行时计算的不同目的地 复制链接链接已复制到粘贴板!
如果您需要发送消息到许多不同的 JMS 目的地,可以重复利用 JMS 端点并在消息标头中指定实际目的地。这允许 Camel 重复使用同一端点,但发送到不同的目的地。这可显著减少内存和线程资源上创建的端点数量。
您可以在以下标头中指定目的地:
| 标头 | 类型 | 描述 |
|---|---|---|
|
|
| 目标对象。 |
|
|
| 目标名称。 |
例如,以下路由演示了如何在运行时计算目的地,并使用它来覆盖 JMS URL 中显示的目的地:
from("file://inbox")
.to("bean:computeDestination")
.to("activemq:queue:dummy");
from("file://inbox")
.to("bean:computeDestination")
.to("activemq:queue:dummy");
队列名称 dummy 只是一个占位符。它必须作为 JMS 端点 URL 的一部分提供,但本例中将被忽略。
在 computeDestination bean 中,设置 CamelJmsDestinationName 标头来指定实际目的地,如下所示:
public void setJmsHeader(Exchange exchange) {
String id = ....
exchange.getIn().setHeader("CamelJmsDestinationName", "order:" + id");
}
public void setJmsHeader(Exchange exchange) {
String id = ....
exchange.getIn().setHeader("CamelJmsDestinationName", "order:" + id");
}
然后 Camel 将读取此标头并将其用作目的地,而不是在端点上配置的标头。因此,在这个示例中,Camel 将消息发送到 activemq:queue:order:2,假设 id 值为 2。
如果同时设置了 CamelJmsDestination 和 CamelJmsDestinationName 标头,则 CamelJmsDestination 具有优先权。请记住,JMS 生成者会从交换中删除 CamelJmsDestination and CamelJmsDestinationName 标头,且不会将它们传播到所创建的 JMS 消息,以避免路由中的意外循环(当消息将转发到另一个 JMS 端点时)。
31.11. 配置不同的 JMS 供应商 复制链接链接已复制到粘贴板!
您可以在 Spring XML 中配置 JMS 供应商,如下所示:
基本上,您可以根据需要配置多个 JMS 组件实例,您需要使用 id 属性 为它们指定唯一的名称。前面的示例配置了 activemq 组件。您可以执行同样的方法来配置 MQSeries、TibCo、TibCo、Sonic 等。
命名的 JMS 组件后,您可以使用 URI 引用该组件中的端点。例如,对于组件名称 activemq,您可以使用 URI 格式引用目的地,activemq:[queue:|topic:]destinationName。您可以将相同的方法用于所有其他 JMS 提供程序。
这可通过 Spring CamelContext 许可,从用于 Endpoint URI 的方案名称的 spring 上下文获取组件,并让组件解析端点 URI。
31.11.1. 使用 JNDI 查找 ConnectionFactory 复制链接链接已复制到粘贴板!
如果您使用 J2EE 容器,您可能需要查找 JNDI 以查找 JMS ConnectionFactory,而不是在 Spring 中使用常见的 < bean> 机制。您可以使用 Spring 的 factory bean 或新的 Spring XML 命名空间进行此操作。例如:
<bean id="weblogic" class="org.apache.camel.component.jms.JmsComponent"> <property name="connectionFactory" ref="myConnectionFactory"/> </bean> <jee:jndi-lookup id="myConnectionFactory" jndi-name="jms/connectionFactory"/>
<bean id="weblogic" class="org.apache.camel.component.jms.JmsComponent">
<property name="connectionFactory" ref="myConnectionFactory"/>
</bean>
<jee:jndi-lookup id="myConnectionFactory" jndi-name="jms/connectionFactory"/>
有关 JNDI 查找的详情,请参阅 Spring 参考文档中的 jee 模式。
31.12. 并发消耗 复制链接链接已复制到粘贴板!
JMS 的常见要求是在多个线程中同时使用消息,以便应用程序更快响应。您可以设置 concurrentConsumers 选项,以指定为 JMS 端点提供服务的线程数量,如下所示:
from("jms:SomeQueue?concurrentConsumers=20").
bean(MyClass.class);
from("jms:SomeQueue?concurrentConsumers=20").
bean(MyClass.class);
您可以使用以下方法之一配置这个选项:
-
在
JmsComponent上, - 在端点 URI 或.
-
通过直接在
JmsEndpoint上调用setConcurrentConsumers ()。
31.12.1. 使用 async 使用者并发恢复 复制链接链接已复制到粘贴板!
请注意,当当前消息被完全处理后,每个并发消费者将仅从 JMS 代理获取下一个可用消息。您可以设置 asyncConsumer=true 选项,以便消费者从 JMS 队列中提取下一个消息,而前面的消息则异步处理(通过 Asynchronous Routing Engine)。有关 asyncConsumer 选项的信息,请参阅页面顶部的更多详情。
from("jms:SomeQueue?concurrentConsumers=20&asyncConsumer=true").
bean(MyClass.class);
from("jms:SomeQueue?concurrentConsumers=20&asyncConsumer=true").
bean(MyClass.class);
31.13. 通过 JMS 请求代表 复制链接链接已复制到粘贴板!
Camel 支持通过 JMS 重新请求请求。在向 JMS 队列发送消息时,交换的 MEP 应该为 InOut。
Camel 提供了多个选项来配置请求/对 JMS 的影响,它们会影响性能和集群环境。下表总结了选项。
| 选项 | 性能 | 集群 | 描述 |
|---|---|---|---|
|
| 速度快 | 是 |
临时队列用作回复队列,并由 Camel 自动创建。要使用它,不要指定 replyTo 队列名称。另外,您还可以配置 |
|
| slow | 是 |
共享持久性队列用作回复队列。必须事先创建队列,但有些代理可以在实时(如 Apache ActiveMQ)上创建它们。要使用此功能,您必须指定 replyTo 队列名称。另外,您还可以配置 |
|
| 速度快 | 否(是) |
专用持久队列用作回复队列。必须事先创建队列,但有些代理可以在实时(如 Apache ActiveMQ)上创建它们。要使用此功能,您必须指定 replyTo 队列名称。必须配置 |
|
| 速度快 | 是 |
允许使用并发消息监听程序同时处理回复消息。您可以使用 |
|
| 速度快 | 是 |
允许使用并发消息监听程序同时处理回复消息。您可以使用 |
JmsProducer 检测到 InOut,并提供带有要使用的回复目的地的 JMSReplyTo 标头。默认情况下,Camel 使用临时队列,但您可以使用端点上的 replyTo 选项指定固定的回复队列(请参阅以下有关固定回复队列的更多信息)。
Camel 将自动设置侦听回复队列的消费者,因此 您不应该 执行任何操作。
此消费者是一个 Spring DefaultMessageListenerContainer,它侦听回复。但是,它被固定到 1 个并发消费者。
这意味着回复将按顺序处理,因为只有 1 个线程来处理回复。您可以使用 concurrentConsumers 和 maxConcurrentConsumers 选项将监听程序配置为使用并发线程。这可让您更轻松地在 Camel 中配置此功能,如下所示:
from(xxx)
.inOut().to("activemq:queue:foo?concurrentConsumers=5")
.to(yyy)
.to(zzz);
from(xxx)
.inOut().to("activemq:queue:foo?concurrentConsumers=5")
.to(yyy)
.to(zzz);
在这个路由中,我们指示 Camel 使用具有 5 个线程的线程池异步路由回复。
31.13.2. 请求通过 JMS,并使用一个专用固定回复队列 复制链接链接已复制到粘贴板!
在上例中,Camel 将预期名为"bar"的固定回复队列被共享,因此它使用 JMSSelector 来仅消耗期望的回复消息。但是,这个问题有缺陷,因为 JMS 选择器会较慢。另外,回复队列上的消费者使用新的 JMS 选择器 ID 更新速度较慢。实际上,只有在 receiveTimeout 选项超时时才会更新,默认为 1 秒。因此,在回复消息中,可能会检测到大约 1 秒。另一方面,如果固定回复队列专用于 Camel 回复消费者,则我们可以避免使用 JMS 选择器,因此更为高性能。实际上,使用临时队列就快。您可以将 ReplyToType 选项配置为 Exclusive
,以告知 Camel 回复队列是独占的,如下例所示:
from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar&replyToType=Exclusive")
.to(yyy)
from(xxx)
.inOut().to("activemq:queue:foo?replyTo=bar&replyToType=Exclusive")
.to(yyy)
请记住,队列必须专用于每个端点和每个端点。因此,如果您有两个路由,则每个路由都需要一个唯一的回复队列,如下例所示:
如果您在集群环境中运行,则适用相同。然后,集群中的每个节点都必须使用唯一的回复队列名称。否则,集群中的每个节点可能会获取旨在作为另一节点上的回复的信息。对于集群环境,建议您使用共享回复队列。
31.14. 在发送方和接收器之间同步时钟 复制链接链接已复制到粘贴板!
在系统间进行消息传递时,最好系统具有同步时钟。例如,发送 JMS 消息时,您可以在消息上设置生存时间。然后接收器可以检查这个值,并确定消息是否已过期,从而丢弃消息而不是消耗和处理。但是,这需要发送方和接收器都同步时钟。如果使用 ActiveMQ,您可以使用 timestamp 插件来 同步时钟。
31.15. 关于生存时间 复制链接链接已复制到粘贴板!
首先阅读有关同步时钟的上面。
当您使用 Camel 通过 JMS 进行请求/回复(InOut)时,Camel 会在发送方端使用超时,这是 requestTimeout 选项的默认 20 秒。您可以通过设置更高的/低值来控制这个值。但是,在正在发送的消息上仍然设置了实时值的时间。因此,这需要在系统之间同步时钟。如果没有,您可能需要禁用要设置的实时值的时间。现在,可以使用 Camel 2.8 中的 disableTimeToLive 选项。因此,如果您将此选项设置为 disableTimeToLive=true,则 Camel 在发送 JMS 消息时 不会将 任何时间设置为 live 值。但是,请求超时仍处于活动状态。例如,如果您对 JMS 进行请求/回复,并且禁用了生存时间,则 Camel 仍然将使用 20 秒的超时( requestTimeout 选项)。也可以配置该选项。因此,两个选项 requestTimeout 和 disableTimeToLive 可让您在执行请求/回复时进行精细控制。
您可以在消息中提供标头来覆盖并用作请求超时值,而不是端点配置的值。例如:
from("direct:someWhere")
.to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
.to("bean:processReply");
from("direct:someWhere")
.to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
.to("bean:processReply");
在上面的路由中,我们有一个端点配置的 requestTimeout 为 30 秒。因此,Camel 将等待 30 秒,以便该回复消息回到栏队列中。如果没有收到回复消息,则在 Exchange 上设置 org.apache.camel.ExchangeTimedOutException,Camel 会继续路由消息,然后因为异常而失败,Camel 的错误处理程序响应。
如果要使用每个消息超时值,您可以使用键 org.apache.camel.component.jms.JmsConstants114JMS_REQUEST_TIMEOUT 设置标头,其值为 "CamelJmsRequestTimeout "。
例如,我们可以使用 bean 计算每个消息的超时值,例如在服务 bean 上调用 "whatIs TheTimeout" 方法,如下所示:
from("direct:someWhere")
.setHeader("CamelJmsRequestTimeout", method(ServiceBean.class, "whatIsTheTimeout"))
.to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
.to("bean:processReply");
from("direct:someWhere")
.setHeader("CamelJmsRequestTimeout", method(ServiceBean.class, "whatIsTheTimeout"))
.to("jms:queue:foo?replyTo=bar&requestTimeout=30s")
.to("bean:processReply");
当您使用 Camel 通过 JMS 触发和忘记(InOut)时,默认情况下 Camel 不会将 任何时间设置为消息上的实时值。您可以使用 timeToLive 选项配置值。例如,要指定 5 秒,您可以设置 timeToLive=5000。选项 disableTimeToLive 可用于强制禁用生存时间,也用于 InOnly messaging。requestTimeout 选项不用于 InOnly messaging。
31.16. 启用 Transacted Consumption 复制链接链接已复制到粘贴板!
常见要求是从事务中的队列消耗,然后使用 Camel 路由处理消息。要做到这一点,只要确保在组件/端点上设置以下属性:
-
transacted= true -
transactionManager= Transsaction Manager - 通常是JmsTransactionManager
详情请查看 Transactional Client EIP 模式。
与 JMS 相比,事务和 [Request Reply]
当通过 JMS 使用 Request Reply 时,您不能使用单个事务;在执行提交前,JMS 不会发送任何消息,因此服务器端不会完全接收任何内容,直到事务提交为止。因此,要使用 Request Reply,您必须在发送请求后提交事务,然后使用单独的事务接收响应。
要解决这个问题,JMS 组件使用不同的属性来指定用于单向消息传递和请求回复消息传递的事务:
transacted 属性只适用于 InOnly message Exchange Pattern (MEP)。
您可以使用组件/端点中的以下属性利用 DMLC 转换的会话 API :
-
transacted= true -
lazyCreateTransactionManager= false
这样做的好处在于,在使用没有配置的 TransactionManager 的本地事务时,会遵循 cacheLevel 设置。配置 TransactionManager 时,在 DMLC 级别不需要缓存,需要依赖于池的连接工厂。有关此类设置的详情,请查看 此处 和 此处。
31.17. 使用 JMSReplyTo 进行 late 回复 复制链接链接已复制到粘贴板!
当使用 Camel 作为 JMS 侦听器时,它会使用 ReplyTo javax.jms.Destination 对象的值设置 Exchange 属性,其键为 ReplyTo。您可以按如下方式 获取 此目标:
Destination replyDestination = exchange.getIn().getHeader(JmsConstants.JMS_REPLY_DESTINATION, Destination.class);
Destination replyDestination = exchange.getIn().getHeader(JmsConstants.JMS_REPLY_DESTINATION, Destination.class);
然后,之后使用它来使用常规 JMS 或 Camel 发送回复。
// we need to pass in the JMS component, and in this sample we use ActiveMQ JmsEndpoint endpoint = JmsEndpoint.newInstance(replyDestination, activeMQComponent); // now we have the endpoint we can use regular Camel API to send a message to it template.sendBody(endpoint, "Here is the late reply.");
// we need to pass in the JMS component, and in this sample we use ActiveMQ
JmsEndpoint endpoint = JmsEndpoint.newInstance(replyDestination, activeMQComponent);
// now we have the endpoint we can use regular Camel API to send a message to it
template.sendBody(endpoint, "Here is the late reply.");
发送回复的不同解决方案是在发送时在同一 Exchange 属性中提供 replyDestination 对象。然后 Camel 将获取此属性并将其用于实际目的地。端点 URI 必须包含 dummy 目的地。例如:
31.18. 使用请求超时 复制链接链接已复制到粘贴板!
在以下示例中,我们发送了一个 Request Reply 风格的消息 Exchange (我们使用 requestBody method = InOut)到 slow 队列以便在 Camel 中进一步处理,然后等待返回回复:
31.19. 发送 InOnly 消息并保留 JMSReplyTo 标头 复制链接链接已复制到粘贴板!
当使用 camel-jms 发送到 JMS 目的地时,生成者将使用 MEP 检测其 InOnly 或 InOut 消息传递。但是,在有些情况下,您可以发送 InOnly 消息,但保留 JMSReplyTo 标头。为此,您必须指示 Camel 保留它,否则将丢弃 JMSReplyTo 标头。
例如,要将 InOnly 信息发送到 foo 队列,但带有带有 bar 队列的 JMSReplyTo,您可以执行以下操作:
请注意,我们使用 preserveMessageQos=true 来指示 Camel 保留 JMSReplyTo 标头。
31.20. 在目的地上设置 JMS 供应商选项 复制链接链接已复制到粘贴板!
有些 JMS 提供程序,如 IBM 的 WebSphere MQ 需要在 JMS 目的地上设置选项。例如,您可能需要指定 targetClient 选项。由于 targetClient 是 WebSphere MQ 选项,而不是 Camel URI 选项,您需要在 JMS 目标名称上设置它,如:
// ...
.setHeader("CamelJmsDestinationName", constant("queue:///MY_QUEUE?targetClient=1"))
.to("wmq:queue:MY_QUEUE?useMessageIDAsCorrelationID=true");
// ...
.setHeader("CamelJmsDestinationName", constant("queue:///MY_QUEUE?targetClient=1"))
.to("wmq:queue:MY_QUEUE?useMessageIDAsCorrelationID=true");
一些 WMQ 版本在目的地名称中不接受这个选项,您会得到如下例外:
com.ibm.msg.client.jms.DetailedJMSException: JMSCC0005: The specified value 'MY_QUEUE?targetClient=1' is not allowed for 'XMSC_DESTINATION_NAME'
com.ibm.msg.client.jms.DetailedJMSException: JMSCC0005: The specified
value 'MY_QUEUE?targetClient=1' is not allowed for
'XMSC_DESTINATION_NAME'
一个临时解决方案是使用自定义 DestinationResolver:
31.21. Spring Boot Auto-Configuration 复制链接链接已复制到粘贴板!
当在 Spring Boot 中使用 jms 时,请确保使用以下 Maven 依赖项来支持自动配置:
<dependency> <groupId>org.apache.camel.springboot</groupId> <artifactId>camel-jms-starter</artifactId> </dependency>
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-jms-starter</artifactId>
</dependency>
组件支持 99 个选项,如下所列。
| Name | 描述 | 默认值 | 类型 |
|---|---|---|---|
| camel.component.jms.accept-messages-while-stopping | 指定消费者在停止时是否接受消息。如果您在运行时启动和停止 JMS 路由,则可能会考虑启用此选项,同时仍然在队列中排队消息。如果此选项为 false,并且您停止 JMS 路由,则消息可能会被拒绝,并且 JMS 代理必须尝试 redeliveries (但可能会再次拒绝),最终消息可能会移到 JMS 代理上的死信队列中。要避免这种情况,建议启用这个选项。 | false | 布尔值 |
| camel.component.jms.acknowledgement-mode-name | JMS 确认名称,其为: SESSION_TRANSACTED, CLIENT_ACKNOWLEDGE, AUTO_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE。 | AUTO_ACKNOWLEDGE | 字符串 |
| camel.component.jms.allow-additional-headers | 此选项用于允许其他标头,这些标头可能具有根据 JMS 规范无效的值。例如,一些消息系统(如 WMQ)使用前缀 JMS_IBM_MQMD_ 包含字节数组或其他无效类型的值来执行此操作。您可以用逗号指定多个标头名称,并用作通配符匹配的后缀。 | 字符串 | |
| camel.component.jms.allow-auto-wired-connection-factory | 如果没有配置连接工厂,是否从 registry 自动发现 ConnectionFactory。如果只找到一个 ConnectionFactory 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| camel.component.jms.allow-auto-wired-destination-resolver | 如果没有配置目标解析器,是否从 registry 自动发现 DestinationResolver。如果只找到一个 DestinationResolver 实例,则会使用它。这默认是启用的。 | true | 布尔值 |
| camel.component.jms.allow-null-body | 是否允许在没有正文的情况下发送消息。如果此选项为 false,且消息正文为 null,则会抛出 JMSException。 | true | 布尔值 |
| camel.component.jms.allow-reply-manager-quick-stop | 是否启用请求管理器中使用的 DefaultMessageListenerContainer,允许 DefaultMessageListenerContainer.runningAllowed 标志在 JmsConfigurationVirtualMachineisAcceptMessagesWhileStopping 时快速停止,并且 org.apache.camel.CamelContext 当前已停止。在常规 JMS 用户中默认启用这种快速停止功能,但要为回复管理器启用这个标志。 | false | 布尔值 |
| camel.component.jms.allow-serialized-headers | 控制是否包含序列化标头。仅在 transferExchange 为 true 时才适用。这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。 | false | 布尔值 |
| camel.component.jms.always-copy-message | 如果为 true,则 Camel 始终会在消息传递给发送的制作者时生成 JMS 消息副本。在某些情况下需要复制消息,如设置 replyToDestinationSelectorName 时(如果设置了 replyToDestinationSelectorName,则 Camel 会将 alwaysCopyMessage 选项设置为 true)。 | false | 布尔值 |
| camel.component.jms.artemis-consumer-priority | 通过消费者优先级,您可以确保高优先级消费者在消息处于活跃状态时收到消息。通常,连接到队列的活动消费者以轮循方式从它接收消息。当使用消费者优先级时,如果有多个具有相同高优先级的活跃用户,则消息将进行循环发送。只有高优先级消费者没有可用的信用消息或高优先级消费者接受消息时,消息才会降低优先级较低的消费者(例如,它不符合与消费者关联的任何选择器的条件)。 | 整数 | |
| camel.component.jms.artemis-streaming-enabled | 是否针对 Apache Artemis 流模式进行优化。这可减少使用带有 JMS StreamMessage 类型的 Artemis 时的内存开销。只有在使用 Apache Artemis 时,才必须启用这个选项。 | false | 布尔值 |
| camel.component.jms.async-consumer | JmsConsumer 是否异步处理交换。如果启用,JmsConsumer 可以从 JMS 队列中提取下一个消息,而上一个消息则异步处理(通过 Asynchronous Routing Engine)。这意味着消息可能没有完全严格按照顺序进行处理。如果禁用(作为默认),则在 JmsConsumer 会从 JMS 队列中提取下一个消息前,会完全处理交换。请注意,如果启用了 transacted,则 asyncConsumer=true 不会异步运行,因为事务必须同步执行(Camel 3.0 必须支持 async 事务)。 | false | 布尔值 |
| camel.component.jms.async-start-listener | 在启动路由时,是否异步启动 JmsConsumer 消息监听程序。例如,如果 JmsConsumer 无法获得连接到远程 JMS 代理的连接,那么在重试和/或故障切换时可能会阻断它。这将使 Camel 在启动路由时阻止。通过将此选项设置为 true,您将让路由启动,而 JmsConsumer 使用异步模式的专用线程连接到 JMS 代理。如果使用这个选项,请注意,如果没有建立连接,则会在 WARN 级别记录异常,使用者将无法接收消息;然后,您可以重启路由来重试。 | false | 布尔值 |
| camel.component.jms.async-stop-listener | 在停止路由时,是否异步停止 JmsConsumer 消息监听程序。 | false | 布尔值 |
| camel.component.jms.auto-startup | 指定消费者容器是否应自动启动。 | true | 布尔值 |
| camel.component.jms.autowired-enabled | 是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
| camel.component.jms.cache-level | 根据 ID 为底层 JMS 资源设置缓存级别。如需了解更多详细信息,请参阅 cacheLevelName 选项。 | 整数 | |
| camel.component.jms.cache-level-name | 根据底层 JMS 资源的名称设置缓存级别。可能的值有:CACHE_AUTO、CACHE_CONNECTION、CACHE_CONSUMER、CACHE_NONE 和 CACHE_SESSION。默认设置为 CACHE_AUTO。如需更多信息,请参阅 Spring 文档和事务缓存级别。 | CACHE_AUTO | 字符串 |
| camel.component.jms.client-id | 设置要使用的 JMS 客户端 ID。请注意,如果指定,这个值必须是唯一的,且只能被单个 JMS 连接实例使用。它通常只适用于持久主题订阅。如果使用 Apache ActiveMQ,您可能更喜欢使用 Virtual Topics。 | 字符串 | |
| camel.component.jms.concurrent-consumers | 指定从 JMS 消耗时的默认并发消费者数量(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行 request/reply 时,选项 replyToConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 1 | 整数 |
| camel.component.jms.configuration | 使用共享的 JMS 配置。选项是 org.apache.camel.component.jms.JmsConfiguration 类型。 | JmsConfiguration | |
| camel.component.jms.connection-factory | 要使用的连接工厂。必须在组件或端点上配置连接工厂。选项是 javax.jms.ConnectionFactory 类型。 | ConnectionFactory | |
| camel.component.jms.consumer-type | 要使用的消费者类型,可以是 Simple、Default 或 Custom 之一。消费者类型决定要使用的 Spring JMS 侦听器。默认将使用 org.springframework.jms.listener.DefaultMessageListenerContainer,Simple 将使用 org.springframework.jms.listener.SimpleMessageListenerContainer。指定 Custom 时,由 messageListenerContainerFactory 选项定义的 MessageListenerContainerFactory 将决定要使用的 org.springframework.jms.listener.AbstractMessageListenerContainer。 | ConsumerType | |
| camel.component.jms.correlation-property | 当使用 InOut 交换模式时,使用此 JMS 属性而不是 JMSCorrelationID JMS 属性来关联消息。如果设置消息仅针对此属性 JMSCorrelationID 属性的值关联,则将忽略且未由 Camel 设置。 | 字符串 | |
| camel.component.jms.default-task-executor-type | 指定在 DefaultMessageListenerContainer 中使用哪些默认 TaskExecutor 类型,用于消费者端点和制作者端点的 ReplyTo consumer。可能的值: SimpleAsync (使用 Spring 的 SimpleAsyncTaskExecutor)或 ThreadPool (使用 Spring 的 ThreadPoolTaskExecutor 带有最佳值 - 缓存线程池)。如果没有设置,则默认为之前的行为,它将缓存线程池用于消费者端点,而 SimpleAsync 用于回复用户。建议使用 ThreadPool 来减少弹性配置中线程垃圾箱,同时动态增加和减少并发用户。 | DefaultTaskExecutorType | |
| camel.component.jms.delivery-delay | 设置用于发送 JMS 发送调用的交付延迟。这个选项需要 JMS 2.0 兼容代理。 | -1 | Long |
| camel.component.jms.delivery-mode | 指定要使用的交付模式。可能的值是由 javax.jms.DeliveryMode 定义的值。NON_PERSISTENT = 1 和 PERSISTENT = 2。 | 整数 | |
| camel.component.jms.delivery-persistent | 指定默认使用持久性交付。 | true | 布尔值 |
| camel.component.jms.destination-resolver | 一个可插拔的 org.springframework.jms.support.destination.DestinationResolver,供您使用自己的解析器(例如,在 JNDI registry 中查找实际目的地)。选项是一个 org.springframework.jms.support.destination.DestinationResolver 类型。 | DestinationResolver | |
| camel.component.jms.disable-reply-to | 指定 Camel 是否忽略消息中的 JMSReplyTo 标头。如果为 true,Camel 不会向 JMSReplyTo 标头中指定的目的地发送回复。如果您希望 Camel 从路由中消耗,并且您不希望 Camel 自动发送回复消息,则可以使用此选项,因为代码中的另一个组件处理回复消息。如果要在不同的消息代理之间将 Camel 用作代理,并且希望将消息从一个系统路由到另一个系统,也可以使用此选项。 | false | 布尔值 |
| camel.component.jms.disable-time-to-live | 使用这个选项强制禁用时间。例如,当您通过 JMS 进行请求/回复时,Camel 默认使用 requestTimeout 值作为发送的消息的时间。问题是,发送者和接收器系统必须同步其时钟,因此它们正在同步。这并非始终易于归档。因此,您可以使用 disableTimeToLive=true 来不设置发送消息上的生存时间。然后,消息不会在接收器系统中过期。如需了解更多详细信息,请参见以下部分关于生存时间。 | false | 布尔值 |
| camel.component.jms.durable-subscription-name | 用于指定持久主题订阅的可配置订阅者名称。还必须配置 clientId 选项。 | 字符串 | |
| camel.component.jms.eager-loading-of-properties | 加载消息时立即启用 JMS 属性和有效负载的 eager 加载,因为 JMS 属性可能并不是必需的,但有时可能会捕获与底层 JMS 提供程序和使用 JMS 属性的早期问题。另请参阅选项 eagerPoisonBody。 | false | 布尔值 |
| camel.component.jms.eager-poison-body | 如果启用了 eagerLoadingOfProperties,并且 JMS 消息有效负载(JMS 正文或 JMS 属性)是 poison (无法读取/映射),然后将这个文本设置为消息正文,因此可以处理消息( poison 的原因)已作为交换异常保存。这可以通过设置 eagerPoisonBody=false 来关闭。另请参阅 eagerLoadingOfProperties 选项。 | Poison JMS 消息,因为 $\{exception.message} | 字符串 |
| camel.component.jms.enabled | 是否启用 jms 组件的自动配置。这默认是启用的。 | 布尔值 | |
| camel.component.jms.error-handler | 指定在处理消息时引发任何未发现异常时要调用的 org.springframework.util.ErrorHandler。默认情况下,如果没有配置错误处理程序,则这些例外将在 WARN 级别记录。您可以配置日志记录级别,以及是否应使用 errorHandlerLoggingLevel 和 errorHandlerLogStack Trace 选项记录堆栈追踪。这样可以更容易配置,而不是需要对自定义错误处理程序进行代码。选项是一个 org.springframework.util.ErrorHandler 类型。 | ErrorHandler | |
| camel.component.jms.error-handler-log-stack-trace | 允许通过默认错误处理程序来控制是否应记录 stacktraces。 | true | 布尔值 |
| camel.component.jms.error-handler-logging-level | 允许为日志记录 uncaught 异常配置默认 errorHandler 日志记录级别。 | LoggingLevel | |
| camel.component.jms.exception-listener | 指定针对任何底层 JMS 异常通知的 JMS Exception Listener。选项是 javax.jms.ExceptionListener 类型。 | ExceptionListener | |
| camel.component.jms.explicit-qos-enabled | 设置在发送消息时使用 deliveryMode、priority 或 timeToLive 数量服务。这个选项基于 Spring 的 JmsTemplate。deliveryMode、priority 和 timeToLive 选项应用到当前的端点。这与 preserveMessageQos 选项(按消息粒度运行)相反,从 Camel In 消息标头中读取 QoS 属性。 | false | 布尔值 |
| camel.component.jms.expose-listener-session | 指定在消耗消息时是否应公开监听程序会话。 | false | 布尔值 |
| camel.component.jms.force-send-original-message | 当使用 mapJmsMessage=false Camel 时,如果在路由中涉及标头(get 或 set),则会创建一个新的 JMS 消息来发送到新的 JMS 目的地。将此选项设置为 true,以强制 Camel 发送收到的原始 JMS 消息。 | false | 布尔值 |
| camel.component.jms.format-date-headers-to-iso8601 | 根据 ISO 8601 标准设置 JMS 日期属性是否应格式化。 | false | 布尔值 |
| camel.component.jms.header-filter-strategy | 使用自定义 org.apache.camel.spi.HeaderFilterStrategy 将标头过滤到或从 Camel 消息过滤。选项是一个 org.apache.camel.spi.HeaderFilterStrategy 类型。 | HeaderFilterStrategy | |
| camel.component.jms.idle-consumer-limit | 指定任何给定时间允许闲置的用户数量的限值。 | 1 | 整数 |
| camel.component.jms.idle-task-execution-limit | 指定接收任务闲置执行的限制,不会在其执行中收到任何消息。如果达到这个限制,任务将关闭并将接收给其他执行任务(在动态调度时;请参阅 maxConcurrentConsumers 设置)。Spring 提供了额外的文档。 | 1 | 整数 |
| camel.component.jms.include-all-j-m-s-x-properties | 在从 JMS 到 Camel Message 映射时,是否包含所有 JMSXxxx 属性。把它设置为 true 将包括 JMSXAppID 和 JMSXUserID 等属性。注:如果您使用自定义 headerFilterStrategy,则不会应用这个选项。 | false | 布尔值 |
| camel.component.jms.include-sent-j-m-s-message-i-d | 仅在使用 InOnly 发送到 JMS 目的地时适用(例如触发和忘记)。启用此选项将增强 Camel Exchange 与 JMS 客户端在消息发送到 JMS 目的地时使用的实际 JMSMessageID。 | false | 布尔值 |
| camel.component.jms.jms-key-format-strategy | 编码和解码 JMS 密钥的可插拔策略,以便它们符合 JMS 规范。Camel 提供两个开箱即用的实现:default 和 passthrough。默认策略将安全地使用句点和连字符(. 和 -)。passthrough 策略将密钥保留原样。可用于不负责 JMS 标头密钥是否包含非法字符的 JMS 代理。您可以自行提供 org.apache.camel.component.jms.JmsKeyFormatStrategy 的实现,并使用 sVirt 表示法引用它。 | JmsKeyFormatStrategy | |
| camel.component.jms.jms-message-type | 允许您强制使用特定的 javax.jms.Message 实现来发送 JMS 消息。可能的值有:Bytes, Map, Object, Stream, text。默认情况下,Camel 会决定要从 In body 类型使用哪个 JMS 消息类型。这个选项允许您指定它。 | JmsMessageType | |
| camel.component.jms.lazy-create-transaction-manager | 如果为 true,Camel 将创建一个 JmsTransactionManager,如果没有在选项 transacted=true 时注入 transactionManager。 | true | 布尔值 |
| camel.component.jms.lazy-start-producer | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
| camel.component.jms.map-jms-message | 指定 Camel 是否应该自动将收到的 JMS 消息映射到合适的有效负载类型,如 javax.jms.TextMessage 到 String 等。 | true | 布尔值 |
| camel.component.jms.max-concurrent-consumers | 指定从 JMS 消耗时的最大并发消费者数(而不是通过 JMS 请求/回复)。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。当通过 JMS 执行请求/回复时,选项 replyToMaxConcurrentConsumers 用于控制回复消息监听器上的并发消费者数量。 | 整数 | |
| camel.component.jms.max-messages-per-task | 每个任务的消息数量。-1 代表没有限制。如果您为并发消费者使用范围(例如 min max),则可以使用此选项将值设为 100,以控制消费者在需要较少的工作时可以缩小的速度。 | -1 | 整数 |
| camel.component.jms.message-converter | 使用自定义 Spring org.springframework.jms.support.converter.MessageConverter,以便您可以控制如何映射到 javax.jms.Message。选项是一个 org.springframework.jms.support.converter.MessageConverter 类型。 | MessageConverter | |
| camel.component.jms.message-created-strategy | 使用给定的 MessageCreatedStrategy,当 Camel 发送 JMS 消息时,Camel 创建 javax.jms.Message 对象的新实例。选项是一个 org.apache.camel.component.jms.MessageCreatedStrategy 类型。 | MessageCreatedStrategy | |
| camel.component.jms.message-id-enabled | 发送时,指定是否应添加消息 ID。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将消息 ID 设置为 null;如果提供程序忽略提示,则必须将消息 ID 设置为其普通唯一值。 | true | 布尔值 |
| camel.component.jms.message-listener-container-factory | MessageListenerContainerFactory 的 registry ID,用于决定要使用消息的 org.springframework.jms.listener.AbstractMessageListenerContainer。设置此项将自动将 consumerType 设置为 Custom。选项是 org.apache.camel.component.jms.MessageListenerContainerFactory 类型。 | MessageListenerContainerFactory | |
| camel.component.jms.message-timestamp-enabled | 指定在发送消息时是否默认启用时间戳。这只是对 JMS 代理的提示。如果 JMS 提供程序接受此提示,则这些消息必须将时间戳设置为零;如果提供程序忽略提示,则必须将时间戳设置为其正常值。 | true | 布尔值 |
| camel.component.jms.password | 与 ConnectionFactory 一起使用的密码。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| camel.component.jms.preserve-message-qos | 如果要使用消息中指定的 QoS 设置来发送消息,而不是 JMS 端点上的 QoS 设置。以下三个标头被视为 JMSPriority、JMSDeliveryMode 和 JMSExpiration。您可以提供全部或仅提供其中一些。如果没有提供,Camel 将回退到使用端点中的值。因此,在使用此选项时,标头会覆盖端点中的值。与之相反,clearQosEnabled 选项将仅使用端点上设置的选项,而不使用来自消息标头中的值。 | false | 布尔值 |
| camel.component.jms.priority | 大于 1 的值指定发送时的消息优先级(其中 1 是最低优先级,9 是最高)。必须启用 explicitQosEnabled 选项才能使此选项生效。 | 4 | 整数 |
| camel.component.jms.pub-sub-no-local | 指定是否禁止自己连接发布的消息的发送。 | false | 布尔值 |
| camel.component.jms.queue-browse-strategy | 在浏览队列时使用自定义 QueueBrowseStrategy。选项是一个 org.apache.camel.component.jms.QueueBrowseStrategy 类型。 | QueueBrowseStrategy | |
| camel.component.jms.receive-timeout | 接收消息的超时时间(以毫秒为单位)。选项是一个长类型。 | 1000 | Long |
| camel.component.jms.recovery-interval | 指定恢复尝试之间的间隔,即当连接被刷新时,以毫秒为单位。默认值为 5000 ms,即 5 秒。选项是一个长类型。 | 5000 | Long |
| camel.component.jms.reply-to | 提供显式 ReplyTo 目的地(覆盖消费者中 Message.getJMSReplyTo ()的所有传入值)。 | 字符串 | |
| camel.component.jms.reply-to-cache-level-name | 在执行请求/通过 JMS 时,按名称为回复消费者设置缓存级别。这个选项仅在使用固定回复队列(而非临时)时才适用。Camel 默认将使用:CACHE_CONSUMER 用于专用或共享的 w/ replyToSelectorName。和 CACHE_SESSION 用于没有 replyToSelectorName 的共享。IBM WebSphere 等 JMS 代理可能需要设置 replyToCacheLevelName=CACHE_NONE 才能正常工作。注:如果使用临时队列,则不允许使用更高的值,如 CACHE_CONSUMER 或 CACHE_SESSION。 | 字符串 | |
| camel.component.jms.reply-to-concurrent-consumers | 指定执行请求/通过 JMS 回复时的默认并发消费者数量。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 1 | 整数 |
| camel.component.jms.reply-to-delivery-persistent | 指定是否默认使用持久性交付进行回复。 | true | 布尔值 |
| camel.component.jms.reply-to-destination-selector-name | 使用要使用的固定名称设置 JMS Selector,以便您可以在使用共享队列(也就是说,如果您不使用临时回复队列)时过滤来自其他回复的回复。 | 字符串 | |
| camel.component.jms.reply-to-max-concurrent-consumers | 指定在通过 JMS 使用请求/回复时的最大并发消费者数。另请参阅 maxMessagesPerTask 选项来控制线程的动态扩展/缩减。 | 整数 | |
| camel.component.jms.reply-to-on-timeout-max-concurrent-consumers | 指定使用请求/通过 JMS 时超时时继续路由的最大并发消费者数。 | 1 | 整数 |
| camel.component.jms.reply-to-override | 在 JMS 消息中提供显式 ReplyTo 目的地,这将覆盖 replyTo 的设置。如果要将消息转发到远程队列,并从 ReplyTo 目的地接收回复消息,这非常有用。 | 字符串 | |
| camel.component.jms.reply-to-same-destination-allowed | JMS 使用者是否允许向消费者使用的同一目的地发送回复消息。这可防止出现无限循环,并通过消耗并向自己发送相同的消息。 | false | 布尔值 |
| camel.component.jms.reply-to-type | 允许明确指定在执行 request/reply 时要用于 replyTo 队列的策略类型。可能的值有:Temporary、share 或 Exclusive。默认情况下,Camel 将使用临时队列。但是,如果配置了 replyTo,则默认使用 Shared。这个选项允许您使用专用队列而不是共享的队列。如需了解更多详细信息,请参阅 Camel JMS 文档,特别是在集群环境中运行时的影响的备注,以及共享回复队列的性能低于其 alternatives Temporary 和 Exclusive。 | ReplyToType | |
| camel.component.jms.request-timeout | 使用 InOut Exchange Pattern (毫秒)时等待回复的超时时间。默认值为 20 秒。您可以包含标头 CamelJmsRequestTimeout 来覆盖此端点配置的超时值,因此具有每个消息独立的超时值。另请参阅 requestTimeoutCheckerInterval 选项。选项是一个长类型。 | 20000 | Long |
| camel.component.jms.request-timeout-checker-interval | 配置 Camel 在执行请求/通过 JMS 回复时应检查超时交换的频率。默认情况下,Camel 会每秒检查一次。但是,如果发生超时时,您必须更快地响应,那么您可以降低这个间隔,以便更频繁地检查。超时由选项 requestTimeout 决定。选项是一个长类型。 | 1000 | Long |
| camel.component.jms.selector | 设置要使用的 JMS 选择器。 | 字符串 | |
| camel.component.jms.stream-message-type-enabled | 设置 StreamMessage 类型是否已启用。流类型的消息有效负载(如 files、InStream 等)将通过作为 BytesMessage 或 StreamMessage 发送。此选项控制将使用哪种类型。默认情况下,使用 BytesMessage 来强制整个消息有效负载读取到内存中。通过启用此选项,消息有效负载以块的形式读取到内存中,然后每个块都会写入 StreamMessage,直到没有更多数据。 | false | 布尔值 |
| camel.component.jms.subscription-durable | 设置是否使订阅持久化。可使用的 durable 订阅名称通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册持久订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。 | false | 布尔值 |
| camel.component.jms.subscription-name | 设置要创建的订阅名称。在带有共享或可升级订阅的主题(公共域)中应用。订阅名称需要在此客户端的 JMS 客户端 ID 中唯一。default 是指定消息监听程序的类名称。注: 每个订阅都只允许 1 个并发消费者(这是此消息侦听器容器的默认值),但一个共享订阅(需要 JMS 2.0)除外。 | 字符串 | |
| camel.component.jms.subscription-shared | 设置是否共享订阅。可以使用的共享订阅名称可以通过 subscriptionName 属性指定。默认值为 false。把它设置为 true 以注册共享订阅,通常与 subscriptionName 值结合使用(除非您的消息监听程序类名称足以满足订阅名称)。请注意,共享的订阅也可能是危险的,因此此标志也可以与订阅相结合。仅在侦听主题(pub-sub 域)时有意义,因此此方法也会切换 pubSubDomain 标志。需要 JMS 2.0 兼容消息代理。 | false | 布尔值 |
| camel.component.jms.synchronous | 设置是否应严格使用同步处理。 | false | 布尔值 |
| camel.component.jms.task-executor | 允许您指定自定义任务执行器以使用消息。选项是一个 org.springframework.core.task.TaskExecutor 类型。 | TaskExecutor | |
| camel.component.jms.test-connection-on-startup | 指定是否在启动时测试连接。这样可确保 Camel 启动所有 JMS 用户与 JMS 代理的有效连接。如果无法授予连接,则 Camel 会在启动时抛出异常。这样可确保 Camel 没有使用失败的连接启动。JMS producer 也经过测试。 | false | 布尔值 |
| camel.component.jms.time-to-live | 发送消息时,指定消息的时间到时间(以毫秒为单位)。 | -1 | Long |
| camel.component.jms.transacted | 指定是否使用转换模式。 | false | 布尔值 |
| camel.component.jms.transacted-in-out | 指定 InOut 操作(请求回复)是否默认使用 transacted 模式,如果此标志被设置为 true,则 Spring JmsTemplate 将把 sessionTransacted 设置为 true,而 confirmMode 作为转换用于 InOut 操作。请注意:在 JTA 事务中,传递给 createQueue 的参数不会考虑 createTopic 方法。根据 Java EE 事务上下文,容器对这些值做出自己的决策。类似地,这些参数不会考虑本地管理的事务,因为 Spring JMS 在这种情况下在现有 JMS 会话上运行。在受管事务外运行时,将此标志设置为 true 将使用简短的本地 JMS 事务,并在存在受管事务(除 XA 事务之外)时同步的本地 JMS 事务。这与主事务一起管理本地 JMS 事务(可能是原生 JDBC 事务)的影响,在主事务后 JMS 事务提交右侧的 JMS 事务。 | false | 布尔值 |
| camel.component.jms.transaction-manager | 要使用的 Spring 事务管理器。选项是一个 org.springframework.transaction.platformTransactionManager 类型。 | PlatformTransactionManager | |
| camel.component.jms.transaction-name | 要使用的事务的名称。 | 字符串 | |
| camel.component.jms.transaction-timeout | 如果使用转换模式,事务的超时值(以秒为单位)。 | -1 | 整数 |
| camel.component.jms.transfer-exception | 如果启用了且您使用 Request Reply messaging (InOut),并且 Exchange 失败在消费者端,则原因例外将作为 javax.jms.ObjectMessage 发回的响应。如果客户端是 Camel,则返回的例外将重新箭头。这样,您可以使用 Camel JMS 作为路由中的桥接 - 例如,使用持久性队列来启用强大的路由。请注意,如果您也启用了 transferExchange,这个选项将具有优先权。caught 异常需要可以被序列化。消费者端的原始例外可以嵌套在外部异常中,如 org.apache.camel.RuntimeCamelException。请谨慎使用它,因为数据正在使用 Java 对象序列化,要求接收者在类级别反序列化数据,这会强制在生产者和消费者之间进行强校准。 | false | 布尔值 |
| camel.component.jms.transfer-exchange | 您可以在有线线上传输交换,而不只是正文和标头。以下字段会被传输: 在 body, Out body, Fault body, In headers, Out headers, Fault header, Exchange properties, exchange exception.这要求对象可以序列化。Camel 将排除任何不可序列化的对象,并将它记录在 WARN 级别。您必须在制作者和消费者端启用这个选项,因此 Camel 知道有效负载是一个交换,而不是常规有效负载。请谨慎使用它,因为数据正在使用 Java 对象序列化,并且要求接收器能够在类级别上反序列化数据,这会强制在需要使用兼容 Camel 版本的生产者和消费者之间进行强大的协调。 | false | 布尔值 |
| camel.component.jms.use-message-i-d-as-correlation-i-d | 指定 JMSMessageID 是否应该始终用作 InOut 消息的 JMSCorrelationID。 | false | 布尔值 |
| camel.component.jms.username | 与 ConnectionFactory 一起使用的用户名。您还可以直接在 ConnectionFactory 上配置用户名/密码。 | 字符串 | |
| camel.component.jms.wait-for-provision-correlation-to-be-updated-counter | 在执行 request/reply over JMS 以及启用了 useMessageIDAsCorrelationID 时,等待 provisional correlation id 被更新到实际关联 ID 的次数。 | 50 | 整数 |
| camel.component.jms.wait-for-provision-correlation-to-be-updated-thread-sleeping-time | 等待置备关联 ID 时每次休眠的时间间隔(以秒为单位)。选项是一个长类型。 | 100 | Long |
第 32 章 JPA 复制链接链接已复制到粘贴板!
从 Camel 1.0 开始
支持生成者和消费者。
JPA 组件可让您使用 EJB 3 的 Java Persistence 架构(DSL)从持久性存储存储和检索 Java 对象。Java Persistence 架构(DSL)是一种标准接口层,它打包 Object/Relational Mapping (ORM)产品,如 Open the Hibernate, Hibernate, TopLink。
将以下依赖项添加到此组件的 pom.xml 中:
32.1. 发送到端点 复制链接链接已复制到粘贴板!
您可以通过将 Java 实体 Bean 发送到 JPA producer 端点,将其存储在数据库中。In 消息正文假定为实体 Bean (即,包含 @Entity 注解的 POJO)或实体 Bean 集合或数组。
如果正文是实体列表,请使用 entityType=java.util.List 作为传递给制作者端点的配置。
如果正文不包含以上列出的类型之一,请在端点首先执行必要的转换前放置 Message Translator。
您还可以将名为Query 的查询、名为Query 或 nativeQuery 用于生成者。对于 参数的值,您可以使用简单表达式从 Message body、标头等检索参数值。这些查询可用于通过 SELECT JPQL/SQL 语句来检索一组数据,并使用 UPDATE/DELETE JPQL/SQL 语句执行批量更新/删除。请注意,如果您执行 名为Query 的 UPDATE/DELETE,则您需要将 useExecuteUpdate 指定为 true,因为 camel 不会查看命名的 查询 与查询和 原生Query 不同。
32.2. 从端点消耗 复制链接链接已复制到粘贴板!
从 JPA consumer 端点消耗消息会删除(或更新)数据库中的实体 Bean。这可让您将数据库表用作逻辑队列:消费者从队列中获取消息,然后删除/更新它们以逻辑地将其从队列中删除。
如果您不想在处理实体 Bean 时删除它(在路由完成后),您可以在 URI 中指定 consumeDelete=false。这将导致实体处理每个轮询。
如果您想对实体执行一些更新,将其标记为已处理(例如,从将来的查询中排除它),您可以使用 @Consumed 注解方法,它会在实体 Bean 被处理时调用它。
您可以使用 @PreConsumed,它会在处理前在实体 bean 上调用(在路由之前)。
如果您消耗了大量行(100K+),且遇到 OutOfMemory 问题,您应该将 maxResults 设置为 sensable 值。
32.3. URI 格式 复制链接链接已复制到粘贴板!
jpa:entityClassName[?options]
jpa:entityClassName[?options]
对于发送到端点,entityClassName 是可选的。如果指定,它可以帮助 Type Converter来确保正文是正确的类型。
为消耗,entityClassName 是必须的。
32.4. 配置选项 复制链接链接已复制到粘贴板!
Camel 组件在两个独立级别上配置:
- 组件级别
- 端点级别
32.4.1. 配置组件选项 复制链接链接已复制到粘贴板!
组件级别是最高级别,它包含端点继承的常规配置。例如,一个组件可能具有安全设置、用于身份验证的凭证、用于网络连接的 url 等等。
某些组件只有几个选项,其他组件可能会有许多选项。由于组件通常已配置了常用的默认值,因此通常只需要在组件上配置几个选项,或者根本不需要配置任何选项。
可以在配置文件(application.properties|yaml)中使用 组件 DSL 配置组件,也可直接使用 Java 代码完成。
32.4.2. 配置端点选项 复制链接链接已复制到粘贴板!
您发现自己在端点上配置了一个,因为端点通常有许多选项,允许您配置您需要的端点。这些选项被分别分类为:端点作为消费者(来自)被使用,和作为生成者(到)使用,或被两者使用。
配置端点通常在端点 URI 中作为路径和查询参数直接进行。您还可以使用 Endpoint DSL 作为配置端点的安全方法。
在配置选项时,最好使用 Property Placeholders,它不允许硬编码 URL、端口号、敏感信息和其他设置。换句话说,占位符允许从您的代码外部配置,并提供更多灵活性和重复使用。
以下两节列出了所有选项,首为于组件,后跟端点。
32.4.3. 组件选项 复制链接链接已复制到粘贴板!
JPA 组件支持 9 个选项,如下所列。
| Name | 描述 | 默认值 |
|---|