下载

可以在这个地址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)等等功能, 读者可以关注本博客后续文章。