Osheep

时光不回头,当下最重要。

Android 数据存储知识梳理(4) - 数据库升级操作的处理策略

一、前言

在项目当中使用数据库时,由于需求的增加,因此不可避免地要在原有的数据库当中增加新的字段,这时候就要在SQLiteOpenHelperonUpgrade方法进行处理,关于SQLiteOpenHelper的内部实现原理,可以参考之前的这篇文章:Android 数据存储知识梳理(1) – SQLiteOpenHelper 源码解析,今天我们主要介绍当数据库的结构更新之后应当如何操作。

二、示例

首先,我们介绍一下整个需求的背景:

  • 第一个版本:应用版本为1.0,设置数据库的版本号为1,创建表firstTable
  • 第二个版本:应用版本为1.1,由于需求变更,需要创建表secondTable,此时secondTable的表中的字段为column1
  • 第三个版本:应用版本为1.2,由于需求变更,需要在secondTable中新增一列column2

2.1 第一个版本

在第一个版本时,我们创建一个数据表first_table,代码如下:

public class DBHelper extends SQLiteOpenHelper {

    private static final String TAG = "DBHelper";

    private static final String DB_NAME = "table.db";
    private static final int DB_VERSION = 1;

    private static final String CREATE_FIRST_TABLE = "create table if not exists first_table ("
            + "id integer primary key,"
            + "column1 integer)";

    public DBHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        Log.d(TAG, "onCreate");
        db.execSQL(CREATE_FIRST_TABLE);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        Log.d(TAG, "oldVersion=" + oldVersion + ",newVersion=" + newVersion);
    }
}

当我们第一次安装该版本的应用,此时由于没有创建过该数据库,因此会走到onCreate方法当中:

《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

此时的数据库结构为:

《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

2.2 第二个版本

当安装第二个版本的时候,我们有两种情况:

  • 用户数据库中没有first_table,也就是不存在table.db
  • 用户数据库中有first_table,也就是table.db的版本号为1

这时候,我们就要对DBHelper修改,和第一个版本相比,修改的地方如红框所示:

《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

针对前面说到的两种情况,整个执行的过程为:

  • 没有安装或者运行过第一个版本,执行的onCreate,不执行onUpgrade,这时候就会创建两个表:
    《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

  • 安装过第一个版本并且运行,执行onUpgrade,不执行onCreate
    《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

    此时的数据库结构为:

    《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

2.3 第三个版本

前面两步都没有问题,那么接下来就是安装第三个版本,在第三个版本中我们需要在second_table中增加一个新的字段column2,那么这时候就有以下三种情况:

  • 用户的数据库中没有任何一个表,即不存在table.db
  • 用户的数据库中只有first_tabletable.db的版本为1
  • 用户的数据库中有first_tablesecond_tabletable.db的版本号为2

因此,我们就要对DBHelper类进行如下的修改:

《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

针对于上面谈到的三种情况,执行的流程分别为:

  • 只执行onCreate方法,直接创建带有column1/column2second_table
  • 只执行onUpgrade方法,因为我们的oldVersion1,因此先走到第一个case语句,创建带有column1second_table,由于该case语句没有break,因此接着会走到第二个case语句,在second_table中增加column2列。
  • 只执行onUpgrade方法,此时的oldVersion2,因此会直接执行第二个case语句,新增column2列。

此时的数据库结构为:

《Android 数据存储知识梳理(4) - 数据库升级操作的处理策略》

三、小结

以上就是对于数据库进行修改后的更新策略,每更新一个版本之后,我们需要做以下几件事:

  • 将数据库版本加1
  • onCreate方法中,定义创建数据库表的语句,它对应于表的最新结构。
  • onUpgradeswitch方法的最后,新增一条case语句,该case语句的内容为其相对于上个数据库版本所要进行的变更操作。

更多文章,欢迎访问我的 Android 知识梳理系列:

点赞