XOrmlite

一个方便实用的OrmLite数据库框架，支持一键集成。

关于我

特征

支持通过@DataBase进行数据库配置。
支持自动生成数据库管理仓库DataBaseRepository。
支持自动搜索所有的数据库表类，并自动创建数据库表。
支持内部存储和外部存储两种数据库。
支持自定义数据库存储位置。
支持自定义数据库打开、升级以及降级的接口。
支持事务操作、回滚等。
提供了常用的数据库操作API。

1、演示（请star支持）

Demo下载

2、如何使用

目前支持主流开发工具AndroidStudio的使用，直接配置build.gradle，增加依赖即可.

2.1、Android Studio导入方法，添加Gradle依赖

1.先在项目根目录的 build.gradle 的 repositories 添加:

allprojects {
     repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

2.然后在dependencies添加:

dependencies {
  ...
  implementation 'com.github.xuexiangjys.XOrmlite:xormlite-runtime:1.0.2'
  annotationProcessor 'com.github.xuexiangjys.XOrmlite:xormlite-compiler:1.0.2'
}

2.2、数据库注册配置

1.使用@DataBase进行数据库注册配置。属性如下：

name ：数据库的名称，必填。
version ：数据库的版本, 默认版本为1
type ：数据库的存放类型，默认是内部存储DataBaseType.INTERNAL
path ：数据库存放的路径，只对外部存储的数据库起作用，默认的地址为：/storage/emulated/0/Android/xormlite/databases/

【注意】@DataBase必须注册在Application类上才起作用。

@DataBase(name = "external", type = DataBaseType.EXTERNAL, path = "/storage/emulated/0/xormlite/databases")
public class ExternalApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
    }
}

2.使用@DataBase注册完后，请编译一下项目：build -> Rebuild Project，之后会自动生成数据库管理仓库: 数据库名 + DataBaseRepository 的Java文件。文件的生成路径如下：

例如上面我们注册的数据库名为：external，自动生成的数据库管理仓库为 ExternalDataBaseRepository。

3.初始化数据库管理仓库，设置数据库实现接口。

内部存储的数据库需要需要实现IDatabase接口。
外部存储的数据库需要需要实现IExternalDataBase接口。

@DataBase(name = "internal", type = DataBaseType.INTERNAL)
public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        InternalDataBaseRepository.getInstance()
                .setIDatabase(new InternalDataBase())  //设置内部存储的数据库实现接口
                .init(this);

        ExternalDataBaseRepository.getInstance()
                .setIDatabase(new ExternalDataBase(  //设置外部存储的数据库实现接口
                        ExternalDataBaseRepository.DATABASE_PATH,
                        ExternalDataBaseRepository.DATABASE_NAME,
                        ExternalDataBaseRepository.DATABASE_VERSION))
                .init(this);
    }
}

点击查看InternalDataBase的实现

2.3、数据库服务获取

数据库管理仓库DataBaseRepository提供了获取数据库操作服务的API getDataBase, 传入标有@DatabaseTable的数据库实体类Class, 获取对应的数据库操作服务DBService。

DBService<Student> mDBService = InternalDataBaseRepository.getInstance().getDataBase(Student.class);

2.4、数据库操作

DBService提供了丰富的数据库操作API，详细API请点击参见。

以下简要介绍一部分API：

插入

insert：插入单条数据。
insertData：插入单条数据(返回被插入的对象）。
insertDatas：批量添加，返回插入数据的数量。

查询

queryAll：查询所有的数据。
queryAllOrderBy：查询所有的数据并根据列名进行排序，返回一个对象集合。
queryAndOrderBy：有条件的排序查询，返回一个对象集合。
queryById：根据id查询出一条数据。
queryByField：根据条件查询，返回一个对象集合。
queryByColumn：根据条件查询，返回一个对象集合。
queryForColumnFirst：根据条件查询，返回第一个符合条件的对象。
indistinctQueryForColumn：根据条件模糊查询，返回一个对象集合。
queryDataBySql：根据sql语句查询，返回对象的集合。
queryPage: 根据某个字段排序进行分页查询

更新

updateData：使用对象更新一条记录（注意：对象必须带唯一标识ID,且该方法不能更新ID字段)。
updateDataByColumn：根据某一或多个条件更新对象。
updateDataBySQL：根据条件做update时直接使用sql语句进行更新，sql语句中必须包含关键字【INSERT，DELETE，UPDATE】。

删除

deleteData：根据对象删除一条记录（注意：对象必须带唯一标识ID,否则方法不起作用)。
deleteDatas：批量删除（注意：对象必须带唯一标识ID,否则方法不起作用)【大数据量的删除不起左右，会报too many SQL variables错误】。
deleteAll：删除所有数据。
deleteById：根据id删除一条记录。

其他

executeSql：执行sql语句。
getQueryBuilder：返回QueryBuilder。
getUpdateBuilder：返回UpdateBuilder。
getDeleteBuilder：返回DeleteBuilder。

事务操作

doInTransaction：执行事务操作。
beginTransaction：开启数据库事务操作。
commit：提交事务。
rollBack：事务回滚。

2.5、数据库操作示例

1.插入单条数据

Student student = new Student();
student.setUserName("xuexiang");
student.setSex("男");
student.setAge((int) (Math.random() * 100));

try {
    mDBService.insert(student);
} catch (SQLException e) {
    e.printStackTrace();
}

2.更新数据库某一字段

try {
    mDBService.updateDataByColumn("username", "xxxx", "username", "xuexiang");
} catch (SQLException e1) {
    e1.printStackTrace();
}

3.执行事务插入

try {
    mDBService.doInTransaction(new Callable<Boolean>() {
        @Override
        public Boolean call() throws Exception {
            for (int i = 0; i < mTempList.size(); i++) {
                mDBService.insert(mTempList.get(i));
            }
            return true;
        }
    });
} catch (SQLException e) {
    e.printStackTrace();
    ToastUtils.toast("事务执行失败！");
}

4.执行事务删除

try {
    mDBService.doInTransaction(new Callable<Boolean>() {
        @Override
        public Boolean call() throws Exception {
            for (int i = 0; i < mTempList.size(); i++) {
                mDBService.deleteData(mTempList.get(i));
            }
            return true;
        }
    });
    mStudentAdapter.updateList(mDBService.queryAll());
} catch (SQLException e) {
    e.printStackTrace();
    ToastUtils.toast("事务执行失败！");
}

混淆配置

-keepattributes *DatabaseField*
-keepattributes *DatabaseTable*
-keepattributes *SerializedName*
-keep class com.j256.**
-keepclassmembers class com.j256.** { *; }
-keep enum com.j256.**
-keepclassmembers enum com.j256.** { *; }
-keep interface com.j256.**
-keepclassmembers interface com.j256.** { *; }

如果觉得项目还不错，可以考虑打赏一波

你的打赏是我维护的动力，我将会列出所有打赏人员的清单在下方作为凭证，打赏前请留下打赏项目的备注！

微信公众号

更多资讯内容，欢迎扫描关注我的个人微信公众号:【我的Android开源之旅】

2yunyun/XOrmlite