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第一行代码》一书中，在次表示感谢。