العلاقات المُدمجة

في بعض الأحيان، قد تحتاج إلى إجراء طلب بحث في مجموعة من ثلاثة جداول أو أكثر مرتبطة ببعضها. في هذه الحالة، يمكنك تحديد علاقات متداخلة بين الجداول.

لنفترض أنّك تريد في مثال تطبيق بث الموسيقى إجراء طلب بحث عن كل المستخدمين وكل قوائم التشغيل لكل مستخدم وكل الأغاني في كل قائمة تشغيل لكل مستخدم. تربط المستخدمين علاقة مباشرة بقوائم التشغيل، وعلاقة أطراف بأطراف بين قوائم التشغيل والأغاني. يعرض مثال الرمز التالي الفئات التي تمثّل هذه الكيانات بالإضافة إلى جدول المراجع المتبادلة للعلاقة بين العديد من قوائم التشغيل و الأغاني:

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;
}

أولاً، أنشئ نموذجًا للعلاقة بين جدولَين في مجموعتك كما هو معمول به عادةً، باستخدام فئة بيانات والتعليق التوضيحي @Relation. يعرض المثال التالي فئة PlaylistWithSongs التي تنشئ نموذجًا لعلاقة بين العديد من القيم والعديد من القيم الأخرى بين فئة العنصر Playlist وفئة العنصر Song:

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;
}

بعد تحديد فئة بيانات تمثّل هذه العلاقة، أنشئ فئة بيانات أخرى تمثّل العلاقة بين جدول آخر من مجموعتك وفئة العلاقات الأولى، ما يؤدي إلى "تداخل" العلاقة الحالية ضمن العلاقة الجديدة. يعرض المثال التالي فئة UserWithPlaylistsAndSongs التي تنمّذ علاقة بين عنصر واحد وعناصر متعددة بين فئة العنصر User وفئة العلاقة PlaylistWithSongs:

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 بشكل غير مباشر العلاقات بين فئات العناصر الثلاث: User وPlaylist وSong. يوضّح الشكل 1 ذلك.

يوضّح UserWithPlaylistsAndSongs العلاقة بين User و PlaylistWithSongs، ما يوضّح بدوره العلاقة بين Playlist وSong.
الشكل 1. مخطّط بياني لفئات العلاقات في مثال تطبيق بث الموسيقى

إذا كانت هناك أي جداول أخرى في مجموعتك، أنشئ فئة لنمذجة العلاقة بين كل جدول متبقٍ وفئة العلاقة التي تنشئ نماذج للعلاقات بين جميع الجداول السابقة. يؤدي ذلك إلى إنشاء سلسلة من علاقات المدمجة بين جميع الجداول التي تريد الاستعلام عنها.

أخيرًا، أضِف طريقة إلى فئة DAO لعرض دالة طلب البحث التي يحتاج إليها تطبيقك. تتطلّب هذه الطريقة من Room تنفيذ طلبات بحث متعددة، لذا أضِف التعليق التوضيحي @Transaction لكي يتم تنفيذ العملية بالكامل بشكل منتظم:

Kotlin

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

Java

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