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

在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都没有问题。

所以比较推荐这种写法。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,406评论 6 503
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,732评论 3 393
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,711评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,380评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,432评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,301评论 1 301
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,145评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,008评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,443评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,649评论 3 334
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,795评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,501评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,119评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,731评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,865评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,899评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,724评论 2 354

推荐阅读更多精彩内容