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

Bazen, hepsi birbiriyle alakalı olan üç veya daha fazla tabloyu sorgulamanız gerekebilir. Bu durumda, tablolar arasında iç içe yerleştirilmiş ilişkiler tanımlarsınız.

Dikkat: İç içe yerleştirilmiş ilişkiler içeren verileri sorgulamak için Room'un büyük miktarda veri üzerinde işlem yapması gerekir ve bu işlem performansı etkileyebilir. Sorgularınızda mümkün olduğunca az iç içe yerleştirilmiş ilişki kullanın.

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 çok-çok ilişki vardır. Aşağıdaki kod örneğinde, bu öğeleri temsil eden sınıfların yanı sıra oynatma listeleri ile şarkılar arasındaki çoklu 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 normal şekilde modelleyin. Aşağıdaki örnekte, Playlist varlık sınıfı ile Song varlık sınıfı arasındaki çoklu 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, mevcut ilişkiyi yeni ilişkiye "iç içe yerleştirerek" 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. Aşağıdaki örnekte, User öğe sınıfı ile PlaylistWithSongs ilişki sınıfı arasındaki bire çok ilişkiyi modelleyen bir UserWithPlaylistsAndSongs sınıfı 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 olmak üzere üç öğe sınıfı arasındaki ilişkileri dolaylı olarak modeller. Bu durum Şekil 1'de gösterilmiştir.

Şekil 1. Müzik akış uygulaması örneğindeki ilişki sınıflarının şeması.

Kümenizde başka tablolar varsa kalan her 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 ilişki zinciri oluşturur.

Son olarak, uygulamanızın ihtiyaç duyduğu sorgu işlevini göstermek için DAO sınıfına bir yöntem ekleyin. Bu yöntem, Room'un birden fazla sorgu çalıştırmasını gerektirir. Bu nedenle, işlemin tamamının 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();