JetPack学习之Room使用

tsm2023-10-20 13:56

由于Room使用了大量的APT 技术,从源码的角度来分析并不是非常好,所以关于Room相关的内容的就以使用来进行

关于Room 使用 一共有3大部分

Entity 表

在Room中一个被 @Entity 标识的 实体类 就代表着一张表,可以是使用 tableName = "tsmtest" 来明确表明

示例如下

less 复制代码 
@Entity(tableName = "tsmtest")
class TsmTestEntity {

    @PrimaryKey(autoGenerate = true)
    @ColumnInfo(name = "id")
    var id:Long?=null

    @ColumnInfo(name = "name")
    var name:String?=null

    @ColumnInfo(name = "address")
    var address:String?=null

    @ColumnInfo(name = "age")
    var age:Int?=null

    constructor(name: String?, address: String?, age: Int?) {
        this.name = name
        this.address = address
        this.age = age
    }

    override fun toString(): String {
        return "TsmTestEntity(id=$id, name=$name, address=$address, age=$age)"
    }


}

Dao

关于Dao 层使用起来也是非常简单的,只需要使用@Dao 来注解这个类,增删改查方法使用单独的注解,这里面有一点让我特别惊讶,那就是对LiveData 的支持,真的是非常的强大

less 复制代码 
@Dao
interface TsmTestDao  {

    @Insert
    fun insertTsmTest(tsm:TsmTestEntity)



    @Delete
    fun delete(tsm:TsmTestEntity)


    @Update
    fun upData(tsm:TsmTestEntity)

    @Query("select * from tsmtest where name =:name")
    fun getTsm(name: String):TsmTestEntity


    @Query("select * from tsmtest")
    fun getAllTsm():MutableList<TsmTestEntity>

    @Query("select * from tsmtest")
    fun getAllLiveData():LiveData<MutableList<TsmTestEntity>>


}

DataBase

在使用DataBase 的过程中,需要由3个注意点 1: 需要给DataBase的类添加一些注解,这个注解包括版本号, 关联哪些Dao等,同时这个类必须继承自 RoomDatabase

2: 这个类必须是抽象类

3: 需要实现getDao 的方法

4: 将DataBase 获取设置单利

例子大致如下

kotlin 复制代码 
@Database(entities = [TsmTestEntity::class], version = 1, exportSchema = false)
abstract class TsmTestDB : RoomDatabase() {


    abstract fun getTsmDao():TsmTestDao

    companion object{
       private var tsmDB:TsmTestDB ?=null


        fun getInstance(context: Context):TsmTestDB{
            if(tsmDB==null){
                synchronized(TsmTestDao::class){
                    if(tsmDB==null){
                        tsmDB=Room.databaseBuilder(context.applicationContext,TsmTestDB::class.java,"tsm_test.db")
                            .allowMainThreadQueries().build()
                    }
                }
            }
            return tsmDB!!
        }

    }
}

在使用上就看一下 Room 对LiveData 的支持,以及利用这个我们能做一些什么

kotlin 复制代码 
TsmTestDB.getInstance(this).getTsmDao().getAllLiveData().observe(this) {
    it.forEach {item->
        Log.i("tian.shm", "1-->${item.toString()}")
    }
}

利用LiveData 我们可以监听数据库发生变化,这就让整个流程非常的顺利, 日志如下

bash 复制代码 
2023-10-19 23:29:39.901 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=1, name=Tsm1, address=地址1, age=10)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=2, name=这个需要修改一下, address=地址2, age=20)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=3, name=Tsm3, address=地址3, age=30)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=4, name=Tsm4, address=地址4, age=40)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=5, name=Tsm5, address=地址5, age=50)

示例场景

有一个App ,他是多组件的应用,在没有中间件协调的时候,我们如何通知上层组件数据更新了呢,就比如说用户切换了登录信息,如果每次检查就会造成逻辑的复杂度增加, Room + LiveData 就为我们提供一个完美的解决方案,底层组件直接更新数据库的用户信息,在顶层组件使用 Room 就能监听到

数据库升级

关于 Room 数据库升级也是非常简单的

示例代码如下

kotlin 复制代码 
//  这个里面的 Migration(1, 2) 代表着数据库版本从1 升级到2 ,就会执行一下的语句 
private val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 这句话的意思就是在 表中添加一列数据 ,类型为 text 字符
        database.execSQL("ALTER TABLE tsmtest " + " ADD COLUMN tsm TEXT ")
    }
}

我们需要在DB 初始化的时候使用这个升级的方法

