Android — Room 数据库跳跃式升级(Migration)

Android-Room数据库(介绍)

Android-Room数据库-多表查询(Relationships)

Android—Room自定义类型(TypeConverter)

Android—Room 数据库迁移(Migration)

前言

在平时的开发时,数据库的升级并不总是按部就班的从 version: 1->2,2->3,3->4。总是会出现 version:1->3,或 2->4 的情况。这时候我们又该怎么办呢?

方法很简单。当用户升级 APP 时,我们替用户升级数据库版本。

具体做法:
version:1->2

static final Migration MIGRATION_1_2 = new Migration(1, 2) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        //do something
    }
};

version:2->3

static final Migration MIGRATION_2_3 = new Migration(2, 3) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        database.execSQL("ALTER TABLE student "
                + " ADD COLUMN phone_num TEXT");
    }
};

把migration 添加到 Room database builder:

database = Room.databaseBuilder(context.getApplicationContext(),
        StudentDatabase.class, "Demo.db")
        .addMigrations(MIGRATION_1_2, MIGRATION_2_3)
        .build();

复杂表操作:

字段类型修改

version:3->4

static final Migration MIGRATION_3_4 = new Migration(3, 4) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        //创建表
        database.execSQL(
                "CREATE TABLE student_new (student_id TEXT, student_name TEXT, phone_num INTEGER, PRIMARY KEY(student_id))");
        //复制表
        database.execSQL(
                "INSERT INTO student_new (student_id, student_name, phone_num) SELECT student_id, student_name, phone_num FROM student");
        //删除表
        database.execSQL("DROP TABLE student");
        //修改表名称
        database.execSQL("ALTER TABLE student_new RENAME TO students");
    }
};

多版本迁移

要是用户刚下载的 APP,想升级到版本最新版本呢?目前我们定义了migrations:version 1 到 2, version 2 到 3, version 3 到 4, 所以 Room 会一个接一个的触发所有 migration

其实 Room 可以处理大于 1 的版本增量:我们可以一次性定义一个从1 到4 的 migration,提升迁移的速度。

static final Migration MIGRATION_1_4 = new Migration(1, 4) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        //创建表
        database.execSQL(
                "CREATE TABLE student_new (student_id TEXT, student_name TEXT, phone_num INTEGER, PRIMARY KEY(student_id))");
        //复制表
        database.execSQL(
                "INSERT INTO student_new (student_id, student_name, phone_num) SELECT student_id, student_name, phone_num FROM student");
        //删除表
        database.execSQL("DROP TABLE student");
        //修改表名称
        database.execSQL("ALTER TABLE student_new RENAME TO students");
    }
};

接着,我们只需把它添加到 migration 列表中:

database = Room.databaseBuilder(context.getApplicationContext(),
        StudentDatabase.class, "Demo.db")
        .addMigrations(MIGRATION_1_2, MIGRATION_2_3, MIGRATION_3_4, MIGRATION_1_4)
        .build();

到这里版本升级结束了。

我的博客即将搬运同步至腾讯云+社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=1uwh50gnicplg

推荐阅读更多精彩内容