berkeley db使用手册

一、 简介

Berkeley DB Java Edition (JE)是一个完全用 JAVA 写的，它适合于管理海量的，简单

的数据。

l 能够高效率的处理 1 到 1 百万条记录，制约 JE 数据库的往往是硬件系统,而不是

JE 本身。

l 多线程支持，JE 使用超时的方式来处理线程间的死琐问题。

l Database 都采用简单的 key/value 对应的形式。

l 事务支持。

二、 获取 JE

JE 下载地址：

http://www.oracle.com/technology/software/products/berkeley-db/je/index.html

解开包后 把 JE_HOME/lib/je-<version>.jar 中的 jar 文件添加到你的环境变量

中就可以使用 je 了。

相关帮助文档可以参考 JE_HOME/docs/index.html

源代码见 JE_HOME/src/*.*

三、 JE 常见的异常

DatabaseNotFoundException 当没有找到指定的数据库的时候会返回这个

异常

四、 关于日志文件必须了解的六项

00000001.jdb，已此类推。

l 跟 C 版本有所不同，JE 的数据日志和事务日志是放在一起的，而不是分开放的。

l JE cleaner 负责清扫没用到的磁盘空间，删除后，或者更新后新的记录会追加进

来，而原有的记录空间就不在使用了，cleaner 负责清理不用的空间。

来清理。

l 清理也不是只动执行的，需要你自己手动调用 cleaner 方法来定时清理的。

l 日志文件的删除仅发生在检查点之后。cleaner 准备出哪些 log 文件需要被删除，

当检查点过后，删掉一些不在被使用的文件。每写 20M 的日志文件就执行一次检

查点，默认下。

五、 创建数据库环境

JE 要求在任何 DATABASE 操作前，要先打开数据库环境，就像我们要使用数据

库的话必须得先建立连接一样。你可以通过数据库环境来创建和打开 database，或者

package je.gettingStarted;

import com.sleepycat.je.DatabaseException;

import com.sleepycat.je.Environment;

import com.sleepycat.je.EnvironmentConfig;

import java.io.File;

...

Environment myDbEnvironment = null;

// 错误处理

}

2. 关闭 database 环境

可以通过 Environment.close()这个方法来关闭 database 环境，当你完成数

据库操作后一定要关闭数据库环境。

示例：

import com.sleepycat.je.DatabaseException;

import com.sleepycat.je.Environment;

...

if (myDbEnvironment != null) {

myDbEnvironment.close();

}

} catch (DatabaseException dbe) {

// Exception handling goes here

}

示例：

import com.sleepycat.je.DatabaseException;

import com.sleepycat.je.Environment;

...

try {

if (myDbEnvironment != null) {

myDbEnvironment.cleanLog(); // 在关闭环境前清理下日志

myDbEnvironment.close();

}

} catch (DatabaseException dbe) {

4. Database 环境的配置

可以通过 EnvironmentConfig 这个对象来配置 database 环境。如果想得

到当前环境的配置信息则可以通过 Environment.getConfig()方法得到当前环

境的配置信息。

也可以使用 EnvironmentMutableConfig 来配置环境，其实

EnvironmentConfig 常见方法介绍

l EnvironmentConfig.setAllowCreate() ;

如果设置了 true 则表示当数据库环境不存在时候重新创建一个数据

库环境，默认为 false.

l EnvironmentConfig.setReadOnly()

以只读方式打开，默认为 false.

l EnvironmentConfig.setTransactional()

false，不支持事务处理。

l setCachePercent()

设置当前环境能够使用的 RAM 占整个 JVM 内存的百分比。