在 Room中，你可以通過兩種方式定義和查詢實(shí)體之間的關(guān)系：1、使用具有嵌入式對象的中間數(shù)據(jù)類；2、具有多重映射返回值類型的關(guān)系型查詢。

中間數(shù)據(jù)類

@Dao
interface ContactDao {
    @Query(
        "SELECT * FROM users, phones WHERE users.id = phones.parent_id"
    )
    fun getAll(): LiveData<List<ContactEntity>?>
}

多重映射返回值類型

@Dao
interface UserDao {
    @Query(
        "SELECT * FROM users JOIN phones ON users.id = phones.parent_id"
    )
    fun get(): Map<UserEntity, List<PhoneEntity>?>
}

中間數(shù)據(jù)類方法可讓你避免編寫復(fù)雜的 SQL 查詢，但由于需要額外的數(shù)據(jù)類，它還可能會導(dǎo)致代碼復(fù)雜性增加。簡而言之，多重映射返回值類型方法需要 SQL 查詢完成更多工作；而中間數(shù)據(jù)類方法需要代碼完成更多工作。如果沒有使用中間數(shù)據(jù)類的特定理由，Google建議使用多重映射返回值類型方法。

這里我們僅選擇中間數(shù)據(jù)類方法進(jìn)行介紹，因為中間數(shù)據(jù)類有些細(xì)節(jié)方面需要注意，另外也不需要寫太多SQL語句：

@Entity(tableName = "users")
data class UserEntity(
    @PrimaryKey(autoGenerate = true)
    var id: Long = 0,
    @ColumnInfo(name = "name_pinyin")
    var namePinyin: String? = null,//姓名的拼音，根據(jù)姓名自動生成
    @ColumnInfo(name = "nick_name")
    var nickName: String? = null,//昵稱，選填
) {
    var name: String? = null//姓名，必填
        set(value) {
            val name = value?.trim()
            field = name
            namePinyin = Pinyin.toPinyin(field, "")
        }

    fun getFirstLetter(): String {
        val firstStr = namePinyin?.first()
        return if (ValidatorUtil.isLetter(firstStr.toString())) {//英文
            firstStr.toString().uppercase()
        } else {
            "#"
        }
    }
}

@Entity(tableName = "phones")
data class PhoneEntity(
    @PrimaryKey(autoGenerate = true)
    var id: Long,
    @ColumnInfo(name = "parent_id")//父實(shí)體的id
    var parentId: Long,
    var phone: String,//電話號碼
)

我們知道一個人可以對應(yīng)多個電話，可能是公司、住宅、私人、工作等等，為了查詢用戶和對應(yīng)的電話號碼列表，你必須先在兩個實(shí)體之間建立一對多關(guān)系。為此，創(chuàng)建一個新的數(shù)據(jù)類，其中每個實(shí)例都包含父實(shí)體的一個實(shí)例和與之對應(yīng)的所有子實(shí)體實(shí)例的列表。將 @Relation 注釋添加到子實(shí)體的實(shí)例，同時將 parentColumn 設(shè)置為父實(shí)體主鍵列的名稱，并將 entityColumn 設(shè)置為引用父實(shí)體主鍵的子實(shí)體列的名稱。

data class ContactEntity (
    @Embedded
    val user: UserEntity,
    @Relation(parentColumn = "id", entityColumn = "parent_id")
    var phones: List<PhoneEntity>? = null,//電話號碼
)

然后，新建一個ContactDao，向 DAO 類添加方法，用于返回將父實(shí)體與子實(shí)體配對的數(shù)據(jù)類的所有實(shí)例。該方法需要 Room 運(yùn)行兩次查詢，因此應(yīng)向該方法添加 @Transaction 注釋，以確保整個操作以原子方式執(zhí)行。

@Dao
interface ContactDao {
    @Transaction
    @Query("SELECT * FROM users")
    fun getAll(): LiveData<List<ContactEntity>?>

    //模糊查詢
    @Transaction
    @Query("SELECT * FROM users WHERE name OR name_pinyin LIKE '%' || :searchStr || '%'")
    fun getAllBySearch(searchStr: String): LiveData<List<ContactEntity>?>

    fun insert(db: AppDatabase, contact: ContactEntity) {
        val id = db.contactDataDao().insert(contact.user)
        contact.phones?.forEach {
            it.parentId = id
            db.phoneDao().insert(it)
        }
    }

    fun delete(db: AppDatabase, contact: ContactEntity) {
        db.contactDataDao().delete(contact.user)
        contact.phones?.forEach {
            db.phoneDao().delete(it)
        }
    }
}

最后，我們在 AppDatabase 里面注冊它

@Database(
    entities = [
        //這里，這里，這里千萬不要把 ContactEntity 加上
        UserEntity::class,
        PhoneEntity::class,
    ],
    version = 1, exportSchema = false
)
abstract class AppDatabase: RoomDatabase() {

    abstract fun contactDao(): ContactDao
    abstract fun userDao(): UserDao
    abstract fun phoneDao(): PhoneDao

    companion object {
        private const val DATABASE_NAME = "Contacts.db"
        @Volatile
        private var INSTANCE: AppDatabase? = null

        fun getInstance(context: Context): AppDatabase = INSTANCE ?: synchronized(this) {
            INSTANCE ?: buildDatabase(context).also {
                INSTANCE = it
            }
        }

        private fun buildDatabase(context: Context) =
            Room.databaseBuilder(context.applicationContext, AppDatabase::class.java, DATABASE_NAME).build()
    }
}

這里需要注意的是 ContactEntity 不需要在 AppDatabase 上注冊

以上，我們就把Room的一對多關(guān)系建好了。