GreenDao 兼容升级,保留旧数据的---全方面解决方案

简介: 作者:林冠宏 / 指尖下的幽灵掘金:https://juejin.im/user/587f0dfe128fe100570ce2d8博客:http://www.cnblogs.com/linguanh/GitHub : https://github.

作者:林冠宏 / 指尖下的幽灵

掘金:https://juejin.im/user/587f0dfe128fe100570ce2d8

博客:http://www.cnblogs.com/linguanh/

GitHub : https://github.com/af913337456/

腾讯云专栏: https://cloud.tencent.com/developer/user/1148436/activities

GreenDaoCompatibleUpdateHelper

一个能帮助你成功升级基于 greenDao 创建的数据库而不会丢失之前数据的工具
A helper which can help you to update you database without lost your old datas, simple to use , enjoy.

开源地址

https://github.com/af913337456/LghGreenDaoCompatibleUpdateHelper


目录

  • 出问题的的情形
  • 几个事实
  • 解决方案
  • 代码简述
  • 产品级别的可能错误
  • 你的顾虑

出问题的的情形:

  • 字段添加,导致旧表格字段与新的不匹配引发 android.database.sqlite.SQLiteException 类异常。
  • 服务端数据返回无法与就表格匹配,无法进行插入操作

第一个情况会直接导致 APP 闪退掉,第二种就是数据不匹配。

几个事实

  • GreenDao 目前的 3.+ 版,自动生成的代码的升级方式都是先删除原来的表格,再创建新的
/** WARNING: Drops all table on Upgrade! Use only during development. */
public static class DevOpenHelper extends OpenHelper {
    ......
    @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);
    }
}
  • 凡是自动生成的代码文件,例如 xxxDao.java 类的,都会在每一次 build 的时候重新被生成,意味着个人的内嵌修改总是无效,因为总是覆盖你的。
  • 数据库的升级方式需求更多是需要往后兼容的,旧数据不能丢失

解决方案

自定义升级策略。
思路参考

在上面的基础上做出如下步骤总结: (看不懂的看下面的符号描述)

  • 创建之前旧表中不存在的新表
  • 创建中间表 & 把旧表的数据迁移到中间表
  • 把旧表全部删除
  • 创建所有新表
  • 把中间表的数据迁移到新表 & 删除中间表

对应上面的步骤描述:

  • A -> A + B , old: A , new: B
  • use (A+B) -> create temp (A'+B') & insert data
  • drop (A+B) , contain old datas
  • create (A+B) , abs empty tables
  • restore data to (A+B) from (A'+B') then drop (A'+B')

代码简述

基于上面的二次修改和拓展

  • GreenDaoCompatibleUpdateHelper.java 顾名思义,兼容旧表性质的 greenDao 数据库升级,不会造成旧表的数据丢失

    • 拓展了最终的成功和失败的回调
    • 添加了错误日志的处理
    • 解决了字段名称的冲突 bug,例如 delete 之类
  • MyGreenDaoDbHelper.java 自定义的 dbHelper,重载 onUpgrade

调用例子

if (oldVersion < newVersion) {
    Log.e("MyGreenDaoDbHelper","进行数据库升级");
    new GreenDaoCompatibleUpdateHelper()
            .setCallBack(
                    new GreenDaoCompatibleUpdateHelper.GreenDaoCompatibleUpdateCallBack() {
                        @Override
                        public void onFinalSuccess() {
                            Log.e("MyGreenDaoDbHelper","进行数据库升级 ===> 成功");
                        }

                        @Override
                        public void onFailedLog(String errorMsg) {
                            Log.e("MyGreenDaoDbHelper","升级失败日志 ===> "+errorMsg);
                        }
                    }
            )
            .compatibleUpdate(
                    db,
                    PostBeanDao.class,
                    MatterUserBeanDao.class,
                    PropsBeanDao.class,
                    ChannelChatsBeanDao.class,
                    JoinToChannelReqBeanDao.class
            );
    Log.e("MyGreenDaoDbHelper","进行数据库升级--完成");
}
GreenDaoCompatibleUpdateHelper
public final class GreenDaoCompatibleUpdateHelper {

    public interface GreenDaoCompatibleUpdateCallBack{
        void onFinalSuccess();
        void onFailedLog(String errorMsg);
    }

    private static GreenDaoCompatibleUpdateCallBack callBack;

    @SuppressWarnings("all")
    public void compatibleUpdate(SQLiteDatabase sqliteDatabase, Class<? extends AbstractDao<?, ?>>... daoClasses) {
        StandardDatabase db = new StandardDatabase(sqliteDatabase);
        /** 创建之前旧表中不存在的新表 */
        if(!generateNewTablesIfNotExists_withNoExchangeData(db, daoClasses))    
            return;
        /** 创建中间表 & 把旧表的数据迁移到中间表 */
        if(!generateTempTables_withExchangeDataFromOldTable(db, daoClasses))   
            return;
        /** 把旧表全部删除 */
        if(!dropAllTables(db, true, daoClasses))                         
            return;
        /** 创建所有新表 */
        if(!createAllTables_withNoExchangeData(db, false, daoClasses)) 
            return;
        /** 把中间表的数据迁移到新表 & 删除中间表 */
        restoreData_fromTempTableToNewTable(db, daoClasses);                     
        if(callBack != null)
            callBack.onFinalSuccess();
        callBack = null;
    }

