Android Academy · 课时

查询和关系

Q: 「查询和关系」这节课中我会学到什么？

查询数据并关联实体 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

查询数据并关联实体

查询和关系 是 CoddyKit 上的免费 Android Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。

超越单表

实际应用包含相关数据：一个用户有许多帖子，一个订单有许多商品。Room 使用外键和 @Relation 注解对这些关系进行建模。

参数化查询

使用冒号前缀将参数传入 @Query。

@Query("SELECT * FROM users WHERE name LIKE :search")
suspend fun search(search: String): List<User>

返回聚合值

查询可以返回计数等标量值。

@Query("SELECT COUNT(*) FROM users")
suspend fun count(): Int

定义外键

子实体使用 @ForeignKey 引用其父实体。这会在数据库层面强制执行引用完整性。

@Entity(
    foreignKeys = [ForeignKey(
        entity = User::class,
        parentColumns = ["id"],
        childColumns = ["userId"]
    )]
)
data class Post(
    @PrimaryKey val id: Int,
    val userId: Int,
    val title: String
)

为外键建立索引

Room 建议为外键列建立索引，以提升查询性能。请添加 @Index。

@Entity(
    indices = [Index("userId")]
)
data class Post(/* ... */ val userId: Int)

onDelete 行为

请决定删除父实体时子实体会发生什么，例如使用 CASCADE 将子实体一并删除。

ForeignKey(
    entity = User::class,
    parentColumns = ["id"],
    childColumns = ["userId"],
    onDelete = ForeignKey.CASCADE
)

对一对多关系建模

使用 @Embedded 和 @Relation 创建一个将父实体与其子实体组合起来的类。

data class UserWithPosts(
    @Embedded val user: User,
    @Relation(
        parentColumn = "id",
        entityColumn = "userId"
    )
    val posts: List<Post>
)

查询关系

从 DAO 返回组合类。Room 会运行额外的查询，并将这些对象组合起来。

@Transaction
@Query("SELECT * FROM users")
suspend fun getUsersWithPosts(): List<UserWithPosts>

为什么这里要使用 @Transaction

因为 Room 会执行两个查询（先查询父项，再查询子项），将该方法封装在 @Transaction 中可以确保读取的是一致的快照，并且不会有交错写入。

使用联结表实现多对多关系

对于多对多关系（学生和课程），请使用联结表以及 @Relation 的 associateBy 参数。

@Relation(
    parentColumn = "studentId",
    entityColumn = "courseId",
    associateBy = Junction(Enrollment::class)
)
val courses: List<Course>

关系总结

@ForeignKey 强制执行完整性和级联规则。
@Relation + @Embedded 用于组装相关对象。
@Transaction 可确保多查询读取的一致性。

快速检查

测试您对关系的理解。

回顾

您学会了：

使用 :name 参数化查询，并返回聚合结果。
@ForeignKey 通过 onDelete 规则确保完整性。
@Relation + @Embedded 用于构建相关对象；请将读取操作封装在 @Transaction 中。

常见问题解答

「查询和关系」课时是免费的吗？

是的 — 「查询和关系」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。

「查询和关系」这节课中我会学到什么？

查询数据并关联实体你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Android Academy 需要有经验吗？

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

「查询和关系」课时需要多长时间？

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

我能在这节 Android Academy 课中编写并运行代码吗？

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

此课程中的所有课时

← 返回 Android Academy