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

异常处理

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

如果我们将数据库升级到了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()

}

}

}

}

如此，第一次升级新增表就可以了。

下面将数据库由2升级到3，在FruitEntity中新增一个字段。

1.新增text2字段在FruitEntity中

@ColumnInfo(name = FRUIT_TABLE_OTHER_NAME)

val text2: String?

const val FRUIT_TABLE_OTHER_NAME = “fruit_other_name”

2.StudentDataBase升级为3，新增MIGRATION_2_3，并且加入addMigrations中

//升级version 为3

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

abstract class StudentDataBase : RoomDatabase()

//新增MIGRATION_2_3

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

override fun migrate(database: SupportSQLiteDatabase) {

//FRUIT 表 新增一列

database.execSQL("ALTER TABLE $FRUIT_TABLE_NAME ADD COLUMN $FRUIT_TABLE_OTHER_NAME TEXT ")

}

}

//加入addMigrations中

Room.databaseBuilder(

AppUtil.application,

StudentDataBase::class.java,

STUDENT_DB_NAME

)

.addMigrations(MIGRATION_1_2,MIGRATION_2_3)

.fallbackToDestructiveMigration()

.build()

3.测试代码修改，多传入text2字段的值。

conflateEntityDao.insertFruit(FruitEntity(text = “apple”,text2 = “other apple2”))

val obtainFruit = conflateEntityDao.obtainFruit()

withContext(Dispatchers.Main.immediate){

binding.text.text = obtainFruit.toString()

}

这个数据库由2到3也升级完成了。注意字段声明为可空类型，这样的数据没有text2字段，对应的返回结果为null。

扩展知识

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

在Sqlite中修改表结构比较麻烦。例如，我们想将Student表中的age字段类型从INTEGER改为TEXT。

最好的方式是采用销毁与重建策略，该策略大致分为以下几个步骤。

1. 创建符合要求的临时表，比如：temp_student.

最后

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

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

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

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

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

[外链图片转存中…(img-WA8vCBNA-1715757720530)]

[外链图片转存中…(img-kfCTd6mT-1715757720531)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

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