Android SQLite数据库版本升级（分逐级升级和跨版本升级）

参考：Android Sqlite数据库跨版本升级 保存之前数据

本文说的数据库升级是基于Android原生APISQLiteOpenHelper实现的逻辑，不涉及第三方库。其实如果使用官方推荐的Room库的话，可以利用RoomDatabase.Builder.addMigrations()方法配合Migration类灵活的设置迁移（升级）路径，根本不需要自己来实现其中的逻辑。

首先，关于SQLiteOpenHelper类我们需要知道几点：onCreate()方法只在第一次创建数据库的时候调用，onUpgrade()方法只在数据库版本升级时调用，并且也只调用一次。

逐级升级

顾名思义，就是一级级的往上升。比如，当前版本为1，最新版本是3，你必须得先升到2才行。

我们来看具体实现：

1. 最新版本为1时，也就是最初版本：

	private static final int VERSION = 1;
	
    @Override
    public void onCreate(SQLiteDatabase db) {
        // 实现最初版本数据库模式(schema)
    }

直接在onCreate()中实现你的需求就行了。

2. 最新版本为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. 最新版本为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我们可以很方便的跨到任意版本，再通过程序原本的顺序执行流程，我们又可以在跨到目标版本后再逐级升级，甚至可以再跨再逐级，跨版本和逐级随意组合，非常灵活。

顶部的参考文章对于逐级升级的描述更为详细生动，本来打算只是收藏，但想到了跨版本升级的这种写法，怕遗忘就做了个笔记。逐级升级的写法应该很普遍了，应该不至于有什么问题，而跨版本升级我只是思想上验证了下，没有写代码去测试，如果有什么问题欢迎指正。