介绍和使用Berkeley DB Java Edition（嵌入式数据库）

介绍和使用Berkeley DB Java Edition（嵌入式数据库）

一、 简介

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

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

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

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

        事务支持。
        允许创建二级库。这样我们就可以方便的使用一级key,二级key来访问我们的数据。

        支持RAM缓冲，这样就能减少频繁的IO操作。

        支持日志。

        数据备份和恢复。

        游标支持。

二、   获取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 当没有找到指定的数据库的时候会返回这个异常

DeadlockException 线程间死锁异常

RunRecoveryException 回收异常，当发生此异常的时候，你必须得重新打开环境变量。

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

JE的日志文件跟其他的数据库的日志文件不太一样，跟C版的DBD也是有区别的

        JE的日志文件只能APPEND，第一个日志文件名是 00000000.jdb，当他增长到一定大小的时候(默认是10M)，开始写第二个日志文件00000001.jdb，已此类推。

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

        JE cleaner负责清扫没用到的磁盘空间，删除后，或者更新后新的记录会追加进来，而原有的记录空间就不在使用了，cleaner负责清理不用的空间。

        清理并不是立即进行的，当你关闭你的数据库环境后，通过调用一个cleaner方法来清理。

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

        日志文件的删除仅发生在检查点之后。cleaner准备出哪些log 文件需要被删除，当检查点过后，删掉一些不在被使用的文件。每写20M的日志文件就执行一次检查点，默认下。

JE的英文文档：http://www.oracle.com/technology/documentation/berkeley-db/je/GettingStartedGuide/index.html

JE的中文文档（不全）：http://fesir.itpub.net/post/4728/253789
http://fesir.itpub.net/post/4728/253789

上面大概介绍一下，接下来是我在工作中写的一个例子（仅供参考）：

package src.util;

import java.io.File;
import java.util.List;

import junit.framework.TestCase;
import src.com.bizjato.b2b.entity.Suppliers;

import com.sleepycat.bind.EntryBinding;
import com.sleepycat.bind.serial.SerialBinding;
import com.sleepycat.bind.serial.StoredClassCatalog;
import com.sleepycat.je.Cursor;
import com.sleepycat.je.CursorConfig;
import com.sleepycat.je.Database;
import com.sleepycat.je.DatabaseConfig;
import com.sleepycat.je.DatabaseEntry;
import com.sleepycat.je.DatabaseException;
import com.sleepycat.je.Environment;
import com.sleepycat.je.EnvironmentConfig;
import com.sleepycat.je.EnvironmentMutableConfig;
import com.sleepycat.je.LockMode;
import com.sleepycat.je.OperationStatus;

/**
 * 嵌入式数据库
 * 
 * @author zhangqinjian
 *
 */
public class Jedtion extends TestCase {

	private static final String RESOURCE = ".//src//util//importData";
	private Environment env;

	private Database db, classDB;

	private StoredClassCatalog classCatalog;
	/**
	 * 初始化，设置数据库的环境和创建数据库
	 */
	public void setUp() throws Exception {

		env = new Environment(new File(".//src//util//importData"), null);
		EnvironmentMutableConfig envMutableConfig = new EnvironmentMutableConfig();
		envMutableConfig.setTxnNoSync(true);
		env.setMutableConfig(envMutableConfig);

		DatabaseConfig dbConfig = new DatabaseConfig();
		dbConfig.setAllowCreate(true);
		db = env.openDatabase(null, "myDB", dbConfig);
		classDB = env.openDatabase(null, "classDB", dbConfig);
		classCatalog = new StoredClassCatalog(classDB);
	}
	// test: put key-value
	public void testPut(String key, Suppliers supp) throws Exception {
		EntryBinding dataBinding = new SerialBinding(classCatalog,
				Suppliers.class);
		DatabaseEntry keyEntry = new DatabaseEntry(key.getBytes("UTF-8"));
		DatabaseEntry dataEntry = new DatabaseEntry();
		dataBinding.objectToEntry(supp, dataEntry);
		db.put(null, keyEntry, dataEntry);
	}
	// test: get
	public void testGet() throws Exception {
		EnvironmentConfig envConfig = new EnvironmentConfig();
		envConfig.setAllowCreate(true);
		// envConfig.setReadOnly(true);
		env = new Environment(new File(".//src//util//importData"), envConfig);
		List myDbNames = env.getDatabaseNames();
		System.out.println("Database size: " + myDbNames.size());
		for (int i = 0; i < myDbNames.size(); i++) {
			System.out.println("Database Name: " + (String) myDbNames.get(i));
		}

		DatabaseConfig dbConfig = new DatabaseConfig();
		dbConfig.setAllowCreate(true);
		// dbConfig.setReadOnly(true);
		db = env.openDatabase(null, "myDB", dbConfig);
		classDB = env.openDatabase(null, "classDB", dbConfig);
		classCatalog = new StoredClassCatalog(classDB);

		System.out.println("Db: " + db.count());

		EntryBinding dataBinding = new SerialBinding(classCatalog,
				Suppliers.class);

		DatabaseEntry keyEntry = new DatabaseEntry("key".getBytes("UTF-8"));
		DatabaseEntry dataEntry = new DatabaseEntry();
		db.get(null, keyEntry, dataEntry, LockMode.DEFAULT);
		Suppliers p = (Suppliers) dataBinding.entryToObject(dataEntry);
		System.out.println(p.getCategory());
	}

