第 377 章 XQuery 组件
从 Camel 版本 1.0 开始提供
Camel 支持 XQuery 允许在 DSL 或 Xml 配置 中使用 Expression 或 Predicate。例如，您可以使用 XQuery 在 Message Filter 中创建 Predicate，或作为 Recipient List 的 Expression。
377.1. 选项
XQuery 组件支持 4 个选项，如下所列。
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| moduleURIResolver (advanced) | 使用自定义 ModuleURIResolver | ModuleURIResolver | |
| configuration (advanced) | 使用自定义 Saxon 配置 | Configuration | |
| configurationProperties (advanced) | 设置自定义 Saxon 配置属性 | Map | |
| resolveProperty Placeholders (advanced) | 启动时组件是否应解析自身上的属性占位符。只有属于 String 类型的属性才能使用属性占位符。 | true | 布尔值 |
XQuery 端点使用 URI 语法进行配置：
xquery:resourceUri
使用以下路径和查询参数：
377.1.1. 路径参数(1 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| resourceUri | 需要从 classpath 或文件系统加载的模板名称 | 字符串 |
377.1.2. 查询参数(31 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| allowStAX (common) | 是否允许使用 StAX 模式 | false | 布尔值 |
| headerName (common) | 使用 Camel Message 标头作为输入源，而不是 Message body。 | 字符串 | |
| namespacePrefixes (common) | 允许控制用于一组命名空间映射的命名空间前缀 | Map | |
| resultsFormat (common) | 要使用哪些输出结果 | DOM | ResultFormat |
| resultType (common) | 将定义用作类的输出结果 | 类 | |
| stripsAllWhiteSpace (common) | 是否剥离所有空格 | true | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序，这意味着当消费者试图选择传入消息或类似信息时发生异常，现在将作为消息处理并由路由 Error Handler 处理。默认情况下，使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况，该处理程序将被记录在 WARN 或 ERROR 级别，并忽略。 | false | 布尔值 |
| sendEmptyMessageWhenIdle (consumer) | 如果轮询使用者没有轮询任何文件，您可以启用此选项来发送空消息（无正文）。 | false | 布尔值 |
| exceptionHandler (consumer) | 要让使用者使用自定义例外处理程序：请注意，如果启用了 bridgeErrorHandler 选项，则此选项不使用。默认情况下，消费者将处理异常，其记录在 WARN 或 ERROR 级别中，并忽略。 | ExceptionHandler | |
| exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | ExchangePattern | |
| pollStrategy (consumer) | 可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理，然后再创建交换并在 Camel 中路由。 | PollingConsumerPoll Strategy | |
| configuration (advanced) | 使用自定义 Saxon 配置 | Configuration | |
| configurationProperties (advanced) | 设置自定义 Saxon 配置属性 | Map | |
| moduleURIResolver (advanced) | 使用自定义 ModuleURIResolver | ModuleURIResolver | |
| 参数 (advanced) | 其他参数 | Map | |
| properties (advanced) | 配置序列化参数的属性 | Properties | |
| staticQueryContext (advanced) | 使用自定义 Saxon StaticQueryContext | StaticQueryContext | |
| 同步 (advanced) | 设置是否应严格使用同步处理，或者 Camel 允许使用异步处理（如果受支持）。 | false | 布尔值 |
| backoffErrorThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询（因为某些错误）的数量。 | int | |
| backoffIdleThreshold (scheduler) | 在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。 | int | |
| backoffMultiplier (scheduler) | 如果一行中有很多后续空闲/errors，则让调度的轮询消费者避退。然后，倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时，还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。 | int | |
| delay (scheduler) | 下一次轮询前的时间（毫秒）。您还可以使用单位来指定时间值，如 60s (60 秒)、5m30s (5 分钟和 30 秒)和 1h (1 小时)。 | 500 | long |
| greedy (scheduler) | 如果启用了 greedy，如果上一个运行轮询 1 或更多消息，则 ScheduledPollConsumer 将立即运行。 | false | 布尔值 |
| initialDelay (scheduler) | 第一次轮询开始前的毫秒。您还可以使用单位来指定时间值，如 60s (60 秒)、5m30s (5 分钟和 30 秒)和 1h (1 小时)。 | 1000 | long |
| runLoggingLevel (scheduler) | 消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。 | TRACE | LoggingLevel |
| scheduledExecutorService (scheduler) | 允许配置用于消费者的自定义/共享线程池。默认情况下，每个使用者都有自己的单线程线程池。 | ScheduledExecutor Service | |
| scheduler (scheduler) | 使用 camel-spring 或 camel-quartz2 组件的 cron 调度程序 | none | ScheduledPollConsumer Scheduler |
| schedulerProperties (scheduler) | 在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。 | Map | |
| startScheduler (scheduler) | 调度程序是否应自动启动。 | true | 布尔值 |
| timeUnit (scheduler) | initialDelay 和 delay 选项的时间单位。 | MILLISECONDS | TimeUnit |
| useFixedDelay (scheduler) | 控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。 | true | 布尔值 |