    public GreenDaoCompatibleUpdateHelper setCallBack(GreenDaoCompatibleUpdateCallBack callBack1){
        callBack = callBack1;
        return this;
    }
    ...... // 去 gitHub 下载完整代码
}
MyGreenDaoDbHelper
public class MyGreenDaoDbHelper extends DaoMaster.DevOpenHelper {

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

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

    @Override
    @SuppressWarnings("all")
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        super.onUpgrade(db, oldVersion, newVersion);
        Log.e("MyGreenDaoDbHelper", "----"+oldVersion + "---先前和更新之后的版本---" + newVersion+"----");
        if (oldVersion < newVersion) {
            Log.e("MyGreenDaoDbHelper","进行数据库升级");
            new GreenDaoCompatibleUpdateHelper()
                    .setCallBack(
                            new GreenDaoCompatibleUpdateHelper.GreenDaoCompatibleUpdateCallBack() {
                                @Override
                                public void onFinalSuccess() {
                                    Log.e("MyGreenDaoDbHelper","进行数据库升级 ===> 成功");
                                }

                                @Override
                                public void onFailedLog(String errorMsg) {
                                    Log.e("MyGreenDaoDbHelper","升级失败日志 ===> "+errorMsg);
                                }
                            }
                    )
                    .compatibleUpdate(
                            db,
                            PostBeanDao.class,
                            MatterUserBeanDao.class,
                            PropsBeanDao.class,
                            ChannelChatsBeanDao.class,
                            JoinToChannelReqBeanDao.class
                    );
            Log.e("MyGreenDaoDbHelper","进行数据库升级--完成");
        }
    }

    @Override
    public void onUpgrade(Database db, int oldVersion, int newVersion) {
        // 不要调用父类的,它默认是先删除全部表再创建
        // super.onUpgrade(db, oldVersion, newVersion);

    }
}

产品级别的可能错误

  • 因为混淆了 dao 类文件,导致 createTable 方法找不到,解决方法,不要混淆 dao 文件
  • restore 步骤中因为新加入的字段含有 int boolean 基础类型,因为不具备默认值而导致出现 SQLiteConstraintException: NOT NULL constraint failed 错误,解决方法,采用 Integer Boolean 类型替换,这个你只能妥协,因为 greenDao 作者不屑于在你建表的时候提供默认值方法。详情可以去看看 issue

你的顾虑

  • 如果我的表太多了,升级会不会造成 ANR 或者导致读写混乱?
  • 是否实践过?

1, 答: sqlLite 的源码里面调用 onUpdrade方法的入口皆加上了同步琐,这样不会造成在升级中还能让你去读写的情况。
这点设计得非常优秀!表太多的,几百张?那么就放入子线程升级。

2, 答: 我已经使用到线上多个APP , 且成功运行至今。

如果您认为这篇文章还不错或者有所收获,您可以通过扫描一下下面的支付宝二维码 打赏我一杯咖啡【物质支持】,也可以点击右下角的【推荐】按钮【精神支持】,因为这两种支持都是我继续写作,分享的最大动力


img_12e3f54d4d0f70f0eb14f20548e3d781.png
目录
相关文章
|
1月前
|
人工智能 Rust Apache
|
6月前
|
存储 SQL 关系型数据库
MySQL8.0新特性与旧特性移除总结
MySQL从5.7版本直接跳跃发布了8.0版本 ,可见这是一个令人兴奋的里程碑版本。MySQL 8版本在功能上做了显著的改进与增强,开发者对MySQL的源代码进行了重构,最突出的一点是对MySQL Optimizer优化器进行了改进。不仅在速度上得到了改善,还为用户带来了更好的性能和更棒的体验。
462 1
|
4月前
|
Java API 开发者
Java版本对比:特性、升级改动与优势分析
Java版本对比:特性、升级改动与优势分析
89 0
|
安全 Java 编译器
JDK21更新内容:舍弃对x86架构32位系统支持
JDK21更新内容:舍弃对x86架构32位系统支持
|
C# 容器
旧项目集成
旧项目集成
133 0
旧项目集成
|
数据库
【鸿蒙】数据库--数据的更新
4.更新数据 调用更新接口,传入要更新的数据,并通过AbsRdbPredicates指定更新条件。该接口的返回值表示更新操作影响的行数。如果更新失败,则返回0。
【鸿蒙】数据库--数据的更新
|
SQL 前端开发 Java
9-TDengine低版本分页offset出现bug,如何平滑升级版本、迁移数据
9-TDengine低版本分页offset出现bug,如何平滑升级版本、迁移数据
602 0
9-TDengine低版本分页offset出现bug,如何平滑升级版本、迁移数据
|
Kubernetes Java 测试技术
SpringBoot配置升级,旧的已过时,新的人未知
SpringBoot配置升级,旧的已过时,新的人未知
617 0
|
缓存
「OushuDB」版本升级 二进制替换升级步骤
请注意需要留下足够的升级与测试时间,避免升级出现问题需要回退到老版本。另外,请在升级前做好数据的备份工作,防止出现意外。
121 0
|
数据库 数据安全/隐私保护
【自然框架】稳定版的Demo —— 三:主从表的维护方式
  第一篇:【自然框架】稳定版beta1——源码下载,Demo说明   下载地址:还是老地方,自然框架的源代码、Demo、数据库、配置信息管理程序下载(2010.01.25更新)   (补充了一个元数据的 数据库结构说明文档,在上面的网页里下载)   在线演示:http://demo.conature.cn/       主从表,以人员管理为例,人员的基本信息,公司信息,联系方式,学历信息,工作经历等功能。
1051 0