Guide to the BDBXML Library

Berkeley DBXML is a native embedded XML database. Formerly developed by Sleepycat and now a part of Oracle, DBXML is based on the open-source Berkeley database engine. This library provides a tool library for managing and querying XML document repositories in BDXML.

Requirements

This library requires that BDBXML is installed on your host operating system. You can download the latest version here.

Installation

Before you can use BDBXML from NetKernel. You must configure NetKernel's host Java platform to access the native BDBXML engine as a library. Please follow these instructions to make the BDBXML Java interface libraries locatable in the JVM path.

Installation

Since BDXML is a native library with Java JNI native intefaces you must set the JVM property java.library.path with the path to the BDBXML native library files (on Windows these are dll's found in the bin/ directory of the BDBXML install, on Linux they are in /usr/lib/ ). Add the following switch to the Java command line -Djava.library.path=[path to dbxml libraries] in the bin/start.sh script.

You must also locate db.jar and dbxml.jar from the BDBXML installation directory (/usr/share/java on Linux) and copy or symlink these to [install]/lib/native directory of your NetKernel installation. Please note: due to the JNI native library dependency do not put the dbxml jar files in the db-xml module's lib/ directory.

Using the Library

BDBXML has an XML container model. A container must first be constructed. Documents may then be placed in the container. Queries over the document collection can be made with XQuery. The following set of accessors provide atomic tools for accessing the BDBXML database.

• dbxmlCreateContainer
• dbxmlDeleteContainer
• dbxmlRenameContainer
• dbxmlPutDocument
• dbxmlGetDocument
• dbxmlDeleteDocument
• dbxmlQuery
• dbxmlBooleanQuery