关于room的那些事

Room是一个数据持久化库，它是 Architecture Component的一部分。封装了sqlite。它让SQLiteDatabase的使用变得简单，大大减少了重复的代码，并且把SQL查询的检查放在了编译时。
先介绍下基本的使用吧

1. 添加依赖

dependencies{
 //roomData
    implementation "androidx.room:room-runtime:$rootProject.roomVersion"
    kapt "androidx.room:room-compiler:$rootProject.roomVersion"
    }

2.建表

我们需要为我们建造的实体数据加入@Entity注解
这里建造一个BlackInfo表,
用@Entity注解这个类并用tableName属性设置表的名称。
使用 @PrimaryKey 注解把一个成员设置为主键，这里我们的主键是BlackInfo的index，需要自增的话使用autoGenerate = true，默认为false
使用@ColumnInfo(name = “column_name”) 注解设置成员对应的列名。如果你觉得成员变量名就本身就可以作为列名，也可以不设置。
使用 @Ignore注解告诉Room哪个用，哪个不用。默认全部加入到表中字段

@Entity(tableName = "BlackInfo")
data class BlackInfo(
        @ColumnInfo(name = "indexs")
        @PrimaryKey(autoGenerate = true)
        var index: Int = 0,

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

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

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

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

        @ColumnInfo(name = "flag")
        var flag: Int = 0,

        @ColumnInfo(name = "isUpdate")
        var isUpdate: Int = 0,

        @ColumnInfo(name = "dateTime")
        var dateTime: Long = 0
)

3.操作数据表，建造DAO

我们想要操作我们的数据表就需要创建一个DAO ----- 一个实体表，我们都需要建造一个对应的DAO来进行数据操作
创建一个接口使用@Dao注解
@Query 使用自定义的sql 查询数据，我们也可以用来进行其他操作，比如如果想要不根据主键删除某条数据，我们也可以使用Query注解来操作，比如我想根据guid(非主键)来删除。可以这么写 @Query(“delete from BlackInfowhere guid =(:guid)”)
@Insert 插入数据 onConflict = OnConflictStrategy.REPLACE指定主键冲突时候的解决方式。直接替换。
@Update 更新数据
@Delete 删除数据

@Dao
interface BlackInfoDao {
 /**
     * 插入一项 黑名单
     */
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    fun insertBlackInfo(blackInfo: BlackInfo)
/**
     * 查找所有黑名单数据
     */
    @Query("select * from blackInfo")
    fun queryAllBlackInfo(): List<BlackInfo>
    
    @Query("select * from blackInfo where name = :name")
    fun queryBlackInfoByName(name: String): List<BlackInfo>
}

4.建造数据库

新建一个类，继承RoomDatabase，我们需要它来获取我们的DAO
注解@Database(entities = [BlackInfo::class],version = 1, exportSchema = false)

@Database(entities = [BlackInfo::class], version = Configure.dataBaseVersion, exportSchema = false)
abstract class AppDatabase : RoomDatabase() {

   //abstract fun getBlackInfoDao(): BlackInfoDao
    }

创建Database 我这样fallbackToDestructiveMigration()创建，每次数据库升级的时候，不会保留原有的用户数据 ，如果你想要保留原有的数据 就需要使用Migration

//不保留数据
val appDatase = Room.databaseBuilder(context, AppDatabase::class.java, "dbName") .fallbackToDestructiveMigration().build()

//保留原有数据
val appDatase = Room.databaseBuilder(context, AppDatabase::class.java, "dbName")  .addMigrations(MIGRATION_1_2).build()
 private val MIGRATION_1_2 = object : Migration(1, 2) {
        override fun migrate(database: SupportSQLiteDatabase) {
            // Since we didn't alter the table, there's nothing else to do here.
		/如果我们修改了表的属性(增加字段，删除字段。修改字段属性等)
		//我们就需要在这里进行数据迁移 
		//1.建造临时表  2.迁移原表到临时表  3.删除原表 4.重命名临时表
        	 database.execSQL("alter table BlackInfoadd iconUrl TEXT ")
        }
    }

在迁移表数据的时候，建造临时表字段属性需要与建造的实体BlackInfo字段属性一一对应。如果报错Migration didn't properly handle 一般字段属性不一致导致，检查下每个字段名称和属性，能否为空，字段类型等。room 里面字段类型sql语句，String都可以使用Text替代