Getting Started with Berkeley DB XML

for C++

Legal Notice

This documentation is distributed under an open source license. You may review the terms of this license at: http://www.oracle.com/technology/software/products/berkeley-db/htdocs/oslicense.html

Oracle, Berkeley DB, and Sleepycat are trademarks or registered trademarks of Oracle. All rights to these marks are reserved. No third-party use is permitted without the express prior written consent of Oracle.

To obtain a copy of this document's original source code, please submit a request to the Oracle Technology Network forum at: http://forums.oracle.com/forums/forum.jspa?forumID=271

11/30/2006


Table of Contents

Preface
Conventions Used in this Book
For More Information
1. Introduction to Berkeley DB XML
Overview
Benefits
XML Features
Database Features
Languages and Platforms
Getting and Using BDB XML
Documentation and Support
Library Dependencies
Building and Running BDB XML Applications
2. Exception Handling and Debugging
Debugging BDB XML Applications
3. XmlManager and Containers
XmlManager
Berkeley DB Environments
XmlManager Instantiation and Destruction
Managing Containers
Container Flags
Container Types
Deleting and Renaming Containers
4. Adding XML Documents to Containers
Input Streams and Strings
Adding Documents
Constructing Documents using Event Writers
Setting Metadata
5. Using XQuery with BDB XML
XQuery: A Brief Introduction
Referencing Portions of Documents using XQuery
Predicates
Context
Wildcards
Navigation Functions
Using FLWOR with BDB XML
Retrieving BDB XML Documents using XQuery
The Query Context
Performing Queries
Examining Query Results
Examining Document Values
Examining Metadata
Using Event Readers
6. Managing Documents in Containers
Deleting Documents
Replacing Documents
Modifying XML Documents
Modification Parameters
Modification Methods
Modification Example
7. Using BDB XML Indices
Index Types
Uniqueness
Path Types
Node Types
Key Types
Syntax Types
Specifying Index Strategies
Using Strings to Specify Indices
Using Enumerated Types to Specify Indices
Specifying Index Nodes
Indexer Processing Notes
Managing BDB XML Indices
Adding Indices
Deleting Indices
Replacing Indices
Examining Container Indices
Working with Default Indices
Looking Up Indexed Documents
Verifying Indices using Query Plans
Query Plans
Using the dbxml Shell to Examine Query Plans

List of Examples

2.1. BDB XML Exception Handling
2.2. Setting Error Streams
2.3. Setting Log Levels
5.1. A Simple XML Document
5.2. XML Documents and Namespaces
5.3. Namespace Declaration
5.4. Namespace Prefixes
5.5. Namespaces with Attributes