第 33 章 XQuery

概述

Xquery 最初被设计为数据库中以 XML 形式存储的数据的查询语言。XQuery 语言允许您在消息使用 XML 格式时选择当前消息的部分。XQuery 是 XPath 语言的超集；因此，任何有效的 XPath 表达式也是有效的 XQuery 表达式。

Java 语法

您可以通过几种方法将 XQuery 表达式传递给 xquery （）。对于简单表达式，您可以将 XQuery 表达式作为字符串传递(java.lang.String)。对于较长的 XQuery 表达式，您可能需要将表达式存储在文件中，然后通过将 java.io.File 参数或 java.net.URL 参数传递给超载 xquery （） 方法来引用。XQuery 表达式隐式地操作消息内容，并因此返回节点集。根据上下文，返回值解释为 predicate （空节点集被解释为 false）或表达式。

添加 Saxon 模块

要在路由中使用 XQuery，您需要将对 camel-saxon 的依赖添加到项目中，如 例 33.1 “添加 camel-saxon 依赖项” 所示。

例 33.1. 添加 camel-saxon 依赖项

<!-- Maven POM File -->
...
<dependencies>
  ...
  <dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-saxon</artifactId>
    <version>${camel-version}</version>
  </dependency>
  ...
</dependencies>

Camel on EAP 部署

Camel 在 EAP (Wildfly Camel)框架上支持 camel-saxon 组件，它在 Red Hat JBoss Enterprise Application Platform (JBoss EAP)容器上提供了简化的部署模型。

静态导入

要在应用程序代码中使用 xquery （） 静态方法，请在 Java 源文件中包含以下导入语句： 

import static org.apache.camel.component.xquery.XQueryBuilder.xquery;

变量

表 33.1 “xquery 变量” 列出使用 XQuery 时可访问的变量。

表 33.1. xquery 变量

变量类型描述

交换

Exchange

当前的交换

in.body

对象

IN 消息的正文

out.body

对象

OUT 消息的正文

in.headers.key

对象

其键为 key的 IN 消息标头

out.headers.key

对象

其键为 key的 OUT 消息标头

key

对象

其键是 key的 Exchange 属性

示例

例 33.2 “使用 XQuery 的路由” 显示使用 XQuery 的路由。

例 33.2. 使用 XQuery 的路由

<camelContext>
  <route>
    <from uri="activemq:MyQueue"/>
    <filter>
      <language langauge="xquery">/foo:person[@name='James']</language>
      <to uri="mqseries:SomeOtherQueue"/>
    </filter>
  </route>
</camelContext>