Jetpack：Room数据库升级详解实战！(1)

• 扩展知识

---

Room升级简介

===========================================================================

随着业务的变化，数据库可能也需要做一些调整，列如新增或则修改一个字段等等。这时候就需要对数据库进行升级的操作了。Android提供了一个Migration类，来对Room数据库进行升级。

public Migration(int startVersion, int endVersion) {

this.startVersion = startVersion;

this.endVersion = endVersion;

}

Migration有两个参数，startVersion和endVersion。startVersion表示当前数据库版本（设备上安装的版本），endVersion表示将要升级到的版本。如果设备中的应用程序数据库版本为1，以下Migration会将你的数据库版本从1升级到2。

private val MIGRATION_1_2 = object :Migration(1,2){

override fun migrate(database: SupportSQLiteDatabase) {

//执行与数据库升级相关的操作

}

}

以此类推，如果需要将数据库由2升级到3，则进行如下的声明。

private val MIGRATION_2_3 = object :Migration(2,3){

override fun migrate(database: SupportSQLiteDatabase) {

//执行与数据库升级相关的操作

}

}

如果当前用户的数据库时1，直接安装了升级到3版本的应用，那么此时Room会按照顺序先后执行Migration（1，2）、Migration（2，3）以完成升级。

最后，通过addMigration将升级方案加入到room中。

Room.databaseBuilder(

AppUtil.application,

StudentDataBase::class.java,

STUDENT_DB_NAME

)

.addMigrations(MIGRATION_1_2,MIGRATION_2_3)

.build()

异常处理

=======================================================================

如果我们将数据库升级到了3，但是缺没有写对应的migration，那么使用的时候room直接回抛出IllagelStateException。因为Room在升级过程中没有匹配到相应的Migration。为了防止出现升级失败导致应用程序崩溃的情况，可以在创建数据库时加入fallbackToDestructiveMigration()方法。该方法能够在出现升级异常时，重新创建数据表。**需要注意的是，虽然应用程序不会崩溃，但由于数据表被重新创建，所有的数据也将会丢失。**如下所示：

Room.databaseBuilder(

AppUtil.application,

StudentDataBase::class.java,

STUDENT_DB_NAME

)

.addMigrations(MIGRATION_1_2,MIGRATION_2_3)

.fallbackToDestructiveMigration()

.build()

实战

=====================================================================

本例子基于前面预先创建好的学生数据库表，进行两次升级，第一次升级增加Fruit表，第二次在Fruit表中新增字段。可参考Jetpack：Room超详细使用踩坑指南！Jetpack:Room配合LiveData/Flow使用优化，Room+Flow使用原理解析。

1.创建Fruit表实体类

@Entity(tableName = FRUIT_TABLE_NAME)

data class FruitEntity(

@PrimaryKey(autoGenerate = true)

@ColumnInfo(name = FRUIT_TABLE_ID)

val id: Int = 0,

@ColumnInfo(name = FRUIT_TABLE_TEXT)

val text: String?

)

/**

• 表名字相关，统一定义.

*/

const val FRUIT_TABLE_NAME = “fruit”

const val FRUIT_TABLE_ID = “fruit_id”

const val FRUIT_TABLE_TEXT = “fruit_name”

2.在数据升级的声明的Database注解中，新加入Fruit实体类，升级版本为2。

//之前

@Database(entities = arrayOf(StudentEntity::class), version = 1)

abstract class StudentDataBase : RoomDatabase()

//新增FruitEntity实体类 升级版本号

@Database(entities = arrayOf(StudentEntity::class,FruitEntity::class), version = 2)

abstract class StudentDataBase : RoomDatabase()

3.新增migration，同事设置进addMigration方法。

/**

• 数据库升级 1 到 2

*/

private val MIGRATION_1_2 = object :Migration(1,2){

override fun migrate(database: SupportSQLiteDatabase) {

//新增 FRUIT 表

database.execSQL(“CREATE TABLE IF NOT EXISTS $FRUIT_TABLE_NAME ($FRUIT_TABLE_ID INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, $FRUIT_TABLE_TEXT TEXT)”)

}

}

//修改数据库声明，将MIGRATION_1_2 设置进addMigrations

fun getDataBase(): StudentDataBase {

return INSTANT ?: synchronized(this) {

INSTANT ?: Room.databaseBuilder(

AppUtil.application,

StudentDataBase::class.java,

STUDENT_DB_NAME

).addMigrations(MIGRATION_1_2)

.fallbackToDestructiveMigration()

.build()

.also {

INSTANT = it

}

}

}

写Dao接口，测试：

@Dao

interface ConflateDao {

@Query(“select * from $FRUIT_TABLE_NAME”)

suspend fun obtainFruit() : List

@Insert

suspend fun insertFruit(fruitEntity: FruitEntity)

}

//StudentDataBase中获取Dao

abstract fun getConflateEntityDao():ConflateDao

//activity 测试代码

btnTransactionInsertGet.text = “MIGRATION TEST”

btnTransactionInsertGet.setOnClickListener {

val conflateEntityDao = StudentDataBase.getDataBase().getConflateEntityDao()

lifecycleScope.launch {

StudentDataBase.getDataBase().withTransaction {

conflateEntityDao.insertFruit(FruitEntity(text = “apple”)

val obtainFruit = conflateEntityDao.obtainFruit()

withContext(Dispatchers.Main.immediate){

binding.text.text = obtainFruit.toString()

}

}

}

}

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

文末

架构师不是天生的，是在项目中磨练起来的，所以，我们学了技术就需要结合项目进行实战训练，那么在Android里面最常用的架构无外乎 MVC，MVP，MVVM，但是这些思想如果和模块化，层次化，组件化混和在一起，那就不是一件那么简单的事了，我们需要一个真正身经百战的架构师才能讲解透彻其中蕴含的深理。

一线互联网Android面试题总结含详解（初级到高级专题）

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

外乎 MVC，MVP，MVVM，但是这些思想如果和模块化，层次化，组件化混和在一起，那就不是一件那么简单的事了，我们需要一个真正身经百战的架构师才能讲解透彻其中蕴含的深理。

[外链图片转存中…(img-3gKlXTBh-1712658970889)]

[外链图片转存中…(img-AUmFoufC-1712658970889)]

一线互联网Android面试题总结含详解（初级到高级专题）

[外链图片转存中…(img-Ihzil9Rp-1712658970889)]

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！