Android-Room数据库(介绍)
Android-Room数据库-多表查询(Relationships)
Android—Room自定义类型(TypeConverter)
Android—Room 数据库迁移(Migration)
Android—Room 通用封装
前言
在平时的开发时,数据库的升级并不总是按部就班的从 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