GreenDao使用和升级详解

来源：互联网发布：1919专卖店软件编辑：程序博客网时间：2024/05/22 16:01

GreenDao是一个将对象映射到SQLite数据库中的轻量且快速的ORM解决方案

该框架具有以下优点

1、一个精简的库
2、性能最大化
3、内存开销最小化
4、易于使用的 APIs
5、对 Android 进行高度优化

使用方法

1.导入相关类库 mudule的gradle下配置

compile'org.greenrobot:greendao:3.0.1'compile'org.greenrobot:greendao-generator:3.0.0'

2.导入greendao插件 project的gradle下配置

apply plugin: 'org.greenrobot.greendao'

buildscript {    repositories {        jcenter()    }    dependencies {        classpath 'com.android.tools.build:gradle:2.3.0'        classpath 'org.greenrobot:greendao-gradle-plugin:3.0.0'    }}

3.自定义路径mudule的gradle下配置
apply plugin: 'org.greenrobot.greendao'
android{
greendao {    schemaVersion 11//数据库版本号，升级的时候使用    daoPackage 'com.binzhi.testgreendao.gen'//对应项目下生成的包名    targetGenDir 'src/main/java'//生成目录，默认使用这个
}

}
schemaVersion： 数据库schema版本，也可以理解为数据库版本号
daoPackage：设置DaoMaster 、DaoSession、Dao包名
targetGenDir：设置DaoMaster 、DaoSession、Dao目录
targetGenDirTest：设置生成单元测试目录
generateTests：设置自动生成单元测试用例
4.创建一个实体类
@Entitypublic class User {    @Id     private Long id;     private String name;     @Transient     private int tempUsageCount; // not persisted  }
相关注解解释
实体@Entity注解
schema：告知GreenDao当前实体属于哪个schema
active：标记一个实体处于活动状态，活动实体有更新、删除和刷新方法
nameInDb：在数据中使用的别名，默认使用的是实体的类名
indexes：定义索引，可以跨越多个列
createInDb：标记创建数据库表
基础属性注解
@Id :主键 Long型，可以通过@Id(autoincrement = true)设置自增长
@Property：设置一个非默认关系映射所对应的列名，默认是的使用字段名 举例：@Property (nameInDb="name")
@NotNul：设置数据库表当前列不能为空
@Transient ：添加次标记之后不会生成数据库表的列
索引注解
@Index：使用@Index作为一个属性来创建一个索引，通过name设置索引别名，也可以通过unique给索引添加约束
@Unique：向数据库列添加了一个唯一的约束
向数据库列添加了一个唯一的约束  这个属性非常重要，配合insertOrReplace方法可以防止添加重复数据 
关系注解
@ToOne：定义与另一个实体（一个实体对象）的关系
@ToMany：定义与多个实体对象的关系
5.点击上面的Make Project （绿色锤子按钮）
  通过上面使用方式我们可以获取DaoMaster 、DaoSession、Dao类
   Dao为对应类生成的数据，DaoMaster 操作数据库表格 DaoSession衔接数据库和具体的dao数据，操作数据的直接类
6.使用方法
   在需要使用的时候初始化拿到操作类，可以在application初始化，也可以自己封装工具方法， 下面是简单用例
public class MyApplication extends Application {   public static MyApplication instances;   private static SQLiteDatabase db;   private static DaoMaster mDaoMaster;   private static DaoSession mDaoSession;   private static MyOpenHelper mHelper;   @Override   public void onCreate() {      super.onCreate();      instances = this;      initDatabase();   }   //获取上下文   public static MyApplication getInstances(){      return instances;   }   public static void initDatabase() {      // 通过 DaoMaster 的内部类 DevOpenHelper，你可以得到一个便利的 SQLiteOpenHelper 对象。      // 可能你已经注意到了，你并不需要去编写「CREATE TABLE」这样的 SQL 语句，因为 greenDAO 已经帮你做了。      // 注意：默认的 DaoMaster.DevOpenHelper 会在数据库升级时，删除所有的表，意味着这将导致数据的丢失。这个类为daomaster内部类，实际升级我们要自己定义      // 所以，在正式的项目中，你还应该做一层封装，来实现数据库的安全升级，也就是自定义自己的数据库//    mHelper = new DaoMaster.DevOpenHelper(instances, "cache-db", null);      mHelper = new MyOpenHelper(instances,"cache-db",null);      db = mHelper.getWritableDatabase();      // 注意：该数据库连接属于 DaoMaster，所以多个 Session 指的是相同的数据库连接。      mDaoMaster = new DaoMaster(db);      mDaoSession = mDaoMaster.newSession();   }   public static DaoSession getDaoSession() {      return mDaoSession;   }   public static SQLiteDatabase getDb() {      return db;   }}
Activity中通过mDaoSession 获取da实体类便可以进行相关操作
mUserDao = MyApplication.getInstances().getDaoSession().getUserDao();
//读取数据
List<Student> users = mStudentDao.loadAll();
//插入数据
Teacher teacher=new Teacher(null,"haha",20);mTeacherDao.insert(teacher);
//删除
mTeacherDao.deleteAll();
//根据条件查询  常用查询方法  eq等于  le小于  gt大于
UserDao userDao = daoSession.getUserDao();        
QueryBuilder<User> qb = userDao.queryBuilder();        qb.where(UserDao.Properties.Age.gt(age)).orderAsc(UserDao.Properties.Age);      //  orderAsc升序排列
List<User> list = qb.list();
//自定义sql查询Cursor cursor = dao.getDatabase().rawQuery("select t.sales_wx_nick_name,t.wx_nick_name,count(*),t.talker_id,t.sales_wx_account from chat_history t group by t.talker_id,t.sales_wx_account order by t.created_at desc", null);  
while (cursor.moveToNext()) {      
  String salesWxNickName = cursor.getString(0);      
  String clientWxNickName = cursor.getString(1);      
  int chatCount = cursor.getInt(2);      
  int talkerId = cursor.getInt(3);      
  String salesWxAccount = cursor.getString(4);  
}  
//修改数据
mUser = new User((long)2,"anye0803");mUserDao.update(mUser);
更详细的操作方法可以参考官网
7.数据库升级
  首先需要明白数据库的升级的逻辑，大致情况为
  1：将表A重新命名：例如重新命名为：temp_A（或者创建临时表作为衔接也可以）  2：创建新标A  3： 将temp_A中的数据【也就是更新前的数据】插入到新表A
对于不同的版本号升级，还要处理不同情况的问题，实际操作流程也比较繁琐，这里献上已经封装好的升级方法，以后升级使用此类即可


数据库升级迁移方法类
public class MigrationHelper {   private static final String CONVERSION_CLASS_NOT_FOUND_EXCEPTION = "MIGRATION HELPER - CLASS DOESN'T MATCH WITH THE CURRENT PARAMETERS";   private static MigrationHelper instance;   public static MigrationHelper getInstance() {      if (instance == null) {         instance = new MigrationHelper();      }      return instance;   }   public void migrate(Database db, Class<? extends AbstractDao<?, ?>>... daoClasses) {      generateTempTables(db, daoClasses);      DaoMaster.dropAllTables(db, true);      DaoMaster.createAllTables(db, false);      restoreData(db, daoClasses);   }   private void generateTempTables(Database db, Class<? extends AbstractDao<?, ?>>... daoClasses) {      for (int i = 0; i < daoClasses.length; i++) {         DaoConfig daoConfig = new DaoConfig(db, daoClasses[i]);         String divider = "";         String tableName = daoConfig.tablename;         String tempTableName = daoConfig.tablename.concat("_TEMP");         ArrayList<String> properties = new ArrayList<String>();         StringBuilder createTableStringBuilder = new StringBuilder();         createTableStringBuilder.append("CREATE TABLE ").append(tempTableName).append(" (");         for (int j = 0; j < daoConfig.properties.length; j++) {            String columnName = daoConfig.properties[j].columnName;            if (getColumns(db, tableName).contains(columnName)) {               properties.add(columnName);               String type = null;               try {                  type = getTypeByClass(daoConfig.properties[j].type);               } catch (Exception exception) {               }               createTableStringBuilder.append(divider).append(columnName).append(" ").append(type);               if (daoConfig.properties[j].primaryKey) {                  createTableStringBuilder.append(" PRIMARY KEY");               }               divider = ",";            }         }         createTableStringBuilder.append(");");         db.execSQL(createTableStringBuilder.toString());         StringBuilder insertTableStringBuilder = new StringBuilder();         insertTableStringBuilder.append("INSERT INTO ").append(tempTableName).append(" (");         insertTableStringBuilder.append(TextUtils.join(",", properties));         insertTableStringBuilder.append(") SELECT ");         insertTableStringBuilder.append(TextUtils.join(",", properties));         insertTableStringBuilder.append(" FROM ").append(tableName).append(";");         db.execSQL(insertTableStringBuilder.toString());      }   }   private void restoreData(Database db, Class<? extends AbstractDao<?, ?>>... daoClasses) {      for (int i = 0; i < daoClasses.length; i++) {         DaoConfig daoConfig = new DaoConfig(db, daoClasses[i]);         String tableName = daoConfig.tablename;         String tempTableName = daoConfig.tablename.concat("_TEMP");         ArrayList<String> properties = new ArrayList();         for (int j = 0; j < daoConfig.properties.length; j++) {            String columnName = daoConfig.properties[j].columnName;            if (getColumns(db, tempTableName).contains(columnName)) {               properties.add(columnName);            }         }         StringBuilder insertTableStringBuilder = new StringBuilder();         insertTableStringBuilder.append("INSERT INTO ").append(tableName).append(" (");         insertTableStringBuilder.append(TextUtils.join(",", properties));         insertTableStringBuilder.append(") SELECT ");         insertTableStringBuilder.append(TextUtils.join(",", properties));         insertTableStringBuilder.append(" FROM ").append(tempTableName).append(";");         StringBuilder dropTableStringBuilder = new StringBuilder();         dropTableStringBuilder.append("DROP TABLE ").append(tempTableName);         db.execSQL(insertTableStringBuilder.toString());         db.execSQL(dropTableStringBuilder.toString());      }   }   private String getTypeByClass(Class<?> type) throws Exception {      if (type.equals(String.class)) {         return "TEXT";      }      if (type.equals(Long.class) || type.equals(Integer.class) || type.equals(long.class)) {         return "INTEGER";      }      if (type.equals(Boolean.class)) {         return "BOOLEAN";      }      Exception exception = new Exception(CONVERSION_CLASS_NOT_FOUND_EXCEPTION.concat(" - Class: ").concat(type.toString()));      throw exception;   }   private static List<String> getColumns(Database db, String tableName) {      List<String> columns = new ArrayList<String>();      Cursor cursor = null;      try {         cursor = db.rawQuery("SELECT * FROM " + tableName + " limit 1", null);         if (cursor != null) {            columns = new ArrayList<String>(Arrays.asList(cursor.getColumnNames()));         }      } catch (Exception e) {         Log.v(tableName, e.getMessage(), e);         e.printStackTrace();      } finally {         if (cursor != null)            cursor.close();      }      return columns;   }}

初始化的时候一定要记得使用自定义的OpenHelper 而不是生成默认的，默认的更新不保存数据！
public class MyOpenHelper extends DaoMaster.OpenHelper {   public MyOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory) {      super(context, name, factory);   }   
   //第一次创建新表的时候才会调用
   @Override   public void onCreate(Database db) {      super.onCreate(db);   }   
   //已有数据库，升级的时候以后都走这个方法
   @Override   public void onUpgrade(Database db, int oldVersion, int newVersion) {      //更数据库
      //这里根据自己更新的表实体类，逐个传入到参数内
      //切记不能重复调用这个方法来更新表，而是一次性调用传入所需要的全部实体类      MigrationHelper.getInstance().migrate(db,StudentDao.class,TeacherDao.class,UserDao.class);
         }}
最后记得在gradle中把版本号调高才会升级
参考文献
Android ORM框架 GreenDao3.0的使用 | 戴定康的博客  https://www.daidingkang.cc/2016/12/08/GreenDao/
玩转Android之数据库框架greenDAO3.0使用指南 - 江南一点雨的专栏 - 博客频道 - CSDN.NET  http://blog.csdn.net/u012702547/article/details/52226163
GreenDao3.0简单使用 - 简书  http://www.jianshu.com/p/4986100eff90
Android数据存储之GreenDao 3.0 详解 - 总李写代码 - 博客园  http://www.cnblogs.com/whoislcj/p/5651396.html
Android Studio 简单使用 GreenDao3.0 - 半把秋风的博客 - 博客频道 - CSDN.NET  http://blog.csdn.net/qq_27899045/article/details/52797636 数据库升级方法
Android SQLite数据库版本升级原理解析 - 传说之美 - 博客园  http://www.cnblogs.com/liqw/p/4264925.html  原生数据库升级参考方法
greenDAO 3.2 初探 - zone_的博客 - 博客频道 - CSDN.NET  http://blog.csdn.net/zone_/article/details/69054997
GreenDAO数据库版本升级 - fancychendong的专栏 - 博客频道 - CSDN.NET  http://blog.csdn.net/fancylovejava/article/details/46713445  国外大牛的数据库升级方法，直接套用
android中sqlite数据库升级方案 - yaya_soft的专栏 - CSDN博客  http://blog.csdn.net/yaya_soft/article/details/17089353 数据库升级逻辑
在DaoMaster类的onUpgrade方法添加如下代码即可，参数为所有的Dao类

阅读全文

1 0