参考:Android Sqlite数据库跨版本升级 保存之前数据
本文说的数据库升级是基于Android原生APISQLiteOpenHelper
实现的逻辑,不涉及第三方库。其实如果使用官方推荐的Room库的话,可以利用RoomDatabase.Builder.addMigrations()
方法配合Migration
类灵活的设置迁移(升级)路径,根本不需要自己来实现其中的逻辑。
首先,关于SQLiteOpenHelper
类我们需要知道几点:onCreate()
方法只在第一次创建数据库的时候调用,onUpgrade()
方法只在数据库版本升级时调用,并且也只调用一次。
逐级升级
顾名思义,就是一级级的往上升。比如,当前版本为1,最新版本是3,你必须得先升到2才行。
我们来看具体实现:
- 最新版本为1时,也就是最初版本:
private static final int VERSION = 1;
@Override
public void onCreate(SQLiteDatabase db) {
// 实现最初版本数据库模式(schema)
}
直接在onCreate()
中实现你的需求就行了。
- 最新版本为2时:
private static final int VERSION = 2;
@Override
public void onCreate(SQLiteDatabase db) {
// 直接改为版本2的数据库模式
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 版本1到版本2的升级操作
}
这里得区分两种情况:用户首次安装最新版和用户在第1版的基础上升级到最新版。
前者需要我们重新实现onCreate()
方法,照着最新的模式实现就行。
如果是后者,我们需要实现onUpgrade()
方法,在这里保证不丢失数据的情况下升级数据库到最新模式。
- 最新版本为3时:
private static final int VERSION = 3;
@Override
public void onCreate(SQLiteDatabase db) {
// 直接改为版本3的数据库模式
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
switch (oldVersion) {
case 1:
// 版本1到版本2的升级操作
case 2:
// 版本2到版本3的升级操作
default:
break;
}
}
对于新用户和上面一样修改onCreate()
就行。
但对于老用户,这时我们不能只实现相对于上个版本的升级逻辑了,因为用户可能是从安装以来就没升过级,现在从版本1直接升级到版本3,所以我需要先实现1到2的逻辑,再实现2到3的逻辑,代码如上。注意不要加break
语句。
依次类推,数据库版本每升一级就在switch
语句中增加一个case
分支,并写上相应的升级操作。这样不管用户当前版本是多少,都会从当前版本一路升级到最新版本。
很明显,这样实现很方便开发人员维护,但是有时候不够效率。试想一个极端情况:现在第4版来了,数据库模式要改回最初版,这时应该怎么实现呢?当然我们可以像上面一样,在switch
中加上基于第3版的升级逻辑,无论用户现在是什么版本,都逐级升级。这样好像也可以,但效率却可想而知,尤其是使用第1版的用户,明明和第4版一摸一样,却要绕一大圈再回到起点,是不是有点多次一举。如果我们能直接升级到第4版该多好。由此,就引出了跨版本升级的必要性。
跨版本升级
如上节讨论的,怎样实现从第一版到第4版的直接升级呢,看代码:
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
{if (oldVersion == 1) {
// 版本1到版本4的升级操作
oldVersion = 4;
}
if (oldVersion == 2) {
// 版本2到版本3的升级操作
oldVersion++;
}
if (oldVersion == 3) {
// 版本3到版本4的升级操作
oldVersion++;
}
}
这样设计好像也没什么特别的,但我们再升级一个版本看看:
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
{if (oldVersion == 1) {
// 版本1到版本4的升级操作
oldVersion = 4;
}
if (oldVersion == 2) {
// 版本2到版本3的升级操作
oldVersion++;
}
if (oldVersion == 3) {
// 版本3到版本4的升级操作
oldVersion++;
}
if (oldVersion == 4) {
// 版本4到版本5的升级操作
oldVersion++;
}
}
可以看到,从版本1到版本5(甚至后续版本),我们可以先跨到版本4,再逐级升级。通过修改oldVersion
我们可以很方便的跨到任意版本,再通过程序原本的顺序执行流程,我们又可以在跨到目标版本后再逐级升级,甚至可以再跨再逐级,跨版本和逐级随意组合,非常灵活。
顶部的参考文章对于逐级升级的描述更为详细生动,本来打算只是收藏,但想到了跨版本升级的这种写法,怕遗忘就做了个笔记。逐级升级的写法应该很普遍了,应该不至于有什么问题,而跨版本升级我只是思想上验证了下,没有写代码去测试,如果有什么问题欢迎指正。