将数据拆分为相关联的表，并以有意义的方式将数据组合在一起 是设计关系型数据库的重要部分。从 Room 2.2 (现已稳定)开始，通过 @Relation 注解，我们支持了表之间所有可能的关系：一对一，一对多，多对多 。
一对一
假如我们生活在一个(悲伤的)世界，每个人只能拥有一条狗，并且每条狗也只能有一个主人。这就是一对一关系。为了在关系型数据库中 表示这一关系，我们创建了两张表，Dog 和 Owner 。Dog 表持有 owner id 的引用，Owner 表持有 dog id 的引用。在 Room 中，我们创建这样两个实体类：
@Entity data class Dog( @PrimaryKey val dogId: Long, val dogOwnerId: Long, val name: String, val cuteness: Int, val barkVolume: Int, val breed: String ) @Entity data class Owner(@PrimaryKey val ownerId: Long, val name: String) 复制代码
我们要在页面上显示所有的狗狗和它们的主人，为此，我们创建了一个数据类 DogAndOwner ：
data class DogAndOwner( val owner: Owner, val dog: Dog ) 复制代码
要通过 Sqlite 完成此次查询，我们需要：
- 进行两次查询，先查询出所有的主人，然后在根据主人的 owner id 查询出所有的狗
- 处理对象映射
SELECT * FROM Owner SELECT * FROM Dog WHERE dogOwnerId IN (ownerId1, ownerId2, …) 复制代码
通过 Room 来得到 List<DogAndOwner> ，我们不需要自己实现两次查询和对象映射，仅仅通过 @Relation 注解即可。
在上面的例子中，由于 Dog 拥有主人的信息，所有在 dog 变量上添加 @Relation 注解：指定 owner 表中的 ownerId 和 dog 表中的 dogOwnerId 是相对应的。
data class DogAndOwner( @Embedded val owner: Owner, @Relation( parentColumn = "ownerId", entityColumn = "dogOwnerId" ) val dog: Dog ) 复制代码
Dao 可以简化如下：
@Transaction @Query("SELECT * FROM Owner") fun getDogsAndOwners(): List<DogAndOwner> 复制代码
注意：由于 Room 会在后台自动为我们执行这两次查询，所以要添加 @Transaction 注解以保证原子性。
一对多
假设一个主人可以拥有多条狗狗 (Yeah !) ，Owner 和 Dog 之间是一对多的关系。之前定义的数据库结构不需要发生任何变化，我们仍然使用之前的表，因为相关联的键已经在表中了。
现在，为了展示主人和他的狗狗们，我们需要创建一个新的数据类：
data class OwnerWithDogs( val owner: Owner, val dogs: List<Dog> ) 复制代码
为了避免两次查询，我们给 List<Dog> 添加 @Relation 注解来定义 Dog 和 Owner 之间的一对多关系。
data class OwnerWithDogs( @Embedded val owner: Owner, @Relation( parentColumn = "ownerId", entityColumn = "dogOwnerId" ) val dogs: List<Dog> ) 复制代码
Dao 是这样的。
@Transaction @Query("SELECT * FROM Owner") fun getDogsAndOwners(): List<OwnerWithDogs> 复制代码
多对多
现在假设我们生活在一个完美的世界，每个主人可以拥有多条狗，每条狗也可以有多个主人。要对此关系进行建模，仅仅通过 Dog 表和 Owner 表是不够的。由于一条狗可能有多个主人，所以同一个 dogId 可能需要多条数据，以匹配不同的主人。但是在 Dog 表中，dogId 是主键，我们不能插入多个 id 相同，主人不同的狗狗。为了解决这一问题，我们需要额外创建一个存储 (dogId,ownerId) 的 关联表 (也称为交叉引用表) 。
@Entity(primaryKeys = ["dogId", "ownerId"]) data class DogOwnerCrossRef( val dogId: Long, val ownerId: Long ) 复制代码
假设现在仅仅只通过 Sqlite 来所有的主人和他们的狗：List<OwnerWithDogs> ，我们需要两次查询：获取所有的主人，联表查询 Dog 表和 DogOwnerCrossRef 表。
SELECT * FROM Owner SELECT Dog.dogId AS dogId, Dog.dogOwnerId AS dogOwnerId, Dog.name AS name, _junction.ownerId FROM DogOwnerCrossRef AS _junction INNER JOIN Dog ON (_junction.dogId = Dog.dogId) 复制代码
用 Room 实现的话，我们需要更新 OwnerWithDogs 实例类，告诉 Room 要为了获取对应的所有狗狗，要关联表 DogOwnerCrossRef 。通过 Junction 来引用表。
在 Dao 中，通过查询 Owner 来返回正确的数据类。
@Transactionhttps://youtu.be/_aJsh6P00c0 @Query("SELECT * FROM Owner") fun getOwnersWithDogs(): List<OwnerWithDogs> 复制代码
高级用法示例
当使用 @Relation 注解时，Room 根据被注解的属性类型来推断使用哪个实体类。例如，到目前为止，我们给 Dog 或 List<Dog> 添加了注解，这就告诉了 Room 要使用哪个类，要查询哪些字段。
如果我们想返回一个其他对象，例如 Pup，它不是一个实体但是包含了一些字段。我们可以通过 @Relation 注解指定要使用的实体。
data class Pup( val name: String, val cuteness: Int = 11 ) data class OwnerWithPups( @Embedded val owner: Owner, @Relation( parentColumn = "ownerId", entity = Dog::class, entityColumn = "dogOwnerId" ) val dogs: List<Pup> ) 复制代码
如果我们指向返回实体类的指定字段，就需要通过 @Relation 注解的 projection 属性来指定。例如，我们指向获取 OwnerWithDogs 中所有狗狗的名字，因此我们需要返回的是 List<String> 。而 Room 无法推断这些字符串代表的是名字还是品种，所有需要我们通过 projection 指定。
data class OwnerWithDogs( @Embedded val owner: Owner, @Relation( parentColumn = "ownerId", entity = Dog::class, entityColumn = "dogOwnerId", projection = ["name"] ) val dogNames: List<String> ) 复制代码
如果你想在 dogOwnerId 和 ownerId 之间定义更加严格的关系，独立于你所创建的任何关系，可以在这些字段之间添加 ForeignKey 约束。请记住，SQLite 外键定义索引，并且可以具有级联触发器来更新或删除表中的条目。因此，请根据是否希望在数据库中使用这种功能来决定是否要使用外键。
无论你需要一对一，一对多，还是多对多的支持，Room 都可以通过 @Relation 注释满足你。
