Android 的 数据库 ORM框架 DBExecutor

DBExecutor主要的功能

• 使用了读写锁，支持多线程操作数据。

• 支持事务

• 支持ORM

• 缓存Sql，缓存表结构

这个类库主要用于android 数据库操作。 始终围绕着一个类对应一个表的概念。 只要创建一个实体类，就不用当心它怎么存储在数据库中，不用重新写增删改查的代码。基本的功能已经帮你实现好了。 增删改查数据只要一句搞定

?

1 2 3 4

boolean  isSuccess = db.insert(person); boolean  isSuccess = db.updateById(person); boolean  isSuccess  = db.deleteById(Person. class , 1 ); List<Person> persons = db.findAll(Person. class );

• ---library_DB02 是项目的源码。

• ---DBLibrary_TestCase 是项目的测试用例，主要介绍该类库详细的用法

• ---doc 是网页文档

• ---db.jar 是该类库的jar包

• ---doc.chm 是该类库的chm文档

• ---设计框架.docx 是该类库的uml图生成的图片

• ---设计框架.mdl 是该类库的uml图，描述整个类库的架构

如果有什么建议可以发我邮箱 告知。794629068@qq.com

最后非常感谢XUtils代码的作者wyouflf。 该代码是对开源项目XUtils的数据库模块进行重构，及性能优化。 因为他的框架设计的非常合理。很多都是在其基础上完善的。

1.定义一个简单对应表的实体类

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

@Table (name =  "Person" ) public  class  Person {   @Id (autoIncrement =  true )   private  int  id;   private  String name;   private  int  age;     public  int  getId() {    return  id;   }     public  void  setId( int  id) {    this .id = id;   }     public  String getName() {    return  name;   }     public  void  setName(String name) {    this .name = name;   }     public  int  getAge() {    return  age;   }     public  void  setAge( int  age) {    this .age = age;   }   }

必须包含@Id,@Id声明的字段对应表里的id。autoIncrement = true 自增长。 @Table 声明表的名字。@Table可以不需要。如果没有@Table以包名+类名为表的名字

支持基本类型以及基本类型的封装类，java.sql.Date 定义的字段。如果要支持其他类型的字段请查看DBLibrary_TestCase中的TestColumnConverter.java

2.主要类

1.DBExecutor主要用于执行sql语句，一个数据库对应一个DBExecutor

获取默认数据库的执行者 DBExecutor executor = DBExecutor.getInstance(context); 获取指定的数据库的执行者 DBExecutor.getInstance(dbHelper)

主要的方法用 db.execute(sqls)，db.executeQuery(sql)等 封装了简基本的增删改查操作，使用db.insert(person);可以保存一条记录。 执行sql的时候。不用考虑表是否创建。如果表不存在，会自动创建。

2.Sql用于DBExecutor 执行的Sql

与sql文本语句是有差别的。 区别在于Sql 里包含
sql.getTable();//操作的表
sql.getSqlText();//可以带有?占位符的sql语句
sql.getBindValues();//?占位符对应的值。

sql.setCheckTableExit(checkTableExit);//设置执行sql时检查表是否存在，默认为true如果 检查到表不存在自动创建，设置为false 不做检查 不要害怕复杂，我们可以通过SqlFactory 创建它Sql

3.SqlFactory主要用于创建Sql语句，可以创建复杂增删改查的sql语句。

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

// 查询语句    Sql sql = SqlFactory.find(Person. class );    sql = SqlFactory.find(Person. class ).where( "name" ,  "=" ,  "试着飞" );    sql = SqlFactory.find(Person. class ).where( "age" ,  "=" ,  "10" ).or( "age" ,  "=" ,  11 );    sql = SqlFactory.find(Person. class ).where( "age" ,  "=" ,  "10" ).orderBy( "name" ,  false );    sql = SqlFactory.find(Person. class ).where( "age" ,  "=" ,  "10" ).orderBy( "name" ,  false ).limit( 1 );    sql = SqlFactory.find(Person. class ).where( "name" ,  "like" ,  "%飞" );    sql = SqlFactory.find(Person. class ).where( "name" ,  "like" ,  "_着_" );    sql = SqlFactory.find(Person. class ).where( "age" ,  "in" ,  new  int [] {  10 ,  11 ,  12  });    sql = SqlFactory.find(Person. class ).where( "name" ,  "in" ,  new  String[] {  "小明" ,  "小红"  });    sql = SqlFactory.find(Person. class ,  "name" ,  "age" ).where( "name" ,  "=" ,  "试着飞" );    sql = SqlFactory.find(Person. class ,  "count(*) as num" ).where( "age" ,  "=" ,  "11" );    sql = SqlFactory.find(Person. class ,  "max(age) as maxAge" ,  "min(age) as minAge" ).where( "sex" ,  "=" ,  "男" );    sql = SqlFactory.find(Person. class ,  new  MaxFunction( "age" ,  "maxAge" ),  new  MinFunction( "age" ,  "minAge" )).where( "sex" ,  "=" ,  "男" );    sql = SqlFactory.find(Person. class ).where( "name=? and age=?" ,  new  Object[] {  "小明" ,  11  });      // 删除语句    sql = SqlFactory.deleteAll(Person. class );    sql = SqlFactory.delete(Person. class ).where( "age" ,  "=" ,  11 );    sql = SqlFactory.deleteById(Person. class ,  11 );    sql = SqlFactory.deleteById(Person. class ,  new  int [] {  11 ,  12  });      // 更新语句    sql = SqlFactory.update(Person. class ,  new  String[] {  "name" ,  "age"  },  new  Object[] {  "小明" ,  "11"  }).where( "id" ,  "=" ,  1 );    sql = SqlFactory.updateById( new  Person( 1 ,  "小明" ,  11 ,  "男" ));    sql = SqlFactory.updateById( new  Person( 1 ,  "小明" ,  11 ,  "男" ),  "name" );      // 如果存在 id为1的记录，就更新，否则 插入一条新记录    sql = SqlFactory.updateOrInsertById( new  Person( 1 ,  "小明" ,  11 ,  "男" ));      // 插入语句    sql = SqlFactory.insert( new  Person( 1 ,  "小明" ,  11 ,  "男" ));      // 自拼接sql语句    sql = SqlFactory.makeSql(Person. class ,  "select * from Person where age = ?" ,  new  Object[] {  11  });

更多详细信息请查看项目文档里面的内容

项目地址 ：https://github.com/LuckyJayce/DBExecutor