第 33 章 XQuery

概述

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

Java 语法

您可以以多种方式将 XQuery 表达式传递给 xquery （）。对于简单表达式，您可以将 XQuery 表达式作为环境变量(java.lang.String)传递。对于较长的 XQuery 表达式，您可能需要将表达式存储在文件中，然后通过传递 java.io.File 参数或 java.net.URL 参数向 overloaded 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 组件，该组件在红帽 JBoss 企业应用平台(JBoss EAP)容器上提供简化的部署模型。

静态导入

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

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

变量

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

表 33.1. XQuery 变量

变量类型描述

exchange

Exchange

当前交换

in.body

对象

IN 消息的正文

out.body

对象

OUT 消息的正文

in.headers.key

对象

IN 消息标头，其密钥是 密钥

out.headers.键

对象

OUT 消息标头，密钥是密钥

key

对象

密钥密钥的 Exchange 属性

Example

例 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>