kotlin 复制代码 
fun getInstance(context: Context):TsmTestDB{
    if(tsmDB==null){
        synchronized(TsmTestDao::class){
            if(tsmDB==null){
                tsmDB=Room.databaseBuilder(context.applicationContext,TsmTestDB::class.java,"tsm_test.db")
                    .allowMainThreadQueries()
                    // 添加升级方法方法
                    .addMigrations(MIGRATION_1_2)
                    .build()
            }
        }
    }
    return tsmDB!!
}

同时在TsmTestEntity 中添加一个tsm 的数据,

less 复制代码 
@Entity(tableName = "tsmtest")
class TsmTestEntity {

    @PrimaryKey(autoGenerate = true)
    @ColumnInfo(name = "id")
    var id:Long?=null

    @ColumnInfo(name = "name")
    var name:String?=null

    @ColumnInfo(name = "address")
    var address:String?=null

    @ColumnInfo(name = "age")
    var age:Int?=null
    
    
    
    //TODO 版本2新增
    @ColumnInfo(name = "tsm")
    var tsm:String?=null


    constructor(name: String?, address: String?, age: Int?) {
        this.name = name
        this.address = address
        this.age = age
    }

    override fun toString(): String {
        return "TsmTestEntity(id=$id, name=$name, address=$address, age=$age, tsm=$tsm)"
    }


}

在没有升级后的版本监听到的数据是

bash 复制代码 
2023-10-19 23:29:39.901 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=1, name=Tsm1, address=地址1, age=10)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=2, name=这个需要修改一下, address=地址2, age=20)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=3, name=Tsm3, address=地址3, age=30)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=4, name=Tsm4, address=地址4, age=40)
2023-10-19 23:29:39.902 26063-26063/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=5, name=Tsm5, address=地址5, age=50)

升级后监听到的数据如下

bash 复制代码 
2023-10-19 23:43:39.335 27342-27342/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=1, name=Tsm1, address=地址1, age=10, tsm=null)
2023-10-19 23:43:39.335 27342-27342/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=2, name=这个需要修改一下, address=地址2, age=20, tsm=null)
2023-10-19 23:43:39.335 27342-27342/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=3, name=Tsm3, address=地址3, age=30, tsm=null)
2023-10-19 23:43:39.335 27342-27342/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=4, name=Tsm4, address=地址4, age=40, tsm=null)
2023-10-19 23:43:39.335 27342-27342/com.tsm.tsmroom I/tian.shm: 1-->TsmTestEntity(id=5, name=Tsm5, address=地址5, age=50, tsm=null)

如何查看 DataBase 里面的 db文件,可以在AndroidStudio 中下载插件 Database Navigator,就可以非常简单的浏览我们的表结构了

步骤大致如下 1: 在plugins 中下载 Database Navigator 插件

2: 在 /data/data/[包名]/databases 中将数据库文件导出

3:双击 Shift 键 搜索 DB 就能看到 DB Browser ,同时也可以在 Project 的左侧工具栏看到这个功能,不过还是快捷键好用一些

4:导入db 文件

5: 链接展示

6:在查看完之后 发现这个db文件无法被删除,原因就是我们的AS 使用了他,需要先断开连接

相关推荐
帅次4 天前
Android Studio：驱动高效开发的全方位智能平台
android·ide·flutter·kotlin·gradle·android studio·android jetpack
时空掠影1 个月前
Kotlin compose 实现Image 匀速旋转
android·java·开发语言·ios·kotlin·android jetpack·android-studio
白瑞德1 个月前
Android LiveData的使用和原理分析
android·android jetpack
alexhilton1 个月前
降Compose十八掌之『密云不雨』| Navigation
android·kotlin·android jetpack
白瑞德2 个月前
ViewModel的创建、销毁和恢复
android jetpack
张可2 个月前
开源一个 Compose 图片查看框架ImageViewer，支持多种手势。
android·kotlin·android jetpack
bytebeats2 个月前
Jetpack Compose粘性标题的一种可行实现
android·android jetpack
彬_小彬2 个月前
Android mvvm最佳实践
android·android jetpack
alexhilton2 个月前
降Compose十八掌之『鱼跃于渊』| Gesture Handling
android·kotlin·android jetpack
Wgllss2 个月前
注解处理器在架构，框架中实战应用：MVVM中数据源提供Repository类的自动生成
android·架构·android jetpack
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04Coze扣子平台完整体验和实践（附国内和国际版对比）05苍穹外卖面试总结06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）08CCF-CSP认证考试 202406-3 文本分词 100分题解09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10浏览器插件——ModHeader 的分享和学习