本文介绍了如何在Android中使用Room框架进行数据库升级，包括Migration类的使用，版本控制，以及如何处理升级过程中的异常，如缺失迁移操作可能导致的数据丢失。作者还提供了实际的代码示例和注意事项。
- 扩展知识
===========================================================================
随着业务的变化，数据库可能也需要做一些调整，列如新增或则修改一个字段等等。这时候就需要对数据库进行升级的操作了。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 详细知识点思维脑图（技能树）】
我个人是做Android开发，已经有十来年了，目前在某创业公司任职CTO兼系统架构师。虽然 Android 没有前几年火热了，已经过去了会四大组件就能找到高薪职位的时代了。这只能说明 Android 中级以下的岗位饱和了，现在高级工程师还是比较缺少的，很多高级职位给的薪资真的特别高（钱多也不一定能找到合适的），所以努力让自己成为高级工程师才是最重要的。
这里附上上述的面试题相关的几十套字节跳动，京东，小米，腾讯、头条、阿里、美团等公司19年的面试题。把技术点整理成了视频和PDF（实际上比预期多花了不少精力），包含知识脉络 + 诸多细节。
由于篇幅有限，这里以图片的形式给大家展示一小部分。
网上学习 Android的资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。希望这份系统化的技术体系对大家有一个方向参考。
最后，赠与大家一句话，共勉！
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
十套字节跳动，京东，小米，腾讯、头条、阿里、美团等公司19年的面试题。把技术点整理成了视频和PDF（实际上比预期多花了不少精力），包含知识脉络 + 诸多细节。
由于篇幅有限，这里以图片的形式给大家展示一小部分。
[外链图片转存中…(img-lNgTPH9y-1712659004373)]
网上学习 Android的资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。希望这份系统化的技术体系对大家有一个方向参考。
最后，赠与大家一句话，共勉！
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
扫一扫
2266
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
