Android GreenDao 3.2 使用笔记

前言

在使用GreenDao3的时候，网上看了部分参考的文章，最后发现只是把人家官网的东西又搬了一遍，不过还是要感谢他们的翻译。
这篇文章并不准备赘述一些常用用法，而是弥补一下其他文章中说欠缺的部分元素

效果图

说实话，这个效果图我也不知道出什么，只是习惯性的大标题而已，略过

使用方法

• 基础配置

在Project的build.gradle中添加plugin

buildscript {
    repositories {
      ...
    }
    dependencies {
        classpath 'org.greenrobot:greendao-gradle-plugin:3.2.1'//==GreenDao==
    }
}

然后在app的build.gradle中添加

apply plugin: 'org.greenrobot.greendao'

dependencies {
    ...
    //greendao
    compile 'org.greenrobot:greendao:3.2.0'
    ...
}

然后是在app的build.gradle中配置相关内容

greendao {
    schemaVersion 1
    targetGenDir 'src/main/java'
    daoPackage 'com.xx.yy'
}

其中
schemaVersion： 数据库schema版本，可以理解为数据库版本号
daoPackage：设置DaoMaster 、DaoSession、Dao的包名
targetGenDir：设置DaoMaster 、DaoSession、Dao的目录
targetGenDirTest：设置生成单元测试的目录
generateTests：设置自动生成单元测试用例
如果数据库有所改动的话，请务必记住升级数据库版本号，否则数据库部分并不会更新，而导致一些异常

• 注意点

数据库在实际使用中，需要考虑到版本迭代的问题，然而看了部分提到数据库更新的文章，一般使用的都是 oldVersion!=newVersion 然后用别人的轮子做了修改操作，但是看到评论里有说好的，有说不好的，然后大致扫了一眼，里面的升级逻辑是创建了临时表进行数据的转移，然后再导入新创建的表。
所以还是选择了比较稳妥的中性方法，首先可以看到GreenDao自动生成的DaoMaster类中，有如下的一个静态类继承了OpenHelper类

/** WARNING: Drops all table on Upgrade! Use only during development. */
    public static class DevOpenHelper extends OpenHelper {
        public DevOpenHelper(Context context, String name) {
            super(context, name);
        }

        public DevOpenHelper(Context context, String name, CursorFactory factory) {
            super(context, name, factory);
        }

        @Override
        public void onUpgrade(Database db, int oldVersion, int newVersion) {
            Log.i("greenDAO", "Upgrading schema from version " + oldVersion + " to " + newVersion + " by dropping all tables");
            dropAllTables(db, true);
            onCreate(db);
        }
    }

其中提示了一个warning虽然没有写三遍，但是也很关键Use only during development.
那么我们如何处理，一般情况下，大家都会自己封装一个自己的GreenDao工具类，那么我们替换上面的DevOpenHelper类即可

    /**
     * 自定义Helper类重写升级的方法，通过for循环解决跨版本升级数据库的需求
     */
    class MyOpenHelper extends DaoMaster.OpenHelper{

        public MyOpenHelper(Context context, String name) {
            super(context, name);
        }

        public MyOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory) {
            super(context, name, factory);
        }

        @Override
        public void onUpgrade(Database db, int oldVersion, int newVersion) {
            super.onUpgrade(db, oldVersion, newVersion);
            for (int i = oldVersion; i < newVersion; i++) {
                switch (i) {
                    case 1:
                        upgradeToVersion2(db);
                        break;
                    case 2:
                        upgradeToVersion3(db);
                        break;
                    default:
                        break;
                }
            }
        }

        private void upgradeToVersion3(Database db) {
            //创建新表时，用如下方法
            FourBeanDao.createTable(db,true);
        }

        private void upgradeToVersion2(Database db) {
            //添加ThreeBeanBao表的字段lastname，格式为text"，原表中数据不会清除
            db.execSQL("alter table '"+ThreeBeanDao.TABLENAME+"' add 'lastname' TEXT;");
        }
    }

每次更新时，只关注最近一次版本的调整，跨版本时，利用迭代从旧版本一步步更新至最新版本
最后把自定义Helper类加入代码中，只需要替换掉你的DaoMaster.DevOpenHelper类就行了，就行了，如：

//openHelper = new DaoMaster.DevOpenHelper(appContext, dbName, null);
openHelper = new MyOpenHelper(appContext, dbName, null);

最终章

以上就是我的部分使用经验，最后还有一个关于普通数据表的存储问题，因为数据的格式可能会有变动，所以表中的字段偶尔会有删减，我们可以为了避免这类的变动，把要保存的内容转成json格式然后存入数据库，这样字段的变化，只在自定义的实体类里体现，修改和使用上更方便许多，也减少了sql的维护量