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

1、前言

在项目当中使用数据库时，因为需求的增长，所以不可避免地要在原有的数据库当中增长新的字段，这时候就要在SQLiteOpenHelper的onUpgrade方法进行处理，关于SQLiteOpenHelper的内部实现原理，能够参考以前的这篇文章：Android 数据存储知识梳理(1) - SQLiteOpenHelper 源码解析，今天咱们主要介绍当数据库的结构更新以后应当如何操做。

2、示例

首先，咱们介绍一下整个需求的背景：

• 第一个版本：应用版本为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方法当中：

此时的数据库结构为：

2.2 第二个版本

当安装第二个版本的时候，咱们有两种状况：

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

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

针对前面说到的两种状况，整个执行的过程为：

• 没有安装或者运行过第一个版本，执行的onCreate，不执行onUpgrade，这时候就会建立两个表：

• 安装过第一个版本而且运行，执行onUpgrade，不执行onCreate：
  此时的数据库结构为：

2.3 第三个版本

前面两步都没有问题，那么接下来就是安装第三个版本，在第三个版本中咱们须要在second_table中增长一个新的字段column2，那么这时候就有如下三种状况：

• 用户的数据库中没有任何一个表，即不存在table.db。
• 用户的数据库中只有first_table，table.db的版本为1。
• 用户的数据库中有first_table、second_table，table.db的版本号为2。

所以，咱们就要对DBHelper类进行以下的修改：

针对于上面谈到的三种状况，执行的流程分别为：

• 只执行onCreate方法，直接建立带有column1/column2的second_table。
• 只执行onUpgrade方法，由于咱们的oldVersion为1，所以先走到第一个case语句，建立带有column1的second_table，因为该case语句没有break，所以接着会走到第二个case语句，在second_table中增长column2列。
• 只执行onUpgrade方法，此时的oldVersion为2，所以会直接执行第二个case语句，新增column2列。

此时的数据库结构为：

3、小结

以上就是对于数据库进行修改后的更新策略，每更新一个版本以后，咱们须要作如下几件事：

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

---

更多文章，欢迎访问个人 Android 知识梳理系列：

• Android 知识梳理目录：www.jianshu.com/p/fd82d1899…
• 我的主页：lizejun.cn
• 我的知识总结目录：lizejun.cn/categories/