afinalDb 用法

研究Afinal是为了弄懂它到底是怎么实现的，它怎么就能够实现了呢？不过，现在先要看一下怎么用，再从表面推导内在。

本文就Afinal中建表、添加、删除、查找等常见数据库操作加以说明、探索。

一、创建数据库

可以看到，有多个create的方法。可以通过参数指定要创建的数据的名称，存储位置，debug模式，数据库版本号，数据库更新监听回调函数等。关于后面的版本号、存储位置、以及更新监听，本文并没有进行实际的测试。需要注意的是，如果没有指定数据库名称，则Afinal会自动创建一个名为afinal.db的数据库文件。除此之外，FinalDb是一个单例对象，即不管使用哪个create对象都会得到单一的FinalDb对象，不会重复创建。

二、建表及数据插入

Afinal是支持ORM的，即可以直接使用实体Bean来创建数据表，而不需要自己再编写SQL语句。具体是通过save方法实现的，如下:

查看save方法源码，可以得知，在进行数据插入之前会进行表的存在性判断，如果不存在则会先创建表后，再行插入数据。

这里也需要注意：默认创建的数据表名格式为:PackageName_db_BeanName,如上面注释语句中的com_wly_afinal_db_User。

如果希望自定义数据表的名称，可以在Bean中通过注释里实现，如:@Table(name="User")

三、删除

删除的数据操作有一些列的detele方法实现。

//拿到FinalDb对象引用
   FinalDb db = FinalDb.create(MainDBActivity.this, "user.db");
                 
// db.delete(user); //根据对象主键进行删除                
// db.deleteById(user, 1); //根据主键删除数据
// db.deleteByWhere(User.class, "name=AoTuMan"); //自定义where条件删除
   db.deleteAll(User.class); //删除Bean对应的数据表中的所有数据

四、查找数据

String searchKey = searchKeyET.getText().toString();
                 
   //拿到FinalDb对象引用
   FinalDb db = FinalDb.create(MainDBActivity.this, "user.db");
                 
// 注意这里的"where"语句参数是没有where关键字的
   List<User> resultList = db.findAllByWhere(User.class, " name=\"" + searchKey + "\"");
// List<User> resultList = db.findAll(User.class); //查找指定Bean的所有数据记录
   StringBuilder _sb = new StringBuilder();
   for(int i=0;i<resultList.size();i++) {
   _sb.append("id:" + resultList.get(i).getId()
    + " name:" + resultList.get(i).getName()
    + " age:" + resultList.get(i).getAge());
   }
   searchResultTV.setText(_sb.toString());