	/**
	 * test: read database
	 * @throws Exception
	 */
	public void testStore() throws Exception {

		EnvironmentConfig envConfig = new EnvironmentConfig();
		envConfig.setAllowCreate(true);
		env = new Environment(new File(".//src//util//importData"), envConfig);

		DatabaseConfig dbConfig = new DatabaseConfig();
		dbConfig.setAllowCreate(true);
		db = env.openDatabase(null, "myDB", dbConfig);
		classDB = env.openDatabase(null, "classDB", dbConfig);
		classCatalog = new StoredClassCatalog(classDB);

		EntryBinding dataBinding = new SerialBinding(classCatalog,Suppliers.class);

		Cursor cursor = null;
		CursorConfig config = new CursorConfig();
	    config.setDirtyRead(true);
	    cursor = db.openCursor(null, config);		// open cursor

		try {
			// Database and environment open omitted for brevity
			// Open the cursor. cursor = myDatabase.openCursor(null, null);
			// Cursors need a pair of DatabaseEntry objects to operate. These hold
			// the key and data found at any given position in the database.
			DatabaseEntry foundKey = new DatabaseEntry();
			DatabaseEntry foundData = new DatabaseEntry();
			// To iterate, just call getNext() until the last database record has been
			// read. All cursor operations return an OperationStatus, so just read
			// until we no longer see OperationStatus.SUCCESS
			while (cursor.getNext(foundKey, foundData, LockMode.DEFAULT) == OperationStatus.SUCCESS) {
				// getData() on the DatabaseEntry objects returns the byte array
				// held by that object. We use this to get a String value. If the
				// DatabaseEntry held a byte array representation of some other data
				// type (such as a complex object) then this operation would look
				// considerably different.
				String keyString = new String(foundKey.getData());
				
				Suppliers supp = (Suppliers)dataBinding.entryToObject(foundData);
				System.out.println("Key - Data : " + keyString + " - "
						+ supp.getCompanyName() + "");
			}
		} catch (DatabaseException de) {
			System.err.println("Error accessing database." + de);
		} finally {
			// Cursors must be closed.
			cursor.close();
			db.close();
			classDB.close();
			env.cleanLog();
			env.close();
		}

	}

	public void tearDown() throws Exception {
		db.close();
		classDB.close();
		env.cleanLog();
		env.close();
	}

	public static void main(String[] args) {
		Jedtion t = new Jedtion();
		try {
			// t.setUp();
			// Suppliers supp = new Suppliers();
			// supp.setCategory("fivefive");
			// t.testPut("5",supp);
			// t.testGet();
			// t.testStore();
                        // t.tearDown();
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

	}
}

希望大家多提意见并修改！

评论

5 楼 Programmer2.x 2009-04-24  

怎么设置成hash呢，谢谢。。。

4 楼 云中苍月 2009-03-16  

这个东西很好用，不过要提醒各位，Berkeley DB被Oracle收购了。使用这个软件开发商业软件的话存在版权问题。

3 楼 ispring 2009-03-16  

不错， Berkeley 的东西就是牛，Linux 里面的软件管理器好像就是基于这个的

2 楼 alanye 2009-03-16  

您好,请问DatabaseConfig原来有setType，可以选择BTree或者是Hash或者别的，新的je.DatabaseConfig里面没有了，是不是只能选择BTree呢？ 谢谢

1 楼 andersonmao 2008-12-20  

有没有大虾用过BDB JE的DPL(直接数据存储)? 以前用ORM, 不知道中小型应用如何？