=======================================================================
ORM(Object Relational Mapping)关系映射库,在Sqlite上提供了一层封装,优化数据库操作的便捷性。
Room的架构图如下所示:
-
Entity:一个Entity对应于数据库的一张表。Entity类是Sqlite表结构对Java类的映射,在Java中可以被看作一个Model类。
-
Dao:即 Data Access Objects,数据访问对象。顾名思义,我们可以通过它访问对象。
一个Entity对应一张表,而每张表都需要一个Dao对象,用于对表的增删改查。Room对象被实例化之后,我们就可以通过数据库实例得到Dao对象(Get Dao),然后通过Dao对象对表中的数据进行操作。
依赖
buildscript {
//android room version
ext.room_version = ‘2.3.0’
}
// room
implementation “androidx.room:room-runtime:$room_version”
kapt “androidx.room:room-compiler:$room_version”
// optional - room kotlin 扩展
implementation “androidx.room:room-ktx:$room_version”
=============================================================================
通过创建一个简单的学生数据库表,来熟悉Room的基本使用。
- 创建一个关于学生的Entity,即创建一张学生表SimpleStudentEntity。
Entity标签用于将SimpleStudent类与Room中的数据表对应起来。tableName属性可以为数据表设置表名,若不设置,则表名与类名相同。
PrimaryKey标签用于指定该字段作为表的主键。 autoGenerate = true Set to true to let SQLite generate the unique id.(设置为 true 让 SQLite 生成唯一的 id。)
ColumnInfo标签可用于设置该字段存储在数据库表中的名字,并指定字段的类型。
同时为了,其他地方对于表明以及字段相关的引用,我们这里声明为顶层常量(java 的静态常量),方便引用。
/**
- 表名字相关,统一定义.
*/
const val SIMPLE_STUDENT_TABLE_NAME = “simple_student”
const val SIMPLE_STUDENT_TABLE_STUDENT_ID = “student_id”
const val SIMPLE_STUDENT_TABLE_STUDENT_NAME = “student_name”
const val SIMPLE_STUDENT_TABLE_STUDENT_AGE = “student_age”
完整的SimpleStudentEntity.kt文件代码如下所示:
@Entity(tableName = SIMPLE_STUDENT_TABLE_NAME)
data class SimpleStudentEntity(
@NonNull
@PrimaryKey(autoGenerate = true)
@ColumnInfo(
name = SIMPLE_STUDENT_TABLE_STUDENT_ID,
typeAffinity = ColumnInfo.INTEGER
) val id: Int = 0,//该值设置为自增的主键,默认会在数据库中自增,这里随便设置一个默认值就可以
@NonNull
@ColumnInfo(name = SIMPLE_STUDENT_TABLE_STUDENT_NAME, typeAffinity = ColumnInfo.TEXT)
val name: String?,
@NonNull
@ColumnInfo(name = SIMPLE_STUDENT_TABLE_STUDENT_AGE, typeAffinity = ColumnInfo.TEXT)
val age: String?
)
/**
- 表名字相关,统一定义.
*/
const val SIMPLE_STUDENT_TABLE_NAME = “simple_student”
const val SIMPLE_STUDENT_TABLE_STUDENT_ID = “student_id”
const val SIMPLE_STUDENT_TABLE_STUDENT_NAME = “student_name”
const val SIMPLE_STUDENT_TABLE_STUDENT_AGE = “student_age”
- 针对上面这个学生Entity,我们需要定义一个Dao接口文件,以便对Entity进行访问。注意,在接口文件的上方,需要加入**@Dao**标签。
增删改查分别使用 Insert、Delete、Update、Query标记。可以在查询前面添加冒号 (:
) 来引用查询中的 Kotlin 值(例如,函数参数中的 :id
)
查询需要传入sql语句,不了解sql的可以google了解一下。
@Dao
interface SimpleStudentDao {
@Insert
fun insertStudent(studentEntity: SimpleStudentEntity)
@Insert
fun insertStudentAll(studentEntity: List)
@Delete
fun deleteStudent(studentEntity: SimpleStudentEntity)
@Update
fun updateStudent(studentEntity: SimpleStudentEntity)
@Query(“select * from $SIMPLE_STUDENT_TABLE_NAME”)
fun getStudentAll(): List
@Query(“select * from $SIMPLE_STUDENT_TABLE_NAME where $SIMPLE_STUDENT_TABLE_STUDENT_ID = :id”)
fun getStudentById(id: Int): List
}
- 定义好Entity和Dao后,接下来是创建数据库。
Database标签用于告诉系统这是Room数据库对象。
entities属性用于指定该数据库有哪些表,若需要建立多张表,则表名以逗号相隔开。
version属性用于指定数据库版本号,后面数据库的升级正是依据版本号进行判断的。
数据库类需要继承自RoomDatabase,并通过Room.databaseBuilder()结合单例设计模式完成创建。
另外,之前创建的Dao对象,在此以抽象方法的形式返回,所以自定义的Database是一个抽象类。
@Database(entities = arrayOf(SimpleStudentEntity::class), version = 1)
abstract class SimpleMyDataBase : RoomDatabase() {
companion object {
private const val DATA_NAME = “simple_db”
@Volatile
private var INSTANCE: SimpleMyDataBase? = null
/**
- 双重校验锁单例,返回数据库实例
*/
fun getDataBase(): SimpleMyDataBase = INSTANCE ?: synchronized(this) {
val instance = INSTANCE ?: Room
.databaseBuilder(AppUtil.application, SimpleMyDataBase::class.java, DATA_NAME)
.build().also {
INSTANCE = it
}
instance
}
}
/**
- 返回 SimpleStudentDao Dao对象
*/
abstract fun simpleStudentDao(): SimpleStudentDao
}
以上,数据库和表的创建工作就完成了。下面来看看如何对数据库进行增/删/改/查了吧。
需要注意的是,不能直接在UI线程中执行这些操作,所有操作都需要放在工作线程中进行。
写一个Activity,对上面的代码做一些测试。
定义ViewModel文件。Jetpack:ViewModel使用指南,实现原理详细解析!
class SimpleViewModel(private val simpleStudentDao: SimpleStudentDao) : ViewModel() {
fun insertStudent(studentEntity: SimpleStudentEntity) {
viewModelScope.launch(Dispatchers.Default) {
simpleStudentDao.insertStudent(studentEntity)
}
}
fun insertStudentAll(studentEntity: List) {
viewModelScope.launch(Dispatchers.Default) {
simpleStudentDao.insertStudentAll(studentEntity)
}
}
fun deleteStudent(studentEntity: SimpleStudentEntity) {
viewModelScope.launch(Dispatchers.Default) {
simpleStudentDao.deleteStudent(studentEntity)
}
}
fun updateStudent(studentEntity: SimpleStudentEntity) {
viewModelScope.launch(Dispatchers.Default) {
simpleStudentDao.updateStudent(studentEntity)
}
}
suspend fun getStudentAll(): List {
//使用主从作用域
return supervisorScope {
val students = async(Dispatchers.IO) {
simpleStudentDao.getStudentAll()
}
students.await()
}
}
suspend fun getStudentById(id: Int): List {
//使用主从作用域
return supervisorScope {
val students = async(Dispatchers.IO) {
simpleStudentDao.getStudentById(id)
}
students.await()
}
}
override fun onCleared() {
super.onCleared()
}
}
/**
- 自定义工厂,可传入Dao参数
*/
class MyViewModelFactory(private val dao: SimpleStudentDao) : ViewModelProvider.Factory {
override fun <T : ViewModel?> create(modelClass: Class): T {
if (modelClass.isAssignableFrom(SimpleViewModel::class.java)) {
@Suppress(“UNCHECKED_CAST”)
return SimpleViewModel(dao) as T
}
throw IllegalArgumentException(“Unknown ViewModel class.”)
}
}
Activity
class SimpleRoomDemoActivity : AppCompatActivity() {
/**
- binding
*/
private var _binding: ActivitySimpleUseRoomBinding? = null
private val binding get() = _binding!!
/**
- 数据库dao
*/
private val simpleDao: SimpleStudentDao by lazy(LazyThreadSafetyMode.NONE) {
SimpleMyDataBase.getDataBase().simpleStudentDao()
}
/**
- viewModel
*/
lateinit var viewModel: SimpleViewModel
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
_binding = ActivitySimpleUseRoomBinding.inflate(layoutInflater)
setContentView(binding.root)
initParam()
initView()
}
private fun initParam() {
viewModel = ViewModelProvider(
this,
//传入自己的工厂
MyViewModelFactory(simpleDao)
)[SimpleViewModel::class.java]
}
private fun initView() {
with(binding) {
btnInsert.setOnClickListener {
viewModel.insertStudent(SimpleStudentEntity(0, “zxf”, “18”))
}
btnInsertAll.setOnClickListener {
viewModel.insertStudentAll(
arrayListOf(
SimpleStudentEntity(0, “liSi”, “18”),
SimpleStudentEntity(0, “wangWu”, “18”)
)
)
}
//delete 和 update 是根据什么来的 看了源码生成的sql默认根据主键来的
btnDelete.setOnClickListener {
viewModel.deleteStudent(SimpleStudentEntity(2, “delete”, “99”))
// viewModel.deleteStudent(SimpleStudentEntity(199,“update”,“99”))
}
btnUpdate.setOnClickListener {
//所以我们这里面可以直接写一个默认的id去设置,不需要非要拿到查询的对象
// viewModel.updateStudent(SimpleStudentEntity(1,“update”,“99”))
viewModel.updateStudent(SimpleStudentEntity(199, “update”, “99”))
}
//看了一下查询生成的源代码,对于对象来说直接new了,所以不会返回null,但是对象的值,没有就是null,需要声明为可null类型
btnGetId.setOnClickListener {
lifecycleScope.launch {
displayToTextView(viewModel.getStudentById(5))
}
}
btnGetAll.setOnClickListener {
lifecycleScope.launch {
displayToTextView(viewModel.getStudentAll())
}
}
}
}
private fun displayToTextView(students: List) {
val string = students.joinToString(
“”"
面试复习笔记
这份资料我从春招开始,就会将各博客、论坛。网站上等优质的Android开发中高级面试题收集起来,然后全网寻找最优的解答方案。每一道面试题都是百分百的大厂面经真题+最优解答。包知识脉络 + 诸多细节。
节省大家在网上搜索资料的时间来学习,也可以分享给身边好友一起学习。
《960页Android开发笔记》
《1307页Android开发面试宝典》
包含了腾讯、百度、小米、阿里、乐视、美团、58、猎豹、360、新浪、搜狐等一线互联网公司面试被问到的题目。熟悉本文中列出的知识点会大大增加通过前两轮技术面试的几率。
《507页Android开发相关源码解析》
只要是程序员,不管是Java还是Android,如果不去阅读源码,只看API文档,那就只是停留于皮毛,这对我们知识体系的建立和完备以及实战技术的提升都是不利的。
真正最能锻炼能力的便是直接去阅读源码,不仅限于阅读各大系统源码,还包括各种优秀的开源库。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
资料我从春招开始,就会将各博客、论坛。网站上等优质的Android开发中高级面试题收集起来,然后全网寻找最优的解答方案。每一道面试题都是百分百的大厂面经真题+最优解答。包知识脉络 + 诸多细节。
节省大家在网上搜索资料的时间来学习,也可以分享给身边好友一起学习。
《960页Android开发笔记》
[外链图片转存中…(img-io1GAq3j-1714985087777)]
《1307页Android开发面试宝典》
包含了腾讯、百度、小米、阿里、乐视、美团、58、猎豹、360、新浪、搜狐等一线互联网公司面试被问到的题目。熟悉本文中列出的知识点会大大增加通过前两轮技术面试的几率。
[外链图片转存中…(img-H5Rog23g-1714985087779)]
《507页Android开发相关源码解析》
只要是程序员,不管是Java还是Android,如果不去阅读源码,只看API文档,那就只是停留于皮毛,这对我们知识体系的建立和完备以及实战技术的提升都是不利的。
真正最能锻炼能力的便是直接去阅读源码,不仅限于阅读各大系统源码,还包括各种优秀的开源库。
[外链图片转存中…(img-EC6XKCWR-1714985087780)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!