Berkeley DB Xml 入门系列之一： 简介与"query"示例程序详解

(本文同时发表于www.bdbchina.com, 转载请注明出处)

Oracle Berkeley DB XML 是一个可嵌入的开源 XML 数据库(Embedded Native Xml Database)，可基于 XQuery 访问存储在容器中的文档，并对其内容进行索引。Oracle Berkeley DB XML 构建于 Oracle Berkeley DB 之上，并继承了其丰富的特性和属性(包括 环境，各个级别的事务，Replication等)。与Oracle Berkeley DB 一样，它通过应用程序运 行，无需人为管理。Oracle Berkeley DB XML 主要功能模块包括有文档分析器、XML索引 器以及 XQuery 引擎，实现了最快速、最高效的Xml数据检索。

本文是Berkeley DB Xml入门系列文章的第一篇，此系列将会详细介绍Berkeley DB Xml的 使用和编程，并探讨一些Berkeley DB Xml 编程中的高级内容，欢迎大家关注。在这篇文章里面我们通过一个最简单查询例子，介绍最基本Berkeley DB Xml的编程流程，并介绍 Berkeley DB Xml 中的一些基本概念。<!--more-->

本示例程序(example/cxx/basic/query.cpp)使用C++编写，相应的Java版本可在安装包的example/java/basic目录下找到。
/* * ******* * * 这是一个最简单的Berkeley DB Xml程序，描述了如何进行查询和结果处理 * * 这个程序展示了以下几个方面内容: * 初始化Berkeley DB Xml * 创建XmlContainer * 插入Xml文档 * 创建XQuery查询和执行查询 * 在查询中如何使用变量 * 结果处理 * * */ #include <iostream> #include <dbxml/DbXml.hpp> using namespace DbXml; int main(int argc, char **argv) { // 定义XmlContainer的文件名 std::string containerName = "people.dbxml"; // 定义Xml文档内容 std::string content = "<people><person><name>joe</name></person><person><name>mary</name></person></people>"; // 定义Xml文档名字，每个存储于XmlContainer中的Xml文档必须有唯一的名字 std::string docName = "people"; // 定义XQuery查询语句，用来查询姓名等于某个值的person结点, 注意$name是一 // 个XQuery变量，可以赋值 std::string queryString = "collection('people.dbxml')/people/person[name=$name]"; try { // 所有的BDB XML程序都需要一个XmlManager对象，XmlManager用于管 // 理BDB XML的各种对象资源 XmlManager mgr; // 检查同名Xml容器是否已经存在了，存在的话就删除 if (mgr.existsContainer(containerName)) mgr.removeContainer(containerName); // 用XmlManager创建一个XmlContainer. Berkeley DB Xml把所有的Xml // 数据，索引以及其他相关内容存储在XmlContainer中，XmlContainer // 在磁盘上的表现就是一个.dbxml结尾的文件，当然也可以以其他后缀 // 作为文件名结尾。我们也可以使用已经创建好的XmlContainer。 XmlContainer cont = mgr.createContainer(containerName); // 修改container需要创建一个XmlUpdateContext对象 XmlUpdateContext uc = mgr.createUpdateContext(); // 插入一个Xml文档，提供文档名文档内容，和一个XmlUpdateContext对象 // 插入后Xml文档就会以Berkeley DB Xml的格式存储于XmlContainer中 cont.putDocument(docName, content, uc); // 如果是查询则需要创建一个XmlQueryContext对象 XmlQueryContext qc = mgr.createQueryContext(); // 可以在XmlQueryContext对象中设置需要查询的变量值 qc.setVariableValue("name", "mary"); // 接着创建一个XmlQueryExpression对象，用来进行查询，用前面创 // 建的XmlQueryContext对象做为参数 XmlQueryExpression expr = mgr.prepare(queryString, qc); // 执行查询，返回XmlResults对象 XmlResults res = expr.execute(qc); // 可以通过XmlQueryExpression::getQuery()方法获得XQuery查询语句 // 通过XmlResults::size()方法可以知道查询的结果集大小 std::cout << "The query, '" << expr.getQuery() << "' returned " << (unsigned int) res.size() << " result(s)" << std::endl; // 处理返回的XmlResults对象， 输出他们的值 XmlValue value; std::cout << "Result: " << std::endl; while (res.next(value)) { std::cout << "t" << value.asString() << std::endl; } //异常处理， Berkeley DB Xml的所有对象如果发生异常会抛出XmlException } catch (XmlException &xe) { std::cout << "XmlException: " << xe.what() << std::endl; } return 0; }

 

本程序的运行结果是：
[ying@ying build_unix]$ ./query The query, 'collection('people.dbxml')/people/person[name=$name]' returned 1 result(s) Result: <person><name>mary</name></person>

总结
通过这个示例程序我们可以知道，Berkeley DB Xml的程序一般有一下几个步骤，创建XmlManager；创建或打开XmlContainer；创建XmlQueryExpression并执行查询；处理查询结果。读者可以尝试修改setc.setVariableValue("name", "mary")这一句，看查询 结果是否有变化。更高级的Berkeley DB Xml程序可添加事务，环境(Berkeley DB 的Environment)等等功能, 读者可以关注本博客后续文章。