Android Room：含ArrayList的Entity表创建及多对多关系处理

嘿，这个问题我之前在项目里刚好碰到过，给你详细梳理下解决方案！

Room本身不支持直接在Entity类里存储ArrayList这类集合类型，@Embedded注解确实只能处理单个嵌套对象，没法直接映射列表。所以你必须单独创建UsageRule对应的Entity表，把每个规则作为一条记录存储，再通过关联关系和主表关联起来。

这里要提一句：如果你图省事想把List转成JSON字符串存在单个字段里，虽然可以用TypeConverter实现，但这种方式非常不推荐——你没法对规则里的单个字段做查询、筛选，也没法高效处理后续的多对多关系，完全违背了关系型数据库的设计初衷。

既然每个使用规则可以关联多个产品，每个产品也能关联多个规则，这是典型的多对多关系，Room里需要通过**交叉表（关联表）**来实现，具体步骤如下：

1. 创建两个基础Entity表 #

首先分别定义Product和UsageRule的Entity：

@Entity(tableName = "products")
data class Product(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val productName: String,
    // 其他产品属性，比如价格、描述等
)

@Entity(tableName = "usage_rules")
data class UsageRule(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val ruleTitle: String,
    val ruleContent: String,
    // 其他规则属性
)

2. 创建交叉表（关联表） #

这个表不需要自己的主键，而是用两个实体的ID作为联合主键，用来记录产品和规则的关联关系：

@Entity(primaryKeys = ["productId", "usageRuleId"])
data class ProductUsageRuleCrossRef(
    val productId: Long, // 关联Product的id
    val usageRuleId: Long // 关联UsageRule的id
)

3. 定义带关联关系的数据类 #

为了方便查询时一次性获取关联数据，我们需要创建包含嵌套关系的数据类，用@Relation注解指定关联逻辑：

// 获取某个产品及其所有关联的使用规则
data class ProductWithUsageRules(
    @Embedded val product: Product,
    @Relation(
        parentColumn = "id", // Product表的主键
        entityColumn = "id", // UsageRule表的主键
        associateBy = Junction(ProductUsageRuleCrossRef::class) // 指定交叉表
    )
    val usageRules: List<UsageRule>
)

// 获取某个使用规则及其所有关联的产品
data class UsageRuleWithProducts(
    @Embedded val usageRule: UsageRule,
    @Relation(
        parentColumn = "id",
        entityColumn = "id",
        associateBy = Junction(ProductUsageRuleCrossRef::class)
    )
    val products: List<Product>
)

4. 在Dao中实现关联操作和查询 #

最后在Dao里定义插入、查询的方法，注意用@Transaction保证关联查询的原子性：

@Dao
interface ProductRuleDao {
    // 插入单个产品
    @Insert
    suspend fun insertProduct(product: Product): Long

    // 插入单个使用规则
    @Insert
    suspend fun insertUsageRule(usageRule: UsageRule): Long

    // 插入关联关系
    @Insert
    suspend fun insertCrossRef(crossRef: ProductUsageRuleCrossRef)

    // 查询单个产品及其所有关联规则
    @Transaction
    @Query("SELECT * FROM products WHERE id = :productId")
    suspend fun getProductWithRules(productId: Long): ProductWithUsageRules?

    // 查询单个规则及其所有关联产品
    @Transaction
    @Query("SELECT * FROM usage_rules WHERE id = :ruleId")
    suspend fun getRuleWithProducts(ruleId: Long): UsageRuleWithProducts?
}

使用示例 #

比如你要给某个产品关联一条规则，流程是这样的：

// 1. 插入产品，获取产品ID
val productId = dao.insertProduct(Product(productName = "Test Product"))
// 2. 插入规则，获取规则ID
val ruleId = dao.insertUsageRule(UsageRule(ruleTitle = "Test Rule", ruleContent = "Content..."))
// 3. 插入关联关系
dao.insertCrossRef(ProductUsageRuleCrossRef(productId, ruleId))

// 查询产品及其所有规则
val productWithRules = dao.getProductWithRules(productId)

这样就能完美处理你的需求啦，既符合Room的设计规范，也能高效地管理多对多关系。

内容的提问来源于stack exchange，提问作者Jono