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

2018-07-10 本文已影响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覆盖住以上所有的六种情况呢。

有以下几种思路：

永远在onCreate中的建表是最新的，这样就覆盖住了直接安装版本1,2,3的情况。
然后在onUpgrade中进行以下步骤：保存旧数据，删除旧表，手动调用onCreate方法，把旧数据插入新建的表中。
伪代码如下

public void onUpgrade(SqliteDatabase db, int oldVersion, int newVersion){
  saveOldDataIntoMemroy();
  dropTables();
  onCreate(db);
  insertIntoNewDb();
}

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

还有一种写法是永远在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的处理

猜你喜欢

热点阅读