İç 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 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:

Kotlin

@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"])
data class PlaylistSongCrossRef(
    val playlistId: Long,
    val songId: Long
)

Java

@Entity
public class User {
    @PrimaryKey public long userId;
    public String name;
    public int age;
}

@Entity
public class Playlist {
    @PrimaryKey public long playlistId;
    public long userCreatorId;
    public String playlistName;
}
@Entity
public class Song {
    @PrimaryKey public long songId;
    public String songName;
    public String artist;
}

@Entity(primaryKeys = {"playlistId", "songId"})
public class PlaylistSongCrossRef {
    public long playlistId;
    public long songId;
}

Ö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:

Kotlin

data class PlaylistWithSongs(
    @Embedded val playlist: Playlist,
    @Relation(
         parentColumn = "playlistId",
         entityColumn = "songId",
         associateBy = Junction(PlaylistSongCrossRef::class)
    )
    val songs: List<Song>
)

Java

public class PlaylistWithSongs {
    @Embedded public Playlist playlist;
    @Relation(
         parentColumn = "playlistId",
         entityColumn = "songId",
         associateBy = Junction(PlaylistSongCrossRef.class)
    )
    public List<Song> songs;
}

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:

Kotlin

data class UserWithPlaylistsAndSongs(
    @Embedded val user: User
    @Relation(
        entity = Playlist::class,
        parentColumn = "userId",
        entityColumn = "userCreatorId"
    )
    val playlists: List<PlaylistWithSongs>
)

Java

public class UserWithPlaylistsAndSongs {
    @Embedded public User user;
    @Relation(
        entity = Playlist.class,
        parentColumn = "userId",
        entityColumn = "userCreatorId"
    )
    public List<PlaylistWithSongs> playlists;
}

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

UserWithPlaylistsAndSongs, User ile PlaylistWithSongs arasındaki ilişkiyi modeller. PlaylistWithSongs ise Playlist ile Song arasındaki ilişkiyi modeller.
Şekil 1. Müzik akışı uygulaması örneğindeki ilişki sınıflarının şeması.

Kümenizde başka tablolar varsa her bir kalan tablo ile önceki tüm tablolar arasındaki ilişkileri modelleyen 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ş bir ilişki zinciri oluşturur.

Son olarak, uygulamanızın ihtiyaç duyduğu sorgu işlevini kullanıma sunmak için DAO sınıfına bir yöntem ekleyin. Bu yöntemin birden fazla sorgu çalıştırması için Room'un kullanılması gerekir. Bu nedenle, tüm işlemin atomik olarak gerçekleştirilmesi için @Transaction ek açıklamasını ekleyin:

Kotlin

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

Java

@Transaction
@Query("SELECT * FROM User")
public List<UserWithPlaylistsAndSongs> getUsersWithPlaylistsAndSongs();