Getting Started with Berkeley DB Java Edition

Table of Contents

Preface

Conventions Used in this Book

For More Information

Contact Us

1. Introduction to Berkeley DB Java Edition

Features

DPL Features

Base API Features

Which API Should You Use?

The JE Application

Database Environments

Key-Data Pairs

Storing Data

Duplicate Data

Replacing and Deleting Entries

Secondary Keys

Transactions

JE Resources

Application Considerations

JE Backup and Restore

JCA Support

JConsole and JMX Support

Getting and Using JE

JE Exceptions

Six Things Everyone Should Know about JE Log Files

2. Database Environments

Opening Database Environments

Multiple Environments

Configuring a Shared Cache for Multiple Environments

Closing Database Environments

Environment Properties

The EnvironmentConfig Class

EnvironmentMutableConfig

Environment Statistics

Database Environment Management Example

I. Programming with the Direct Persistence Layer

3. Direct Persistence Layer First Steps

Entity Stores

Opening and Closing Environments and Stores

Persistent Objects

Saving and Retrieving Data

4. Working with Indices

Accessing Indexes

Accessing Primary Indices

Accessing Secondary Indices

Creating Indexes

Declaring a Primary Indexes

Declaring Secondary Indexes

Foreign Key Constraints

5. Saving and Retrieving Objects

A Simple Entity Class

SimpleDA.class

Placing Objects in an Entity Store

Retrieving Objects from an Entity Store

Retrieving Multiple Objects

Cursor Initialization

Working with Duplicate Keys

Key Ranges

Join Cursors

Deleting Entity Objects

Replacing Entity Objects

6. A DPL Example

Vendor.java

Inventory.java

MyDbEnv

DataAccessor.java

ExampleDatabasePut.java

ExampleInventoryRead.java

II. Programming with the Base API

7. Databases

Opening Databases

Deferred Write Databases

Temporary Databases

Closing Databases

Database Properties

Administrative Methods

Database Example

8. Database Records

Using Database Records

Reading and Writing Database Records

Writing Records to the Database

Getting Records from the Database

Deleting Records

Data Persistence

Using the BIND APIs

Numerical and String Objects

Serializable Complex Objects

Custom Tuple Bindings

Using Comparators

Writing Comparators

Setting Comparators

Database Record Example

9. Using Cursors

Opening and Closing Cursors

Getting Records Using the Cursor

Searching for Records

Working with Duplicate Records

Putting Records Using Cursors

Deleting Records Using Cursors

Replacing Records Using Cursors

Cursor Example

10. Secondary Databases

Opening and Closing Secondary Databases

Implementing Key Creators

Secondary Database Properties

Reading Secondary Databases

Deleting Secondary Database Records

Using Secondary Cursors

Database Joins

Using Join Cursors

JoinCursor Properties

Secondary Database Example

Opening Secondary Databases with MyDbEnv

Using Secondary Databases with ExampleInventoryRead

III. Administering JE Applications

11. Backing up and Restoring Berkeley DB Java Edition Applications

Databases and Log Files

Log File Overview

Cleaning the Log Files

The BTree

Database Modifications and Syncs

Normal Recovery

Performing Backups

Performing a Hot Backup

Performing an Offline Backup

Using the DbBackup Helper Class

Performing Catastrophic Recovery

Hot Standby

12. Administering Berkeley DB Java Edition Applications

The JE Properties File

Managing the Background Threads

The Cleaner Thread

The Checkpointer Thread

Sizing the Cache

The Command Line Tools

DbDump

DbLoad

DbVerify

Logging

Managing Logging Levels

Managing Handler Levels

A. Concurrent Processing in Berkeley DB Java Edition

Multithreaded Applications

Multiprocess Applications