一个方便实用的OrmLite数据库框架，支持一键集成，使用方便记录一下

• 支持通过@DataBase进行数据库配置。

• 支持自动生成数据库管理仓库DataBaseRepository。

• 支持内部存储和外部存储两种数据库。

• 支持自定义数据库存储位置。

• 支持自定义数据库打开、升级以及降级的接口。

• 支持事务操作、回滚等。

• 提供了常用的数据库操作API

• 。

• 目前支持主流开发工具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.0'
    annotationProcessor 'com.github.xuexiangjys.XOrmlite:xormlite-compiler:1.0.0'
  }
  

  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);
      }
  }
  

  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语句查询，返回对象的集合。

  更新

  • 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("事务执行失败！");
  }

  项目地址：https://xuexiangjys.github.io/XOrmlite/