写这篇博客的一部分原因来自一位安卓大佬的嘲讽：
这个能忍？不能！
1、这篇文章将介绍Room的基本用法
2、room的组成和简单介绍
一般情况下，如果要使用room，一般要了解room的几个组成部分：
2.1、RoomDatabase
数据库的主要核心类
在代码中用注解@Database表示。
2.2、Entity
数据库的表
在代码中用注解@Entity表明该类为数据库表，比如以下这段代码：。
@Entity
data class User(
var id: Int,
var name: String,
var gender: Int
)
表名为：User，里面的字段id、name等等都是这个User表的字段。还有其他的一些注解标明那个字段的一些属性，比如标明id为主键@PrimaryKey var id: Int,。
2.3、Dao
操作数据表的类
可以简单的理解为：这个里面写了对表的增删改查的方法。通过注解标明方法的作用，比如：
@Dao
interface UserDao {
@Query("SELECT * FROM user")
fun getUsers(): Single<MutableList<User>>
@Query("SELECT * FROM user where id=:id")
fun getUserById(id: Int): User
@Insert
fun insertUser(user: User):Long
@Update
fun updateUser(user: User):Int
@Delete
fun deleteUser(user:User):Int
}
@Query：为查询表中的数据的意思
@Update：修改的表中的数据的意思
@Insert：插入新的表数据
@Delete： 删除表的数据
3、使用room数据库
3.1、添加依赖
在app的build.gradle中添加以下依赖
implementation "androidx.room:room-runtime:2.2.3"
implementation "androidx.room:room-ktx:2.2.3"
implementation "androidx.room:room-rxjava2:2.2.3"
kapt 'androidx.room:room-compiler:2.2.5'
3.2、添加RoomDatabase
@Database(entities = [User::class],version = 1)
abstract class AppDataBase : RoomDatabase() {
companion object{
private var instance:AppDataBase? = null
fun getInstance(context: Context):AppDataBase{
if(instance == null){
synchronized(AppDataBase::class){
instance = Room.databaseBuilder(context,AppDataBase::class.java,"app_db")
.allowMainThreadQueries()
.build()
}
}
return instance!!
}
}
}
3.3、添加Entity
@Entity
data class User(
@PrimaryKey
var id: Int,
var name: String,
var gender: Int
)
3.4、添加Dao
@Dao
interface UserDao {
@Query("SELECT * FROM user")
fun getUsers(): Single<MutableList<User>>
@Query("SELECT * FROM user where id=:id")
fun getUserById(id: Int): User
@Insert
fun insertUser(user: User):Long
@Update
fun updateUser(user: User):Int
@Delete
fun deleteUser(user:User):Int
}
4、简单的实战
任何东西都是从简到难的，做一个非常简单的“用户管理系统”实现最简单的用户增删改查的方法。这边涉及到常用的增删改查的基本操作。
代码在文章最后！
5、数据库升级
数据库升级在每一个版本上新的时候会经常遇到，一般是表字段进行了修改。一般新增一些字段的情况比较多。以下四步是完成数据库升级的基本步骤。
5.1、添加Entity字段
原Entity
@PrimaryKey
var id: Int,
var name: String,
var gender: Int
)
添加一个String类型的字段：
@Entity
data class User(
@PrimaryKey(autoGenerate = true)
var id: Int,
var name: String?,
var gender: Int,
var hobby:String?
)
5.2、修改AppDataBase的版本号
原来的版本号：
@Database(entities = [User::class], version = 1)
修改后的版本号：
@Database(entities = [User::class], version = 2)
注意：version的版本号要和下面提到的MIGRATION要对应上！
5.3、添加MIGRATION
添加一个MIGRATION，并且添加上修改数据库表字段的sql代码：
private val MIGRATION_1_2 = object : Migration(1, 2) {
override fun migrate(database: SupportSQLiteDatabase) {
database.execSQL("ALTER TABLE User ADD COLUMN hobby TEXT")
}
}
注意： Migration(1, 2)代表数据库版本从1升级到2，和前一步修改数据库版本对应。
5.4、将添加的MIGRATION添加到数据构造中去
fun getInstance(context: Context): AppDataBase {
if (instance == null) {
synchronized(AppDataBase::class.java) {
instance = Room.databaseBuilder(
context.applicationContext,
AppDataBase::class.java,
"app_db"
)
// MIGRATION添加到这里
.addMigrations(MIGRATION_1_2)
.allowMainThreadQueries()
.build()
}
}
return instance!!
}
// MIGRATION
private val MIGRATION_1_2 = object : Migration(2, 3) {
override fun migrate(database: SupportSQLiteDatabase) {
database.execSQL("ALTER TABLE User ADD COLUMN hobby TEXT")
}
}
如果有多个MIGRATION则往后添加：
.addMigrations(MIGRATION_1_2, MIGRATION_3_4, MIGRATION_4_5, MIGRATION_5_6, MIGRATION_6_7)
以上四步就是最基本的升级数据库的操作了，数据库升级操作还有很多种情况，这里推荐这些链接看看。
https://www.jianshu.com/p/a729f6ee37db?tdsourcetag=s_pcqq_aiomsg
https://www.jianshu.com/p/fae0245cf384
https://www.jianshu.com/p/633ffc49da92
以上就是room数据库的基本使用了，当了解一些基本的流程之后，实际上使用起来还是比较简单的。
6、遇到的一些问题
这边是我使用room遇到的一些问题了。
-
编译通不过
编译错误
从网上查过是少了一个依赖：
kapt 'android.arch.persistence.room:compiler:1.1.1'
检查下所有的依赖是不是都在：
implementation "androidx.room:room-runtime:2.2.3"
implementation "androidx.room:room-ktx:2.2.3"
implementation "androidx.room:room-rxjava2:2.2.3"
kapt 'android.arch.persistence.room:compiler:1.1.1'
- 升级数据库时Kotlin和java的int是否可以为空的问题
如果第一次使用room。说不定会遇到。
如果使用kotlin的？：
Int?
那么升级数据时要加上DEFAULT 0
database.execSQL("ALTER TABLE User ADD COLUMN gender INTEGER DEFAULT 0");
如果Koltin不用？那就不需要加DEFAULT 0。
如果用的是java，那么所有的加上DEFAULT 0就不会出问题。
7、示例源码
https://github.com/AxeChen/RoomDemo
小星星刷起来
master是升级前的代码，master-update是升级后的代码。代码是Kotlin版本。
本博客为简书个人原创，转载请注明出处。
