رابطه یک به یک بین دو موجودیت رابطه ای است که در آن هر نمونه از موجودیت اصلی دقیقاً با یک نمونه از موجودیت فرزند مطابقت دارد و عکس آن نیز صادق است.
به عنوان مثال، یک برنامه پخش موسیقی را در نظر بگیرید که در آن کاربر کتابخانه ای از آهنگ های خود را دارد. هر کاربر فقط یک کتابخانه دارد و هر کتابخانه دقیقاً مربوط به یک کاربر است. بنابراین، یک رابطه یک به یک بین موجودیت User
و نهاد Library
وجود دارد.
برای تعریف و جستجوی روابط یک به یک در پایگاه داده خود، مراحل زیر را دنبال کنید:
- تعریف رابطه : کلاس هایی برای هر دو موجودیت ایجاد کنید، مطمئن شوید که یکی به کلید اصلی دیگری ارجاع می دهد.
- پرس و جو از موجودیت ها : رابطه را در یک کلاس داده جدید مدل کنید و روشی برای بازیابی داده های مرتبط ایجاد کنید.
رابطه را تعریف کنید
برای تعریف یک رابطه یک به یک، ابتدا برای هر یک از دو موجودیت خود یک کلاس ایجاد کنید. یکی از موجودیت ها باید دارای متغیری باشد که مرجعی به کلید اصلی موجودیت دیگر باشد.
کاتلین
@Entity
data class User(
@PrimaryKey val userId: Long,
val name: String,
val age: Int
)
@Entity
data class Library(
@PrimaryKey val libraryId: Long,
val userOwnerId: Long
)
جاوا
@Entity
public class User {
@PrimaryKey public long userId;
public String name;
public int age;
}
@Entity
public class Library {
@PrimaryKey public long libraryId;
public long userOwnerId;
}
پرس و جو از موجودیت ها
برای جستجو در لیست کاربران و کتابخانه های مربوطه، ابتدا باید رابطه یک به یک بین دو موجودیت را مدل کنید.
برای انجام این کار، یک کلاس داده جدید ایجاد کنید که در آن هر نمونه یک نمونه از موجودیت والد و نمونه متناظر از موجودیت فرزند را در خود جای دهد. حاشیهنویسی @Relation
را به نمونه موجودیت فرزند اضافه کنید، با مجموعه parentColumn
به نام ستون کلید اصلی موجودیت والد و entityColumn
به نام ستون موجودیت فرزند که به کلید اصلی موجودیت والد ارجاع میدهد.
کاتلین
data class UserAndLibrary(
@Embedded val user: User,
@Relation(
parentColumn = "userId",
entityColumn = "userOwnerId"
)
val library: Library
)
جاوا
public class UserAndLibrary {
@Embedded public User user;
@Relation(
parentColumn = "userId",
entityColumn = "userOwnerId"
)
public Library library;
}
در نهایت، متدی را به کلاس DAO اضافه کنید که تمام نمونه های کلاس داده را که موجودیت والد و موجودیت فرزند را جفت می کند، برمی گرداند. این روش به Room برای اجرای دو کوئری نیاز دارد. بنابراین شما باید حاشیه نویسی @Transaction
را به این روش اضافه کنید. این تضمین می کند که کل عملیات به صورت اتمی اجرا می شود.
کاتلین
@Transaction
@Query("SELECT * FROM User")
fun getUsersAndLibraries(): List<UserAndLibrary>
جاوا
@Transaction
@Query("SELECT * FROM User")
public List<UserAndLibrary> getUsersAndLibraries();