BerkeleyDB-JE 使用BaseAPI（七）

本篇开始介绍二级数据库(Secondary Databases)的使用。

通常情况下，我们根据key值来查找JE中的记录，但是key值不一定会包含你所要想要查询的值，比如JE中有个用户库，你使用一个唯一的没有什么意义的ID作为key值，而data值是一个复杂的java对象，它封装了用户名，性别，生日，年龄等信息，如果你想查找某个具有某个名字的用户记录，那么你可能要遍历整个数据库。这时候JE还提供了一个选择，就是使用Secondary Databases。

在这里Secondary Databases可以使你创建一个基于用户名的索引，这样你就可以使用这个索引进行查询。在JE中，包含了你想要的数据的数据库叫做主数据库（Primary Database），而包含了可选的key集合的用于访问Primary database中数据的数据库称为二级数据库（Secondary Databases）。

一旦你打开了一个Secondary Databases，JE会为你管理其中的数据。当你添加或者删除Primary Database中记录的时候，JE会自动对Secondary Databases中的数据作出必要的修改；当你修改了Primary Database中的记录，并且这个修改会导致Secondary Databases中的key发生变化的时候，JE也会调整Secondary Databases。

一定要注意一点，你不能直接对Secondary Databases中的数据进行操作，虽然其中存在这样的API，但是如果你调用了这些API，则会报出异常。唯一的例外是你可以删除Secondary Databases中的数据。

当你从Secondary Databases中获取记录值的时候，实际上返回的是对应在Primary Database中的记录。

下面开始讲解如何打开和关闭Secondary Databases，有5个步骤：
1.打开Primary Database
2.实例化SecondaryKeyCreator对象
3.实例化SecondaryConfig对象
4.为SecondaryConfig设置SecondaryKeyCreator对象
5.用Primary Database和SecondaryConfig打开Secondary Databases

相比打开普通的Database，要打开Secondary Database，这里最大的区别就在于多了个SecondaryKeyCreator对象。这个对象是用来创建你想要的索引的。你能使用任何数据来创建key，一般情况下，你会使用Primary Database中的data值来创建这个key，当然你也可以使用Primary Database的key值。

为此，你要实现SecondaryKeyCreator接口，这个接口要求你实现SecondaryKeyCreator.createSecondaryKey() 方法。有一点要注意的是，你要抽取的key值是来自于保存于Primary Database中的记录，而在JE中，一条记录键和值都是DatabaseEntry类型的，而且在这个方法中你要生成的key最终也要表现成DatabaseEntry形式，所以你可能需要依赖于Binding API，比如在你使用复杂对象的时候。这个方法的返回值是一个boolean，如果返回false，则说明不存在二级键，这就意味着Primary Database不会填充数据到Secondary Databases中，如果该Secondary Databases有记录，则会被删除。

下面演示下这个过程：
首先假设，我们有个数据库，名叫myPrimaryDatabase，里面存储的记录值是PersonData类型数据，key值是String，同时还有了个自定义的Binding：TupleBinding

public class FullNameKeyCreator implements SecondaryKeyCreator {

    private TupleBinding theBinding;
    public FullNameKeyCreator(TupleBinding theBinding1) {
            theBinding = theBinding1;
    }
    public boolean createSecondaryKey(SecondaryDatabase secDb,
                                      DatabaseEntry keyEntry, 
                                      DatabaseEntry dataEntry,
                                      DatabaseEntry resultEntry) {
        try {
            PersonData pd = (PersonData) theBinding.entryToObject(dataEntry);
            String fullName = pd.getFamiliarName() + " " + pd.getSurname();
            resultEntry.setData(fullName.getBytes("UTF-8"));
        } catch (IOException willNeverOccur) {}
        return true;
    }
}

然后我们这样打开和关闭Secondary Datab

DatabaseConfig myDbConfig = new DatabaseConfig();
SecondaryConfig mySecConfig = new SecondaryConfig();
myDbConfig.setAllowCreate(true);
mySecConfig.setAllowCreate(true);
mySecConfig.setSortedDuplicates(true);
Environment myEnv = null;
Database myDb = null;
SecondaryDatabase mySecDb = null;
try {
    String dbName = "myPrimaryDatabase";
    myEnv = new Environment(new File("/tmp/JEENV"), null);
    myDb = myEnv.openDatabase(null, dbName, myDbConfig);
    TupleBinding myTupleBinding = new MyTupleBinding();

    FullNameKeyCreator keyCreator = 
        new FullNameKeyCreator(myTupleBinding);
    mySecConfig.setKeyCreator(keyCreator);
    String secDbName = "mySecondaryDatabase";
    mySecDb = myEnv.openSecondaryDatabase(null, secDbName, myDb, 
                                          mySecConfig); 
} catch (DatabaseException de) {

}finally {
    //close的顺序要注意下
    try {
        if (mySecDb != null) {
            mySecDb.close();
        }
        if (myDb != null) {
            myDb.close();         
        }
        if (myEnv != null) {
            myEnv.close();
        }
    } catch (DatabaseException dbe) {

    }
}

SecondaryConfig是DatabaseConfig的子类，你可以像设置DatabaseConfig一样设置它。这里有一个属性说明下：
SecondaryConfig.setAllowPopulate()：设置为Secondary Databases是否可以自动填充。是指当Secondary Databases为空的时候，在Primary Databases只读的时候，Secondary Databases中的记录会被自动的添加或修改。（This means that on open, if the secondary database is empty then the primary database is read in its entirety and additions/modifications to the secondary's records occur automatically.）