前言
在使用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的维护量