第 33 章 XQuery
概述
Xquery 最初被认为是 XML 表单中存储的数据的查询语言。当消息采用 XML 格式时,XQuery 语言允许您选择当前消息的部分。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-saxon
组件由 EAP 上的 Camel (Wildfly Camel)框架支持,该框架在 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 消息的正文 |
|
| IN 消息标头,其键为 key |
|
| 键为键的 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>