基于ORMLite封装的数据库操作工具类，分页查询就是这么简单

EasyDB

基于ORMLite封装的数据库操作工具类——致力于最简洁的数据库操作API

功能点

• 支持自定义数据库路径：SD卡或系统
• 支持主键、索引
• 支持增、删、改、查
• 支持多条件查询、排序、统计、清空、是否存在
• 支持批处理、数据库事务操作
• 支持模糊查询like、between、equal、>、<、>=、<=、<>
• 支持分页查询，分页查询只需要定义每页条数即可
• 支持批量处理
• 支持异步任务操作
• 支持数据库升级，使数据库升级更为简洁
• 完整的日志与异常处理
• 后续优化中...

引用方式

Maven

  com.zhousf.lib
  easydb
  1.7.0
  pom

Gradle

compile 'com.zhousf.lib:easydb:1.7.0'

提交记录

• 2016-12-15 项目提交
• 2016-12-20 增加批处理、事务操作功能
• 2016-12-23 增加异步任务功能
• 2016-12-27 扩展更新、删除操作
• 2017-05-23 优化结构，采用动态代理方式
• 2017-06-12 增加自定义数据库路径功能

项目演示DEMO

项目中已包含所有支持业务的demo，详情请下载项目参考源码。

• https://github.com/MrZhousf/EasyDB

Application中配置

EasyDBConfig.init()
        .showDBLog(true)//显示数据库操作日志
        .setLogTAG("EASY_DB")//日志显示标识
        .build();

自定义数据库单例

单例模式防止频繁打开关闭数据库，从而导致数据操作性能下降，甚至出现一些异常错误。
自定义数据库单例继承BaseDBHelper，BaseDBHelper进行数据库操作的缓存管理

// 数据库辅助类
public class EasyDBHelper extends BaseDBHelper {

    //版本号
    private static final int DB_VERSION = 2;

    //数据库存放路径
    private static final String DB_PATH = Environment.getExternalStorageDirectory() + "/easy_db";

    //数据库名称
    private static final String DB_NAME = "easy_android.db";

    //数据表清单-数据库与表的关系更直观
    private static final Class[] tables = {
        SimpleData.class
    };

    private static EasyDBHelper helper = null;

    public static EasyDBHelper get(){
        if(null == helper){
            synchronized (EasyDBHelper.class){
                if(null == helper){
                    helper = new EasyDBHelper();
                }
            }
        }
        return helper;
    }

    private EasyDBHelper() {
        //系统数据库
        //super(BaseApplication.getApplication(), null,DB_NAME,DB_VERSION,tables);
        //SD卡数据库
        super(BaseApplication.getApplication(), DB_PATH,DB_NAME,DB_VERSION,tables);
    }

    @Override
    protected BaseDBHelper initHelper() {
        return get();
    }

    @Override
    protected boolean upgrade(int oldVersion, int newVersion) throws SQLException {
        //数据库升级操作
        if(oldVersion < 2){
            //增加字段ext
            getDao(SimpleData.class).executeRaw("ALTER TABLE'simpledata' ADD COLUMN ext TEXT DEFAULT 'default';");
        }
        return true;
    }

}

数据库操作方法

//获取数据库操作接口
BaseDao dao = EasyDBHelper.get().dao(SimpleData.class);

//增加
int line = dao.add(new SimpleData(1,"信息1"));

//查询所有
List list = dao.queryAll();

//多条件查询并排序
List list = dao.query(WhereInfo.get().between("index",1,18).equal("group1",true).order("id", false));
 
//分页查询-每页5条
WhereInfo info = WhereInfo.get().limit(5);
List list = dao.queryLimit(info);//第一页查询
list = dao.queryLimit(info);//第二页查询

//更新
dao.update(data)

//删除
dao.delete(data)

//条目统计
long num = dao.countOf(WhereInfo.get().equal("group1", true));

//是否存在
boolean isExist = dao.isExist(WhereInfo.get().equal("description","信息2"));

//清空表
int line = dao.clearTable();

//批处理-批量操作消耗性能最低
dao.callBatchTasks(new Callable() {
    @Override
    public SimpleData call() throws Exception {
        List list = dao.queryAll();
        for(SimpleData data : list){
            data.description += "_批处理";
            dao.update(data);
        }
        return null;
    }
});

//更新-采用事务方式，自动回滚
dao.callInTransaction(new Callable() {
    @Override
    public SimpleData call() throws Exception {
        List list = dao.queryAll();
        if(!list.isEmpty()){
            SimpleData data = list.get(0);
            data.description = "更新内容";
            dao.update(data);
        }
        return null;
    }
});

//删除表
int clear = dao.dropTable();

/**
 * 异步任务方式一：在Activity/Fragment中尽量采用异步任务操作数据库
 * 异步任务可以重写run方法和onMainThread方法，可根据业务自定义重写方式
 **/
dao.asyncTask(new EasyRun>(){
    //该方法在异步线程中执行
    @Override
    public List run() throws Exception {
        return dao.queryAll();
    }
    //该方法在UI线程中执行
    @Override
    public void onMainThread(List data) throws Exception {
        printList(data);
    }
});
//异步任务方式二
dao.asyncTask(new EasyRun