/***************************************************************************************/
升级数据库的最佳写法
关于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第一行代码》一书中,在次表示感谢。