sqlite数据库升级
Android SQLite数据库版本升级的管理实现
我们知道在SQLiteOpenHelper的构造方法:
super``(Context context, String name, SQLiteDatabase.CursorFactory factory,
int
version)
中最后一个参数表示数据库的版本号.当新的版本号大于当前的version时会调用方法:
onUpgrade(SQLiteDatabase db,
int
oldVersion,
int
newVersion)
所以我们的重点是在该方法中实现SQLite数据库版本升级的管理
当我们项目刚开始的时候第一版SQLiteOpenHelper是这样写的:
package
cc.database;
import
android.content.Context;
import
android.database.sqlite.SQLiteDatabase;
import
android.database.sqlite.SQLiteDatabase.CursorFactory;
import
android.database.sqlite.SQLiteOpenHelper;
/**
* Demo描述:
* SQLite数据库版本升级的管理实现
*
* 参考资料:
* [http://blog.csdn.net/guolin_blog](http://blog.csdn.net/guolin_blog)
* Thank you very much
*/
public
class
DataBaseOpenHelper
extends
SQLiteOpenHelper {
private
final
static
String DATABASE_NAME=``"test.db"``;
private
static
DataBaseOpenHelper mDataBaseOpenHelper;
public
static
final
String CREATE_PERSON=
"create table person(personid integer primary key autoincrement,name varchar(20),phone VARCHAR(12))"``;
public
DataBaseOpenHelper(Context context,String name,CursorFactory factory,``int
version) {
super``(context, name, factory, version);
}
//注意:
//将DataBaseOpenHelper写成单例的.
//否则当在一个for循环中频繁调用openHelper.getWritableDatabase()时
//会报错,提示数据库没有执行关闭操作
static
synchronized
DataBaseOpenHelper getDBInstance(Context context) {
if
(mDataBaseOpenHelper ==
null``) {
mDataBaseOpenHelper =
new
DataBaseOpenHelper(context,DATABASE_NAME,``null``,``1``);
}
return
mDataBaseOpenHelper;
}
@Override
public
void
onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_PERSON);
}
@Override
public
void
onUpgrade(SQLiteDatabase db,
int
oldVersion,
int
newVersion) {
}
}
在几天之后根据项目需求,需要添加一张student表,于是DataBaseOpenHelper就出现了第二版:
package
cc.database;
import
android.content.Context;
import
android.database.sqlite.SQLiteDatabase;
import
android.database.sqlite.SQLiteDatabase.CursorFactory;
import
android.database.sqlite.SQLiteOpenHelper;
public
class
DataBaseOpenHelper
extends
SQLiteOpenHelper {
private
final
static
String DATABASE_NAME=``"test.db"``;
private
static
DataBaseOpenHelper mDataBaseOpenHelper;
public
static
final
String CREATE_PERSON=
"create table person(personid integer primary key autoincrement,name varchar(20),phone VARCHAR(12))"``;
public
static
final
String CREATE_STUDENT=
"create table student(studentid integer primary key autoincrement,name varchar(20),phone VARCHAR(12))"``;
public
DataBaseOpenHelper(Context context,String name,CursorFactory factory,``int
version) {
super``(context, name, factory, version);
}
//注意:
//将DataBaseOpenHelper写成单例的.
//否则当在一个for循环中频繁调用openHelper.getWritableDatabase()时
//会报错,提示数据库没有执行关闭操作
static
synchronized
DataBaseOpenHelper getDBInstance(Context context) {
if
(mDataBaseOpenHelper ==
null``) {
//改动1
mDataBaseOpenHelper =
new
DataBaseOpenHelper(context,DATABASE_NAME,``null``,``2``);
}
return
mDataBaseOpenHelper;
}
@Override
public
void
onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_PERSON);
//改动2
db.execSQL(CREATE_STUDENT);
}
@Override
public
void
onUpgrade(SQLiteDatabase db,
int
oldVersion,
int
newVersion) {
//改动3
switch
(oldVersion) {
case
1``:
db.execSQL(CREATE_STUDENT);
default``:
}
}
}
较版本一在版本二中有三处修改的地方:
1 版本号变成了2
2 在onCreate()方法中添加了代码db.execSQL(CREATE_STUDENT);创建student表
因为有的用户根本就没有第一版本的APP,直接从市场下载了第二版本的App。所以当然会执行onCreate()而不会执行onUpgrade()
3 在onUpgrade()做了处理:当oldVersion为1时调用db.execSQL(CREATE_STUDENT);创建student表
因为有的用户手机上本来就有第一版本的APP,所以在App升级到第二版本时会执行onUpgrade(),不会执行onCreate()
通过这样的处理使得不同的情况下使用第二版APP时都会生成student表
又过了一个月,根据项目变更,需要给person表添加一个字段genderid,于是DataBaseOpenHelper就出现了第三版:
package
cc.database;
import
android.content.Context;
import
android.database.sqlite.SQLiteDatabase;
import
android.database.sqlite.SQLiteDatabase.CursorFactory;
import
android.database.sqlite.SQLiteOpenHelper;
public
class
DataBaseOpenHelper
extends
SQLiteOpenHelper {
private
final
static
String DATABASE_NAME=``"test.db"``;
private
static
DataBaseOpenHelper mDataBaseOpenHelper;
//改动1
public
static
final
String CREATE_PERSON=
"create table person(personid integer primary key autoincrement,name varchar(20),phone VARCHAR(12)),genderid integer)"``;
public
static
final
String ALTER_PERSON=``"alter table person add column genderid integer"``;
public
static
final
String CREATE_STUDENT=
"create table student(studentid integer primary key autoincrement,name varchar(20),phone VARCHAR(12))"``;
public
DataBaseOpenHelper(Context context,String name,CursorFactory factory,``int
version) {
super``(context, name, factory, version);
}
//注意:
//将DataBaseOpenHelper写成单例的.
//否则当在一个for循环中频繁调用openHelper.getWritableDatabase()时
//会报错,提示数据库没有执行关闭操作
static
synchronized
DataBaseOpenHelper getDBInstance(Context context) {
if
(mDataBaseOpenHelper ==
null``) {
//改动2
mDataBaseOpenHelper =
new
DataBaseOpenHelper(context,DATABASE_NAME,``null``,``3``);
}
return
mDataBaseOpenHelper;
}
@Override
public
void
onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_PERSON);
db.execSQL(CREATE_STUDENT);
}
@Override
public
void
onUpgrade(SQLiteDatabase db,
int
oldVersion,
int
newVersion) {
switch
(oldVersion) {
case
1``:
db.execSQL(CREATE_STUDENT);
//改动3
case
2``:
db.execSQL(ALTER_PERSON);
default``:
}
}
}
较版本二在版本三中有三处修改的地方:
1 改变了CREATE_PERSON语句,在改语句中增加了一个字段genderid
和前面的描述类似,有的用户第一次安装该APP时就直接下载了第三版
2 修改版本号为3
应对了用户从第一版本或者第二版本升级到第三版本的情况(见下分析)
3 在onUpgrade()方法中)做了处理:当oldVersion为2时调用 db.execSQL(ALTER_PERSON);修改person表,增加genderid字段
应对了用户从第二版本升级到第三版本的情况(见下分析)
注意一个问题:为什么这里的switch语句在每个case中没有break???
这是为了保证跨版本升级的时候每次数据库的升级都会执行到。
比如从第二版升级到第三版本,那么case 2会被执行。
比如从第一版直接升级到第三版本,那么case 1肯定会被调用,由于没有break所以会穿透switch语句又执行case 2语句继续升级,从而保证了数据的所有版本中的升级都会被执行到。
如有疑问请留言或者到本站社区交流讨论,感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!