都知道在Android中SQLiteOpenHelper是用来创建和升级数据库,参考
$ANDROID_SDK_HOME/docs/reference/android/database/sqlite/SQLiteOpenHelper.html
软件发布出去了,用户已经安装使用了,但是随着软件的升级,数据库结构做了些改动,我们不希望用户把应用卸载了再装(这样会丢失应用所有的数据),我们希望在数据库总体结构和已有数据不变的情况下做些小的改动,比如新增一个字段或索引,新增加一个表等等,那么这个时候我们就要用到这个类了
常用的也就是onCreate和onUpgrade这两个方法,在使用的时候这两个方法都需要重写,里面实现自己的逻辑
我们先列出一个场景:
假设第一版程序发布出去,First Public Version,代码如下
@Override
public void onCreate(SQLiteDatabase db) {
bootstrapDB(db);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
onUpgrade里面没有代码,第一版出去没有需要更新的,bootstrapDB方法就是些DDL和数据初始化操作等等
之后过了一段时间,新的程序发布(其中数据库结构做了些变化),这个时候已经开始使用第一版程序的用户就需要升级,我们不希望他已经存在的数据被破坏,那么我们发布出去的新的版本中代码该怎么写呢?
直接看代码,这些代码都是从Android自带的应用中抽取出来的,做了些具体业务上的简化,主要是阐述清楚用法
@Override
public void onCreate(SQLiteDatabase db) {
bootstrapDB(db); // 这个方法里面都是最新版的初始化方法
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
Log.i(TAG, "Upgrading DB from version " + oldVersion + " to "
+ newVersion);
if (oldVersion == 1) {
upgradeToVersion2(db);
oldVersion += 1;
}
Log.v("do upgrade", "我更新了。。。");
}
这样如果后来又有新的程序发布,那么这两个方法会变成类似这个样子
@Override
public void onCreate(SQLiteDatabase db) {
bootstrapDB(db); // 这个方法里面始终都是最新版的初始化方法
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
Log.i(TAG, "Upgrading DB from version " + oldVersion + " to "
+ newVersion);
if (oldVersion == 1) {
upgradeToVersion2(db);
oldVersion += 1;
}
if (oldVersion == 2) {
upgradeToVersion3(db);
oldVersion += 1;
}
// 这是一种逐级更新的方式
// 对于目前使用的还是第一版的用户而言,会先执行完upgradeToVersion2再执行upgradeToVersion3
// 对于目前使用的还是第二版的用户而言,会执行upgradeToVersion3
Log.v("do upgrade", "我更新了。。。");
}
这样也许就能看的很清楚这个类的意图和用法了,后面版本一直增加的话,我们就一直这样写就好,保证全新的用户和升级的用户都能正常使用,那么我们如何来调用呢
一般我们会有个构造方法,有个参数就是数据库的版本,比如下面这两个构造方法
public MyDatabaseHelper(Context context, String name, CursorFactory factory,
int version) {
super(context, name, factory, version);
}
public MyDatabaseHelper(Context context, int version) {
super(context, NAME, null, version);
}
采用如下方式调用
helper = new MyDatabaseHelper(context, 10); // 这个数据库版本号会随着程序的每次发布而变化,是表示每次需要更新到的版本号,也就是最新的版本号
sqlite = helper.getWritableDatabase();
其实更好理解这个用法就是读SQLiteOpenHelper.getWritableDatabase这个方法,里面有段代码
int version = db.getVersion();
if (version != mNewVersion) {
db.beginTransaction();
try {
if (version == 0) {
onCreate(db);
} else {
onUpgrade(db, version, mNewVersion);
}
db.setVersion(mNewVersion);
db.setTransactionSuccessful();
} finally {
db.endTransaction();
}
}
另外,看看set/get Version就知道数据库版本标记是通过PRAGMA user_version;这个命令来完成的,你也可以用sqlite3之类的工具把数据库文件打开,然后执行PRAGMA user_version查看或者设置版本值
如下是完整的两个代码,是目前在使用的