1. 自建索引
2. 在wholeDocument存储模式下的压缩存储
3. Debugging API 和 debug 命令
4. 用户自定义XQuery external 函数
5. XmlResults 增强
6. 更高效的节点存储模式

接下来我们具体了解一下这些新特性：

1. 自建索引

自建索引是Berkeley DB Xml 2.5版的重大改进之一，他的主要功能是自动建立索引无需用户手动添加。在Berkeley DB XMl 2.5中，如果对XmlContainer打开了自建索引功能（通过XmlContainer.setAutoIndexing()方法 或者XmlIndexSpecification.setAutoIndexing()方法），当发现有新的叶子element结点或叶子attribute结点时，XmlContainer会对新的结点增加两个索引。 这两个索引分别是node-*-equality-string 和 node-*-equality-double(*表示结点名字)，在默认情况下自建索引功能是被打开的。

下面我们来看一个列子，看自建索引是如何生效的

ying@bdbcn3:~$ dbxml

dbxml> createcontainer test.dbxml
Creating node storage container

dbxml> putdocument 1.xml "<root><a att1='test'>test</a><b/></root>" s
Document added, name = 1.xml

dbxml> listindex
Index: node-element-equality-string node-element-equality-double for node {}:a
Index: node-attribute-equality-string node-attribute-equality-double for node {}:att1
Index: node-element-equality-string node-element-equality-double for node {}:b
Index: unique-node-metadata-equality-string for node {http://www.sleepycat.com/2002/dbxml}:name
4 indexes found.

2. whole document 模式压缩存储

在Berkeley DB Xml 2.5中对whole document存储模式添加了压缩储存功能。经过压缩可以提高文档的储存速度和降低存储空间大小。 默认情况下使用unix系统的zlib进行压缩和解压，用户也可以使用自己的压缩和解压缩算法（通过实现XmlCompression接口）。

经过测试，在存储100万个4k大小的文档的XmlContainer,启用压缩的大小为398，516k，不使用压缩的大小为893，500k，可以节省大约55%的空间。

ying@bdbcn3:~$ du -sk *.dbxml
398516  Compressed.dbxml
893500  Uncompressed.dbxml

如果用户需要使用自己的压缩算法，可以实现XmlCompression接口， 主要实现compress()方法用于压缩，decompress()方法用于解压缩。 具体例子请参考安装包中example/cxx/misc/compression.cpp或者后续文章。

3. Debugging API和debug命令

DB XML shell 增加了一个debug命令， 启动shell后键入debug命令会进入debug模式， 可以用来调试XQuery语句。

例子：

dbxml> debug "collection('test.dbxml')/root/a"

debug> help

Command Summary
---------------

backtrace     - Prints a stack trace of the currently evaluating query
break         - Sets a break point
breakpoints   - Lists the break points set
continue      - Continues execution of the query
disable       - Disables the break point indentified by the numeric argument
enable        - Enables the break point indentified by the numeric argument
optimizeFocus - Enables or disable focus optimisations
frame         - Changes the current frame
help          - Print help information.  Use 'help commandName' for extended help
lazy          - Enables or disable lazy evaluation optimisations
list          - Prints the query at the current frame
next          - Skips query execution to the end of the current sub-expression
projection    - Enables or disable document projection optimisations
query         - Executes a query in the context of the current frame
queryplan     - Prints the query plan for the expression at the current frame
quit          - Exits the debugger
run           - Runs the query. If the query is already running it will be re-started
step          - Skips query execution forward one sub-expression

debug> run
<a att1="test">test</a>

Query completed.

Debugging API调用是通过实现XmlDebugListener接口，实现此接口的各个方法可以监控XQuery执行的每个过程。Debugging API的使用可以参考example/cxx/misc/debug.cpp或者后续文章。

4. 用户自定义XQuery externl函数

新增加的XmlExternalFunction类允许用户使用C++，Java或者Python实现XQuery的external函数( 什么是XQuery external 函数)。用户只需要继承XmlExternalFunction，并实现execute()方法。 execute()方法中包括了用户需要实现函数的功能。具体例子请参考包含于发布包的example/cxx/misc/extrenalFunction.cpp, 或者这篇文章。

5. XmlResults增强

XmlResults类增加了三个方法，用来操作“离线”的XmlResults对象。
a.XmlResults.asEventWriter(), 可以通过这个方法创建一个XmlEventWriter对象。 用这个XmlEventWriter对象可以向XmlResults中写入数据创建自己需要的XmlResults

b.XmlResults.copyResults(), 通过这个方法可以拷贝生成一个持久的XmlResults对象，不会因为container关闭而失效。
c.XmlResults.concatResults()，通过这个方法可以把两个XmlResults对象连接起来形成一个新的XmlResults对象，当然返回的对象也和container的生命周期无关。
具体的使用可以参考后续文章。

6. Node存储模式增强

改进了node储存的算法，使得在node储存的模式下XmlContainer的文件大小进一步减小。

结束语

Berkeley DB Xml 2.5版是一个更好更快的版本，本系列文章将会对前5个新特性一一通过例子说明，谢谢各位同学关注。

下载

可以在这个地址http://www.oracle.com/technology/software/products/berkeley-db/xml/index.html下载最新的Berkeley DB Xml的 安装包，Linux下使用可以下载.tar.gz 或者.zip结尾的包。目前的最新版本是2.4.16， .tar.gz结尾的包的大小约为36M。我们下载.tar.gz 结尾的包作为本文的示例。

下载完后得到是这样一个文件

ying@bdbcn3:~t$ ls
dbxml-2.4.16.tar.gz

编译

解压缩

ying@bdbcn3:~$ tar zxvf dbxml-2.4.16.tar.gz

进入dbxml-2.4.16目录后可以看见有一个buildall.sh的脚本, 这个脚本就是用来编译dbxml的。可以使用–help选项查看编译选项。一些主要选项有：用 -x 指定c++ 编译器， -c指定 c编译器，要注意的是Berkeley DB Xml需要使用gnu的make程序进行编译，可以用-m 指定make程序。 我们在linux下编译的话这些选项基本不需要指定，默认即可。

ying@bdbcn3:~/dbxml-2.4.16$ ./buildall.sh –help
Usage: ./buildall.sh [options]
–help                                 print this help message
-p <platform>                         platform type as understood by
runConfigure in Xerces-C++ [guessed]
-c <C compiler name>                 [gcc]
-x <C++ compiler name>               [g++]
-m <make command>                  [make]
-b <bits to build: 32 or 64>           [32]
–no-configure:                       do not re-run configure steps.  Assumes
configuration has been run previously
–clean:                               perform ‘make clean’ on all libraries
….

在运行buildall.sh的时候如果不指定安装目录，则所有编译产生的库文件和头文件就会安装在主目录的install目录下。如果指定了安装目录， 请确保对目录有写权限。我们把–enable-java的选项打开，编译java库。

ying@bdbcn3:~/dbxml-2.4.16$ ./buildall.sh –enable-java

接着等待编译过程，一般酷睿2的机器十几分钟就编译完了。查看安装目录

ying@bdbcn3:~t/dbxml-2.4.16$ cd install/
ying@bdbcn3:~/dbxml-2.4.16/install$ ls
bin  docs  include  lib

我们所需要的库就安装在lib目录下，头文件在include目录下，docs目录下是文档，bin目录下放了一些Berkeley DB 和 Berkeley DB Xml的工具。

编译C++ hello world程序

我们可以编译dbxml/examples/cxx/basic/helloWorld.cpp示例程序，看我们编译的库是否正确。在用编译的时候需要指定-I 和-L选项

ying@bdbcn3:~/dbxml-2.4.16$g++ helloWorld.cpp -I /home/ying/dbxml-2.4.16/install/include/ -L /home/ying/dbxml-2.4.16/install/lib/ -ldbxml -ldb_cxx -lxqilla -lxerces-c -o helloWorld

运行的时候需要把库的位置加入到环境变量中

ying@bdbcn3:~/dbxml-2.4.16$ export LD_LIBRARY_PATH=/home/ying/dbxml-2.4.16/install/lib/
ying@bdbcn3:~/dbxml-2.4.16$ ./helloWorld
Document name: doc
Content: <hello>Hello World</hello>
ying@bdbcn3:~/dbxml-2.4.16$

在一些linux发行版中直接安装

一些Linux发行版对Berkeley DB Xml已经进行了打包，可以直接安装使用非常方便。可以参考如下命令：

Feodra: sudo yum install dbxml
Gentoo: sudo emerge dbxml

总结

使用buildall.sh脚本来编译Berkeley db xml方便快捷，如果读者在linux或unix系统下编译有什么问题欢迎和我交流。

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

本示例程序(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)等等功能, 读者可以关注本博客后续文章。

关键字：Berkeley DB XML, Windows 平台编译

1.前言

Oracle Berkeley DB XML 是一个可嵌入的开源 Native XML 数据库，可基于 XQuery 访问存储在容器中的文档，并对其内容进行索引。Oracle Berkeley DB XML 构建于 Oracle Berkeley DB 之上，并继承了其丰富的特性和属性。与 Oracle Berkeley DB 一样，它通过应用程序运行，无需人为管理。Oracle Berkeley DB XML 在 Oracle Berkeley DB 之上新增了文档分析器、XML 索引器以及 XQuery 引擎，实现了最快速、最高效的数据检索。由于以 Berkeley DB 作为底层存储引擎，因此 Berkeley DB XML 继承了完整的 ACID 事务处理、自动恢复、热备份、用于分布式事务的 XA、通过 AES 进行磁盘数据加密以及针对高可用性的复制。此外，Berkeley DB XML 中还可存储 XML 和非 XML 数据，这将有利于某些应用程序的运行。目前，除了该数据库外，市场上还没有任何一款 XML 数据库是基于此种成熟、经过实测的技术。

微软推出的Visual Studio Express Edition 是轻型、易学、易用的开发工具，适用于业余爱好者、热衷者和学生， 可以免费使用。在编译器及编译环境上与Visual Studio正式版并无差异。

本文使用Visual C++ 2008 Express Edition 编译Oracle Berkeley DB XML 2.4.16 版本。

2. 下载Oracle Berkeley DB XML

Oracle Berkeley DB XML可从此处下载：http://www.oracle.com/technology/global/cn/software/products/berkeley-db/xml/index.html

点击Berkeley DB XML 2.4.16.zip, 因为本文是描述如何从源代码编译Berkeley DB XML, 所以我们不选择Windows 安装程序。下载zip包后解压。

3. 编译

解压后我们发现， zip包里面存在以下目录

打开dbxmlbuild_windows 目录， 可以看到有很多Visual Studio的解决方案和工程项目文件，包括VC6, VC7, VC8. 我们将使用VC8的solution file.

打开Visual C++ 2008 Express,  选择菜单->File->Open->Project/Solution, 打开build_windows目录下的BDBXML_all_vs8.sln文件.

在出现的转换向导直接点击Finish, 等待VS导入解决方案后，可以看到所有Berkeley DB XML的项目都载入到Visual Studio中，

右键点中dbxml项目，选择Build， 在点击Build前可以在工具栏选择编译的类型Debug/Release 和平台。

先喝杯茶放松放松，稍侯片刻。几分钟后Berkeley DB XML就已经编译完毕

编译完成打开DB XML目录可以看到增加了几个目录，在bin目录下包含的是Berkeley DB XML所使用的.dll 文件。

4. 总结

在Windows平台使用Visual C++ express版本编译Berkeley DB XML是比较容易的，读者如果在编译上有什么疑问欢迎和我交流，后续文章将会介绍更多的Oracle Berkeley DB XML的使用和优化。

—-

参考链接：

http://www.oracle.com/technology/global/cn/software/products/berkeley-db/xml/index.html

http://www.oracle.com/technology/global/cn/products/berkeley-db/xml/index.html