美文网首页
Android Sqlite中常见的对于onUpgrade的处理

Android Sqlite中常见的对于onUpgrade的处理

作者: 董成鹏 | 来源:发表于2018-07-10 00:38 被阅读0次

    在Android开发中我们肯定会用到数据库,而每一次数据库的每次一升级都是我们要十分注意的,稍有不慎就会出现问题。

    这篇文章会先讲解一下Android App中数据库的创建过程,以及onUpgrade的调用时机,最后分析一下常见的在数据库升级中对于onCreate和onUpgrade的处理方法。

    看一下Sqlite数据库的创建过程:

    • 一般我们创建数据库都是通过SqliteOpenHelper的getWritableDatabase或者getReadableDatabase方法开始的,这两个方法最终都会调用到getDatabaseLocked方法
    • getDatabaseLocked方法会进行一些前置条件判断,比如根据数据库是否关闭,数据库是否可读等做出相应的行为。需要关注的有如下的代码片段(这里用伪代码表示)
    SqliteDatabase db = mDatabase;
    try{
      mIsInitializing = true;
      if(db != null){
        //说明在该app这次的生命周期中已经创建过了,重新打开就好
        db.reopenReadWrite();
      }else if(mName == null){
        //mName就是数据库的名字,如果mName为空,说明在该app本次的生命周期中还没有创建过
        //这个createInMemeory方法会在一个特殊的路径上创建该db,并且当连接断开的时候,该db就自动被删除了
        //这样应该可以加快第一次创建的速度,没仔细研究
        //createInMemory最终也是调用openDatabase方法,只是入参不一样
        db = SqliteDatabase.createInMemory();
      }else{
        //否则直接打开数据库
        db = openDatabase(mName);
      }
      //这里会回调SqliteOpenHelper的onConfigure方法
      onConfigure(db);
      //这里得到数据库的老版本,来判断是否需要升级
      int version = db.getVersion();
      if(version != mNewVersion){
        if(version > 0 && version < minSupportVersion){
          //minSupportVersion代表了最小的允许升级到version的版本号,
          //比如这次SqliteOpenHelper传入的version是5,minSupportVersion是3,代表最小可以从3升级到5,当然从4升级到5也是可以的。
          //但是如果已经存在的数据库版本号是2,则不能升级了
          //此时会删除原有的数据库,然后创建一个版本号为5的数据库
          //这也是onBeforeDelete唯一会被调用的情况
          onBeforeDelete(db);
          deleteDatabase(db);
        }else{
          //以下写法表明,onCreate和onUpgrade是互斥的,在生命周期里只会调用其中一个
          if(version == 0){
            //version为0说明数据库还没有被创建
            //调用onCreate方法
            onCreate();
          }else{
            if(version > mNewVersion){
              onDowngrade();
            }else{
              onUpgrade
            }
          }
          //即使第一次前面成功创建了数据库,不执行该方法,得到的数据库版本也是0
          db.setVersion(newVersion);
        }
      }
    }finally{
      mIsInitializing = false;
      //由于在创建成功之后肯定会进行mDatabase = db的操作
      //所以,如果两者不一致,肯定是出现问题了,关闭创建的该数据库
      if(db != mDatabase){
        db.close();
      }
    }
    //最后会被回调
    onOpen(db);
    mDatabase = db;
    

    以上可以看出这些方法的回调顺序是:

    onConfigure --> onCreate或onUpgrade --> onOpen
    

    以上就是数据库创建的过程,以及相关方法的回调时机

    接下来看一下处理onCreate和onUpgrade的几种思路。

    考虑以下几种情况,一个App有三个版本,版本号分别为1,2,3.
    在App升级的时候可能会遇到以下几种情况:

    直接安装1或者2或者3,
    然后版本升级
    1 --> 2
    1 --> 3
    2 -->3
    

    怎么利用onCreate和onUpgrade覆盖住以上所有的六种情况呢。

    有以下几种思路:

    1. 永远在onCreate中的建表是最新的,这样就覆盖住了直接安装版本1,2,3的情况。
      然后在onUpgrade中进行以下步骤:保存旧数据,删除旧表,手动调用onCreate方法,把旧数据插入新建的表中。
      伪代码如下
    public void onUpgrade(SqliteDatabase db, int oldVersion, int newVersion){
      saveOldDataIntoMemroy();
      dropTables();
      onCreate(db);
      insertIntoNewDb();
    }
    

    这种做法有一个非常不好的弊端,就是性能开销非常大,数据库升级的时候需要保存所有的数据到内存中,删除原来的表,创建新表,然后把内存中的数据插入新表中。这每一个步骤都非常消耗资源。

    1. 还有一种写法是永远在onCreate中创建最原始的表,比如这个例子中onCreate中只创建版本号1所需要的表,然后手动在onCreate方法中调用onUpgrade方法,传入的参数oldVersion是1,newVersion是现在的版本号,然后在onUpgrade中根据oldVersion来执行数据库版本的更新。
      伪代码如下:
    现在代码中的版本号是3
    //使用这种方法需要记录一下我们创建的第一个数据库的版本号,然后在onCreate的时候手动调用onUpgrade,oldVersion传入我们记录的这个版本号。
    public static final int FIRST_VERSION = 1;
    
    public void onUpgrade(SqliteDatabase db, int oldVersion, int newVersion){
      if(oldVersion >= newVersion){
        return;
      }
      int version = oldVersion;
      if(version == 1){
        alter1To2();
        version = 2;
      }
      if(version == 2){
        alter2To3();
        version = 3;
      }
    }
    

    这种写法比较简单的,而且一目了然,每个oldVersion只要负责升级它相邻的newVersion就可以了。

    看一下这种写法会不会覆盖到所有的情况:

    • 如果用户是直接安装的版本1,那么走onCreate方法,然后我们手动调用了onUpgrade方法,但是传入的oldVersion和newVersion是一样的,所以onUpgrade方法什么都不做
    • 如果用户是直接安装的版本2,那么现在数据库版本号是2,我们在onCreate方法中创建了版本号为1的时候所需要的表,然后我们手动调用了onUpgrade方法,在onUpgrade方法中,oldVersion是1,newVersion是2,执行1升级到2的方法。
    • 如果用户直接安装的是版本3,那么现在数据库的版本号是3.我们在onCreate中创建了版本号为1的表,然后手动调用了onUpgrade方法,在onUpgrade方法中,oldVersion为1,会执行if(version==1)if(version == 2)这两个判断,从而升级到版本3.

    在考虑升级的情况,用户直接从1升级到2,这样会走onUpgrade方法,在onUpgrade方法中,oldVersion为1,newVersion为2,可以顺利升级到版本2.
    同理,也可以验证从1升级到3或者从2升级到3都没有问题。

    所以比较推荐这种写法。

    相关文章

      网友评论

          本文标题:Android Sqlite中常见的对于onUpgrade的处理

          本文链接:https://www.haomeiwen.com/subject/xddtpftx.html