第 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 时可以访问的变量。
变量 | 类型 | 描述 |
---|---|---|
|
| 当前交换 |
|
| IN 消息的正文 |
|
| OUT 消息的正文 |
|
| IN 消息标头,其密钥是 密钥 |
|
| 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>