Android学习笔记----升级SQLite数据库的最佳写法

/***************************************************************************************/

升级数据库的最佳写法

关于SQLite数据库的基本用法，可以阅读我的上篇博客  Android学习笔记----SQLite数据库的基本用法

每一个数据库版本都会对应一个版本号，当指定的数据库版本号大于当前数据库版本号的时候，就会进入到 onUpgrade()方法中去执行更新操作。这里需要为每一个版本号赋予它各自改变的内容，然后在 onUpgrade()方法中对当前数据库的版本号进行判断，再执行相应的改变就可以了。 接着就让我们来模拟一个数据库升级的案例，还是由 MyDatabaseHelper 类来对数据库 进行管理。

第一版的程序要求非常简单， 只需要创建一张 Book 表， MyDatabaseHelper 中的 代码如下所示：

public class MyDatabaseHelper extends SQLiteOpenHelper {

    public static final String CREATE_BOOK = "create table Book ("+ "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
    + "name text)";

    public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {
        super(context, name, factory, version);
    }
    
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    }
}

不过， 几星期之后又有了新需求，这次需要向数据库中再添加一张 Category 表。于是， 修改 MyDatabaseHelper 中的代码，如下所示：

public class MyDatabaseHelper extends SQLiteOpenHelper {
    public static final String CREATE_BOOK = "create table Book ("
        + "id integer primary key autoincrement, "
        + "author text, "
        + "price real, "
        + "pages integer, "
        + "name text)";
        
        public static final String CREATE_CATEGORY = "create table Category ("
        + "id integer primary key autoincrement, "
        + "category_name text, "
        + "category_code integer)";

    public MyDatabaseHelper(Context context, String name,CursorFactory factory, int version) {
            super(context, name, factory, version);
    }
    
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
        db.execSQL(CREATE_CATEGORY);
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        switch (oldVersion) {
            case 1:
                db.execSQL(CREATE_CATEGORY);
            default:
       }
    }
}

可以看到，在 onCreate()方法里我们新增了一条建表语句，然后又在 onUpgrade()方法中 添加了一个 switch 判断，如果用户当前数据库的版本号是 1，就只会创建一张 Category 表。 这样当用户是直接安装的第二版的程序时，就会将两张表一起创建。而当用户是使用第二版 的程序覆盖安装第一版的程序时，就会进入到升级数据库的操作中，此时由于 Book 表已经 存在了，因此只需要创建一张 Category 表即可。 但是没过多久，新的需求又来了，这次要给 Book 表和 Category 表之间建立关联，需要 在 Book 表中添加一个 category_id 的字段。再次修改 MyDatabaseHelper 中的代码，如下所示：

public class MyDatabaseHelper extends SQLiteOpenHelper {
        public static final String CREATE_BOOK = "create table Book ("
            + "id integer primary key autoincrement, "
            + "author text, "
            + "price real, "
            + "pages integer, "
            + "name text, "
            + "category_id integer)";
        
        public static final String CREATE_CATEGORY = "create table Category ("
            + "id integer primary key autoincrement, "
            + "category_name text, "
            + "category_code integer)";

        public MyDatabaseHelper(Context context, String name,CursorFactory factory, int version) {
                super(context, name, factory, version);
        }
        
        @Override
        public void onCreate(SQLiteDatabase db) {
               db.execSQL(CREATE_BOOK);
                db.execSQL(CREATE_CATEGORY);
        }
        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
               switch (oldVersion) {
                    case 1:
                        db.execSQL(CREATE_CATEGORY);
                    case 2:
                        db.execSQL("alter table Book add column category_id integer");
                    default:
           }
    }
}

可以看到，首先我们在 Book 表的建表语句中添加了一个 category_id 列，这样当用户直 接安装第三版的程序时，这个新增的列就已经自动添加成功了。然而，如果用户之前已经安 装了某一版本的程序，现在需要覆盖安装，就会进入到升级数据库的操作中。在 onUpgrade() 方法里，我们添加了一个新的 case，如果当前数据库的版本号是 2，就会执行 alter 命令来为 Book 表新增一个 category_id 列。 这里请注意一个非常重要的细节， switch 中每一个 case 的最后都是没有使用 break 的， 为什么要这么做呢？这是为了保证在跨版本升级的时候，每一次的数据库修改都能被全部执 行到。比如用户当前是从第二版程序升级到第三版程序的，那么 case 2 中的逻辑就会执行。 而如果用户是直接从第一版程序升级到第三版程序的，那么 case 1 和 case 2 中的逻辑都会执 行。使用这种方式来维护数据库的升级，不管版本怎样更新，都可以保证数据库的表结构是 最新的，而且表中的数据也完全不会丢失了。

注：此博客摘自郭琳老师的《Android第一行代码》一书中，在次表示感谢。