관계 - Kotlin SDK

대일 관계 속성 정의

관계 관계 는 하나의 속성 을 RealmObject 객체 유형의 단일 인스턴스 에 매핑합니다. 여러 상위 객체 인스턴스가 동일한 하위 인스턴스 를 참조하는 것을 방지하는 것은 없습니다. 엄격한 일대일 관계 를 시행하다 하려면 내장된 객체 를 대신 사용하세요.

객체 간의 대일 관계를 정의하려면 데이터 모델에 정의된 RealmObject 객체 유형의 선택적 객체 속성을 정의합니다. 이는 다른 Realm 객체 유형일 수도 있고 동일한 Realm 객체 유형일 수도 있습니다.

// Relationships of Realm objects must be of RealmObject type
class Frog : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    var age: Int = 0
    // Property of RealmObject type (MUST be null)
    var favoritePond: Pond? = null
    var bestFriend: Frog? = null
}

대다 관계 속성 정의

대다 관계 는 하나의 속성을 0개 이상의 RealmObject 객체 유형 인스턴스에 매핑합니다. 여러 상위 객체 인스턴스가 동일한 하위 인스턴스를 참조하는 것을 방지하는 것은 없습니다. 엄격한 일대다 관계를 적용하려면 포함된 객체를 대신 사용하세요.

Realm 에서 대다 관계는 Realm 객체의 컬렉션( RealmList 또는 RealmSet)입니다. 객체 모델 에서 컬렉션을 정의하는 방법에 대한 자세한 내용은 컬렉션 속성 정의를 참조하세요.

객체 간의 대다 관계 를 정의하려면 유형이 RealmList<E> 또는 RealmSet<E> 인 객체 속성 을 정의하고, 여기서 <E> 는 데이터 모델 에 정의된 RealmObject 객체 유형입니다. 이는 다른 Realm 객체 유형 수도 있고 동일한 Realm 객체 유형 수도 있습니다.

// Relationships of RealmList<E> or RealmSet<E> must be of RealmObject type
class Forest : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    // Set of RealmObject type (CANNOT be null)
    var frogsThatLiveHere: RealmSet<Frog> = realmSetOf()
    // List of RealmObject type (CANNOT be null)
    var nearbyPonds: RealmList<Pond> = realmListOf()
}

역관계 정의

역관계 는 하위 RealmObject 객체와 이를 참조하는 다른 상위 객체 간의 자동 역 링크 관계입니다. 역관계는 다대일 또는 다대다 관계의 하위 객체에 다시 연결할 수 있습니다. 엄격한 일대일 또는 일대다 역관계를 적용하려면 포함된 객체를 대신 사용하세요.

관계 정의는 단방향이므로 객체 모델의 속성 을 관계 로 명시적으로 정의해야 합니다. 예를 예시'사용자에게 많은 게시물이 있음'이라는 대다 관계 는 '게시물이 사용자에게 속함'이라는 관계 자동으로 생성하지 않습니다. 그러나 게시물의 소유자를 가리키는 사용자 속성 을 게시물에 추가할 수 있습니다. 이를 통해 게시 이 속한 사용자를 조회하기 위해 별도의 쿼리 를 실행 하는 대신 게시 과 사용자 관계 를 쿼리 할 수 있습니다. 관계는 다대일 또는 다대다이므로 역관계를 따르면 객체가 0개, 1개 또는 여러 개일 수 있습니다.

객체 간의 역관계를 정의하려면 먼저 유형이 RealmList<E>, RealmSet<E> 또는 RealmDictionary<E> 인 상위 객체에서 컬렉션 속성을 정의하며, 여기서 <E> 은 데이터 모델에 정의된 RealmObject 객체 유형입니다. . 이는 다른 Realm 객체 유형일 수도 있고 동일한 Realm 객체 유형일 수도 있습니다.

// Parent object must have RealmList<E>, RealmSet<E>, or
// RealmDictionary<K,V> property of child type
class User : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    // List of child RealmObject type (CANNOT be nullable)
    var posts: RealmList<Post> = realmListOf()
    // Set of child RealmObject type (CANNOT be nullable)
    var favoritePosts: RealmSet<Post> = realmSetOf()
    // Dictionary of child RealmObject type (value MUST be nullable)
    var postByYear: RealmDictionary<Post?> = realmDictionaryOf()
}

그런 다음 RealmResults<E> 의 하위 객체에 불변의 역 링크 속성을 정의하고, 여기서 <E> 는 상위 객체 유형입니다.

// Backlink of RealmObject must be RealmResults<E> of parent object type
class Post : RealmObject {
    var title: String = ""
    var date: RealmInstant = RealmInstant.now()
    // Backlink to parent RealmObject type (CANNOT be null & MUST be val)
    val user: RealmResults<User> by backlinks(User::posts)
}

포함된 객체 정의

내장된 객체 는 단일 특정 상위 객체 내에 데이터를 중첩하는 데 사용할 수 있는 특수한 유형의 Realm 객체 입니다. 포함된 객체는 이전 섹션에서 설명한 관계 와 유사한 일대일, 일대다 또는 관계 일 수 있지만, 단일 상위 객체 관계 EmbeddedRealmObject 유형.

포함된 객체는 독립적인 Realm 객체로 존재할 수 없으므로 고려해야 할 추가 제약 조건이 있습니다.

• 포함된 객체는 상위 객체가 엄격한 소유권을 갖습니다. 상위 객체 간에 포함된 객체를 공유할 수 없습니다.

• 내장된 객체 는 상위 객체의 라이프사이클을 상속합니다. 예를 예시, 상위 객체 를 삭제하면 내장된 객체 도 삭제됩니다.

포함된 객체는 명확한 포함 관계 또는 소유권 관계 가 있을 때 유용합니다. 예를 예시 Address 객체 는 사용자 컨텍스트 내의 애플리케이션 에서만 의미가 있기 때문에 User 객체 에 포함될 수 있습니다.

// To-one embedded relationships must be of EmbeddedRealmObject type
class Contact : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    // Property of EmbeddedRealmObject type (MUST be null)
    var address: EmbeddedAddress? = null
}
class EmbeddedAddress : EmbeddedRealmObject {
    var propertyOwner: Contact? = null
    var street: String? = ""
    // Embed another EmbeddedRealmObject type
    var country: EmbeddedCountry? = null
}
class EmbeddedCountry : EmbeddedRealmObject {
    var name: String = ""
}

// To-many embedded relationships must be a RealmList<E> or
// RealmDictionary<K, V> property of EmbeddedRealmObject type
class Business : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    // List of EmbeddedRealmObject type (CANNOT be null)
    var addresses: RealmList<EmbeddedAddress> = realmListOf()
    // Dictionary of EmbeddedRealmObject type (value MUST be nullable)
    var addressByYear: RealmDictionary<EmbeddedAddress?> = realmDictionaryOf()
}

// Parent object must have RealmList<E> or RealmDictionary<K, V>
// property of child EmbeddedRealmObject type
class User : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId()
    var name: String = ""
    // List of child EmbeddedRealmObject type (CANNOT be nullable)
    var posts: RealmList<Post> = realmListOf()
    // Dictionary of child EmbeddedRealmObject type (value MUST be nullable)
    var postByYear: RealmDictionary<Post?> = realmDictionaryOf()
}

// Backlink of EmbeddedRealmObject must be parent object type
class Post : EmbeddedRealmObject {
    var title: String = ""
    var date: RealmInstant = RealmInstant.now()
    // Backlink to parent RealmObject type (CANNOT be null & MUST be val)
    val user: User by backlinks(User::posts)
}