Relaciones - SDK de Kotlin

Definir una propiedad de relación de uno a uno

Una relación uno a uno asigna una propiedad a una sola instancia de un RealmObject tipo de objeto. Nada impide que varias instancias de un objeto principal hagan referencia a la misma instancia secundaria. Si desea aplicar una relación uno a uno estricta, utilice un objeto incrustado.

Para definir una relación de uno a uno entre objetos, defina una propiedad de objeto opcional cuyo tipo sea un objeto RealmObject definido en su modelo de datos. Puede ser un tipo de objeto de Realm diferente o el mismo tipo de objeto de 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
}

Definir una propiedad de relación de muchos

Una relación de uno a muchos asigna una propiedad a cero o más instancias de un RealmObject tipo de objeto. Nada impide que varias instancias de un objeto padre hagan referencia a la misma instancia hija. Si desea aplicar una relación estricta de uno a muchos, utilice un objeto incrustado.

En Realm, las relaciones de varios elementos son colecciones (una RealmList o un RealmSet) de objetos de Realm. Para obtener más información sobre cómo definir colecciones en el modelo de objetos, consulte Definir propiedades de colección.

Para definir una relación de varios objetos, defina una propiedad de objeto cuyo tipo sea RealmList<E> o RealmSet<E>, donde <E> es un tipo de objeto RealmObject definido en su modelo de datos. Este puede ser un tipo de objeto de Realm diferente o el mismo tipo de objeto de 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()
}

Definir una relación inversa

Una relación inversa es una relación de retroenlace automático entre un RealmObject objeto secundario y cualquier otro objeto principal que haga referencia a él. Las relaciones inversas pueden vincularse con objetos secundarios en una relación de varios a uno o de varios a varios. Si desea aplicar una relación inversa estricta de uno a uno o de uno a varios, utilice un objeto incrustado.

Las definiciones de relación son unidireccionales, por lo que debe definir explícitamente una propiedad en el modelo del objeto como una relación inversa. Por ejemplo, la relación a muchos "El usuario tiene muchas publicaciones" no crea automáticamente la relación inversa "La publicación pertenece al usuario". Sin embargo, puede agregar una propiedad de usuario a la publicación que apunte a su propietario. Esto le permite consultar la relación inversa de la publicación al usuario en lugar de ejecutar una consulta independiente para buscar al usuario al que pertenece la publicación. Dado que las relaciones son de muchos a uno o de muchos a muchos, las siguientes relaciones inversas pueden generar cero, uno o muchos objetos.

Para definir una relación inversa entre objetos, primero defina una propiedad de colección en el objeto principal cuyo tipo sea RealmList<E>, RealmSet<E> o RealmDictionary<E>, donde <E> es un tipo de objeto RealmObject definido en su modelo de datos. Este puede ser un tipo de objeto Realm diferente o el mismo tipo de objeto 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()
}

Luego, defina una propiedad de vínculos de retroceso inmutables en el objeto secundario RealmResults<E> de, donde <E> es el tipo de objeto principal:

// 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)
}

Definir un objeto incrustado

Un objeto incrustado es un tipo especial de objeto Realm que permite anidar datos dentro de un único objeto principal específico. Los objetos incrustados pueden tener una relación uno a uno, uno a muchos o inversa, similar a las relaciones descritas en las secciones anteriores, excepto que la relación se limita a una relación uno a uno entre un único objeto principal y un EmbeddedRealmObject tipo.

Dado que los objetos incrustados no pueden existir como objetos Realm independientes, tienen restricciones adicionales a considerar:

• Un objeto incrustado tiene propiedad estricta de su padre. No se pueden compartir objetos incrustados entre objetos padres.

• El objeto incrustado hereda el ciclo de vida de su elemento principal. Por ejemplo, al eliminar el elemento principal, también se elimina el objeto incrustado.

Los objetos incrustados son útiles cuando existe una clara relación de contención o propiedad. Por ejemplo, un objeto Address podría estar incrustado en un objeto User porque solo tiene sentido en la aplicación dentro del contexto de un usuario.

// 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)
}