Jetpack Compose Academy · 课时

实体、DAO 与数据库

使用 Room 定义本地数据结构。

第 1 / 4 课13 个步骤

实体、DAO 与数据库 是 CoddyKit 上的免费 Jetpack Compose Academy 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Jetpack Compose Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Jetpack Compose Academy 课程共包含 4 节课。

Room 就是本地 SQLite

Room 是构建在 SQLite 之上的友好层。它让您可以使用普通的 Kotlin 类在设备上保存数据,而不必直接处理原始 SQL 字符串。💾

三个核心部分

Room 恰好包含三个构建块:用于表示表的 Entity、用于存放查询的 DAO,以及将它们连接起来的 Database。

Entity 就是一张表

使用 @Entity 注解标记数据类后,Room 会将其转换为数据库表,每个属性对应一列。

@Entity
data class Note(val text: String)

每一行都需要键

将一个字段标记为 @PrimaryKey,这样每一行都能被唯一识别。使用 autoGenerate 可让 Room 自动为您分配 ID。

@PrimaryKey(autoGenerate = true)
val id: Int = 0

DAO 保存查询

@Dao 接口声明您需要的操作。您只需写出意图,Room 会生成具体实现。

@Dao
interface NoteDao {
    // queries go here
}

使用一个注解插入数据

添加一个函数,并使用 @Insert 标记它。Room 会编写用于将实体保存到表中的 SQL。

@Insert
suspend fun insert(note: Note)

使用 @Query 读取数据

使用 @Query 配合真实 SQL 获取数据行。Room 会在编译时根据您的架构检查查询。

@Query("SELECT * FROM Note")
suspend fun getAll(): List<Note>

更新和删除也一样

写入操作也遵循相同模式:@Update 和 @Delete 会根据主键匹配并修改现有数据行。

@Delete
suspend fun delete(note: Note)

Database 类

使用 @Database 声明一个抽象类,列出您的实体,并提供每个 DAO。这是统一的入口。

@Database(entities = [Note::class], version = 1)
abstract class AppDb : RoomDatabase() {
    abstract fun noteDao(): NoteDao
}

只构建一次数据库

使用 Room.databaseBuilder 创建实例。构建数据库的开销较大,因此只应执行一次并重复使用。

Room.databaseBuilder(context, AppDb::class.java, "app.db").build()

Suspend 让界面保持流畅

磁盘访问速度较慢,因此请将 DAO 函数标记为 suspend。这样 Room 会在主线程之外运行它们,不会冻结屏幕。

快速检查

哪个注解可以将 Kotlin 类标记为 Room 数据库表?

回顾:三大支柱

您定义了一个 Entity 表、一组挂起查询组成的 DAO,以及负责连接它们的 Database。接下来,您将让这些读取操作具备响应式能力。

免费开始

用 AI 导师学习 Kotlin — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
30
课程
120

常见问题解答

「实体、DAO 与数据库」课时是免费的吗?

是的 — 「实体、DAO 与数据库」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Jetpack Compose Academy 课程的其余内容,请升级到 CoddyKit PRO。 Jetpack Compose Academy 课程共包含 4 节课。

「实体、DAO 与数据库」这节课中我会学到什么?

使用 Room 定义本地数据结构。 你通过在浏览器中直接运行的动手代码来练习 Jetpack Compose Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Jetpack Compose Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Jetpack Compose Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。

「实体、DAO 与数据库」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Jetpack Compose Academy 课中编写并运行代码吗?

能。每节 Jetpack Compose Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 实体、DAO 与数据库
  2. 返回 Flow 的响应式查询
  3. 仓库模式
  4. 离线优先的缓存策略
← 返回 Jetpack Compose Academy