编辑“︁Room”︁（章节）

= Room =

'''Room'''是Android Jetpack组件中的一个持久性库，它为SQLite数据库提供了一个抽象层，使开发者能够更高效地访问数据库，同时保持SQLite的强大功能。Room通过编译时验证SQL查询来减少错误，并支持[[LiveData]]和[[RxJava]]等响应式编程框架。

== 核心组件 ==

Room由三个主要组件组成：

* '''Database'''：包含数据库持有者，并作为应用持久化数据的主要访问点
* '''Entity'''：表示数据库中的表
* '''DAO''' (Data Access Object)：包含用于访问数据库的方法

=== 基本用法示例 ===

以下是一个简单的Room实现示例：

<syntaxhighlight lang="kotlin">
// 定义实体
@Entity
data class User(
    @PrimaryKey val uid: Int,
    @ColumnInfo(name = "first_name") val firstName: String?,
    @ColumnInfo(name = "last_name") val lastName: String?
)

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

    @Insert
    fun insertAll(vararg users: User)

    @Delete
    fun delete(user: User)
}

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

== 高级特性 ==

=== 数据库迁移 ===

当数据库模式需要更改时，Room提供了迁移机制：

<syntaxhighlight lang="kotlin">
val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        database.execSQL("ALTER TABLE user ADD COLUMN age INTEGER NOT NULL DEFAULT 0")
    }
}

Room.databaseBuilder(context, AppDatabase::class.java, "database-name")
    .addMigrations(MIGRATION_1_2)
    .build()
</syntaxhighlight>

=== 与LiveData集成 ===

Room可以轻松与[[LiveData]]集成，实现数据变化的自动通知：

<syntaxhighlight lang="kotlin">
@Dao
interface UserDao {
    @Query("SELECT * FROM user")
    fun getAllUsers(): LiveData<List<User>>
}
</syntaxhighlight>

== 性能优化 ==

* 使用事务进行批量操作
* 考虑在IO线程上执行数据库操作
* 使用索引优化查询性能
* 合理设置数据库连接池大小

== 实际应用案例 ==

在电商应用中，Room可用于管理以下数据：
* 用户个人信息
* 购物车商品
* 浏览历史
* 收藏商品

== 与其他Jetpack组件的整合 ==

Room可以与以下Jetpack组件无缝协作：
* [[ViewModel]] - 在ViewModel中访问数据库
* [[LiveData]] - 观察数据库变化
* [[WorkManager]] - 后台数据库操作
* [[Paging]] - 分页加载数据库数据

== 参见 ==
* [[SQLite]]
* [[Android Jetpack]]
* [[数据持久化]]

[[Category:Android开发]]
[[Category:数据库技术]]
[[Category:Jetpack组件]]