İç içe ilişkileri tanımlama ve sorgulama

Bazen, birbiriyle ilişkili üç veya daha fazla tablodan oluşan bir grubu sorgulamanız gerekebilir. Bu durumda, tablolar arasında iç içe ilişkiler tanımlarsınız.

Müzik akışı uygulaması örneğinde, tüm kullanıcıları, her kullanıcının tüm oynatma listelerini ve her kullanıcının her oynatma listesindeki tüm şarkıları sorgulamak istediğinizi varsayalım. Kullanıcılar ile oynatma listeleri arasında bire çok ilişki, oynatma listeleri ile şarkılar arasında ise çoka çok ilişki vardır. Aşağıdaki kod örneğinde, bu öğeleri temsil eden sınıfların yanı sıra oynatma listeleri ve şarkılar arasındaki çoktan çoğa ilişki için çapraz referans tablosu gösterilmektedir:

@Entity
data class User(
    @PrimaryKey val userId: Long,
    val name: String,
    val age: Int
)

@Entity
data class Playlist(
    @PrimaryKey val playlistId: Long,
    val userCreatorId: Long,
    val playlistName: String
)

@Entity
data class Song(
    @PrimaryKey val songId: Long,
    val songName: String,
    val artist: String
)

@Entity(primaryKeys = ["playlistId", "songId"], indices = [Index("playlistId", "songId")])
data class PlaylistSongCrossRef(
    val playlistId: Long,
    val songId: Long
)
NestedRelationshipsSnippets.kt

Öncelikle, veri sınıfı ve @Relation ek açıklamasını kullanarak kümenizdeki iki tablo arasındaki ilişkiyi normalde yaptığınız gibi modelleyin. Aşağıdaki örnekte, Playlist öğe sınıfı ile Song öğe sınıfı arasındaki çoktan çoğa ilişkiyi modelleyen bir PlaylistWithSongs sınıfı gösterilmektedir:

data class PlaylistWithSongs(
    @Embedded val playlist: Playlist,
    @Relation(
        parentColumns = ["playlistId"],
        entityColumns = ["songId"],
        associateBy = Junction(PlaylistSongCrossRef::class)
    )
    val songs: List<Song>
)
NestedRelationshipsSnippets.kt

Bu ilişkiyi temsil eden bir veri sınıfı tanımladıktan sonra, kümenizdeki başka bir tablo ile ilk ilişki sınıfı arasındaki ilişkiyi modelleyen başka bir veri sınıfı oluşturun ve mevcut ilişkiyi yeni ilişkinin içine "yerleştirin". Aşağıdaki örnekte, UserWithPlaylistsAndSongs sınıfının User öğe sınıfı ile PlaylistWithSongs ilişki sınıfı arasında bire çok ilişkiyi nasıl modellediği gösterilmektedir:

data class UserWithPlaylistsAndSongs(
    @Embedded val user: User,
    @Relation(
        entity = Playlist::class,
        parentColumns = ["userId"],
        entityColumns = ["userCreatorId"]
    )
    val playlists: List<PlaylistWithSongs>
)
NestedRelationshipsSnippets.kt

UserWithPlaylistsAndSongs sınıfı, User, Playlist ve Song olmak üzere üç öğe sınıfı arasındaki ilişkileri dolaylı olarak modeller. Bu durum Şekil 1'de gösterilmektedir.

Kümenizde daha fazla tablo varsa her bir kalan tablo ile önceki ilişki sınıfı arasındaki ilişkiyi modellemek için bir sınıf oluşturun. Bu işlem, sorgulamak istediğiniz tüm tablolar arasında iç içe yerleştirilmiş ilişkilerden oluşan bir zincir oluşturur.

Son olarak, uygulamanızın ihtiyaç duyduğu sorgu işlevini kullanıma sunmak için veri erişim nesnesi (DAO) sınıfına bir işlev ekleyin. Bu işlevin birden fazla sorgu çalıştırması için Room'un kullanılması gerekir. Bu nedenle, tüm işlemin atomik olarak çalışması için @Transaction ek açıklamasını ekleyin:

@Transaction
@Query("SELECT * FROM User")
suspend fun getUsersWithPlaylistsAndSongs(): List<UserWithPlaylistsAndSongs>
NestedRelationshipsSnippets.kt