تحديد العلاقات المتداخلة وإجراء طلبات بحث بشأنها

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

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

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 التي تمثّل علاقة بين كيانين من النوع &quot;واحد إلى متعدد&quot;، وهما فئة الكيان 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();