Room 的基本使用

Room 是一个 Jetpack 组件，它是 Google 推出的用于本地数据库操作的 ORM 框架，可以帮助开发者更轻松地在应用程序中操作 SQLite 数据库。Room 提供了一些强大的功能，如编译时检查、类型安全、可观察的查询等，使得数据库操作更加安全、高效和方便。

使用 Room 的主要优势包括：

编译时检查：Room 在编译时会检查 SQL 语句的语法和正确性，避免了在运行时发生 SQL 错误的问题。
类型安全：Room 使用注解来定义数据库表和查询语句，可以将 SQL 查询映射到类型安全的 Kotlin 对象上，避免了手动解析和转换数据的问题。
可观察的查询：Room 支持使用 LiveData 或 Flow 来观察查询结果的变化，可以自动更新 UI。

使用 Room 可以分为以下几个步骤：

添加 Room 依赖：在 build.gradle 文件中添加 Room 依赖。
创建实体类：使用注解 @Entity 来定义数据库表和字段，可以使用 @PrimaryKey 和其他注解来定义主键和索引等。
创建 DAO 接口：使用注解 @Dao 来定义数据库访问对象接口，使用方法注解来定义 SQL 查询语句和参数，可以使用 suspend 修饰符来支持协程异步调用。
创建数据库：使用注解 @Database 来定义数据库类，指定数据库名称和版本号，定义数据库表和 DAO 接口等。
使用 Room：在应用程序中使用 Room 对象来访问数据库，可以使用异步查询方法和可观察查询方法来获取数据。

以下是一个简单的 Room 示例代码，展示如何使用 Room 来创建和操作数据库：

kotlinCopy code
// 定义实体类
@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String,
    val age: Int
)

// 定义 DAO 接口
@Dao
interface UserDao {
    @Query("SELECT * FROM users")
    fun getAll(): List<User>

    @Insert
    suspend fun insert(user: User)
}

// 定义数据库类
@Database(entities = [User::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}

// 使用 Room
val db = Room.databaseBuilder(
    applicationContext,
    AppDatabase::class.java, "my-db"
).build()

GlobalScope.launch {
    // 异步插入用户
    db.userDao().insert(User(1, "Alice", 23))
    // 异步查询用户
    val users = db.userDao().getAll()
    // 更新 UI
    withContext(Dispatchers.Main) {
        updateUi(users)
    }
}

在这个示例中，我们定义了一个名为 User 的实体类，并使用注解 @Entity 来定义了一个名为 users 的数据库表。然后我们定义了一个名为 UserDao 的 DAO 接口，使用注解 @Dao 来定义，包含了一个查询所有用户的方法和一个插入用户的方法。最后我们定义了一个名为 AppDatabase 的抽象类，并使用注解 @Database 来定义了一个名为 my-db 的数据库，其中包含了一个 User 表和一个 UserDao 接口。在最后的代码中，我们使用 Room 对象来获取 AppDatabase 实例，并异步插入和查询用户数据，并使用 withContext() 函数将 UI 更新操作切换到主线程。