一、前言

在项目当中使用数据库时，由于需求的增加，因此不可避免地要在原有的数据库当中增加新的字段，这时候就要在SQLiteOpenHelper的onUpgrade方法进行处理，关于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方法当中：

此时的数据库结构为：

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列。

此时的数据库结构为：

三、小结

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

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

---

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

• Android 知识梳理目录：http://www.jianshu.com/p/fd82d18994ce
• 个人主页：http://lizejun.cn
• 个人知识总结目录：http://lizejun.cn/categories/