介绍和使用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

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

Java代码 view plaincopy to clipboardprint?
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();  
        }  
 
    }  
}