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