Mapeo de modelos de datos

Mapping with Development Mode

Al habilitar el modo de desarrollo en la configuración de sincronización de dispositivos, App Services puede crear automáticamente colecciones y esquemas para los objetos de la base de datos de Realm que sincronice. Estas colecciones se crean en la base de datos que especifique al habilitar el modo de desarrollo.

Con el modo de desarrollo activado, sincronizar busca una colección cuyo esquema de aplicación Services tenga un title que coincida con el nombre del tipo de objeto Realm de la base de datos de Realm. Esta colección podría estar en cualquier base de datos de su fuente de datos vinculada. No es necesario que esté en la base de datos que añadas al configurar el modo de desarrollo.

Si no hay un title correspondiente en ningún esquema de App Services de tu fuente de datos vinculada, App Services crea una nueva colección para este tipo de objeto. Esta colección se crea en la base de datos que especifiques al habilitar el modo de desarrollo. El nombre de la colección coincide con el tipo de objeto, y el esquema de App Services correspondiente tiene un campo title cuyo valor es el nombre del tipo de objeto. Esto crea la asignación entre el objeto de la base de datos de Realm y la nueva colección.

Nombre del tipo

El campo title contiene el nombre del tipo de objeto representado por el esquema. Esto equivale a un nombre de clase o esquema en un SDK de dispositivo Atlas. El nombre del tipo debe ser único entre todos los esquemas del clúster sincronizado; de lo contrario, es arbitrario y no necesita coincidir con el nombre de la colección.

Un enfoque convencional consiste en nombrar cada tipo de objeto con un sustantivo singular, como "Perro" o "Persona". Los esquemas generados en modo de desarrollo o mediante el muestreo de documentos existentes utilizan esta convención.

Tipos de propiedad

Puede configurar las siguientes restricciones para una propiedad determinada:

Para obtener detalles específicos de SDK sobre los tipos de datos, consulta lo siguiente:

• Supported Types - C++ SDK

• Tipos de datos - Flutter SDK

• Realm Data Types - Java SDK

• Supported Types - Kotlin SDK

• Tipos de campo - .NET SDK

• Tipos de datos de Realm - SDK de Node.js

• Tipos de propiedad - SDK de React Native

• Tipos de propiedades compatibles - Swift SDK

Propiedades del arreglo

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten propiedades de matriz.

Para detalles específicos del SDK sobre las propiedades de los arreglos, consulte lo siguiente:

• Supported Types - C++ SDK

• Tipos de Dart - SDK de Flutter

• Listas - SDK de Java

• Supported Types - Kotlin SDK

• Lists - .NET SDK

• Supported Property Types - Node.js SDK

• Tipos de propiedades compatibles - React Native SDK

• Tipos admitidos - Swift SDK

Para obtener más información sobre el modelado de propiedades de matriz en un esquema de App Services, consulte Tipos BSON - Matriz. Los esquemas de App Services admiten ciertas restricciones que los modelos de objetos del SDK no admiten, como especificar el número mínimo y máximo de elementos.

Propiedades mixtas

Tanto los modelos de objetos del SDK como los esquemas de App Services admiten propiedades de tipo mixto.

Un campo mixto puede contener cualquier tipo de datos admitido y actúa funcionalmente como un objeto o documento sin una estructura predefinida.

Para obtener más información sobre cómo modelar propiedades mixtas en un esquema de App Services, consulte Mixto: Tipos de esquema.

objeto incrustado

Los objetos incrustados se integran como datos anidados dentro de un objeto principal. Un objeto incrustado hereda el ciclo de vida de su objeto principal. No puede existir como un objeto de base de datos independiente.

For SDK-specific details about embedded objects, refer to the following:

• Define an Embedded Object - C++ SDK

• Embedded Objects - Flutter SDK

• Define an Embedded Object Field - Java SDK

• Embedded Objects - Kotlin SDK

• Objetos Incrustados - .NET SDK

• Objetos incrustados - SDK de Node.js

• Embedded Objects - React Native SDK

• Definir una propiedad de objeto incrustado - Swift SDK

Para obtener más información sobre cómo modelar relaciones de uno a uno en un esquema de App Services, consulte Relaciones de objetos integrados.

Sets

SDK object models and App Services schemas both support the Set data type. A set is a collection of unique values.

For SDK-specific details about sets, refer to the following:

• Set - C++ SDK

• RealmSet - SDK de Flutter

• RealmSet - Java SDK

• RealmSet - Kotlin SDK

• Sets - .NET SDK

• Conjuntos - SDK de Node.js

• Sets - React Native SDK

• Mutable Set - Swift SDK

Para obtener más información sobre cómo modelar conjuntos en un esquema de Servicios de aplicación, consulta Set.

Diccionarios

Los modelos de objetos SDK y los esquemas de los Servicios de Apps son compatibles con el tipo de datos Diccionario. Un conjunto es una colección de valores únicos. Un diccionario es una colección de claves de strings dinámicas y únicas emparejadas con valores de un tipo dado. Un diccionario es funcionalmente un objeto o documento sin nombres de campo predefinidos.

Para obtener detalles específicos del SDK sobre diccionarios, consulta lo siguiente:

• Mapa/Dictionary - C++ SDK

• RealmMap - Flutter SDK

• RealmDictionary - Java SDK

• Diccionario Real - SDK de Kotlin

• Diccionarios - .NET SDK

• Dictionaries - Node.js SDK

• Diccionarios - React Native SDK

• Mapa/Diccionario - Swift SDK

Para obtener más información sobre el modelado de diccionarios en un esquema de App Services, consulte Diccionario.

Esquema de aplicación Services

This App Services schema creates the Dog data model used by Device Sync.

{
  "title": "Dog",
  "bsonType": "object",
  "required": [
    "_id",
    "name"
  ],
  "properties": {
    "_id": {
      "bsonType": "objectId"
    },
    "name": {
      "bsonType": "string"
    },
    "age": {
      "bsonType": "int"
    }
    "breed": {
      "bsonType": "string"
    }
    "details": {
      "bsonType": "mixed"
    }
  }
}

Modelo de objetos del SDK

Los siguientes ejemplos de código crean el modelo de objeto del SDK Dog en cada uno de los SDKs de Dispositivos Atlas.

import Foundation
import RealmSwift
class Dog: Object {
    @Persisted(primaryKey: true) var _id: ObjectId
    @Persisted var age: Int?
    @Persisted var breed: String?
    @Persisted var name: String = ""
    @Persisted var details: AnyRealmValue
}

import io.realm.RealmObject;
import org.bson.types.ObjectId;
public class Dog extends RealmObject {
    @PrimaryKey
    @Required
    private ObjectId _id;
    private Integer age;
    private String breed;
    @Required
    private String name;
    private RealmAny details;
    // Standard getters & setters
    public ObjectId getId() { return _id; }
    public void setId(ObjectId _id) { this._id = _id; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public String getBreed() { return breed; }
    public void setBreed(String breed) { this.breed = breed; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public RealmAny getDetails() { return details; }
    public void setDetails(RealmAny details) { this.details = details; }
}

import io.realm.RealmObject;
import org.bson.types.ObjectId;
open class Dog : RealmObject {
    @PrimaryKey
    var _id: ObjectId = ObjectId(),
    var age: Int? = null,
    var breed: String? = null,
    var name: String = ""
    var details: RealmValue? = null
}

import 'package:realm/realm.dart';
part 'realm_models.realm.dart';
@RealmModel()
class _Dog {
  @PrimaryKey()
  @MapTo('_id')
  late ObjectId id;
  int? age;
  String? breed;
  late String name;
  late RealmValue details;
}

using System;
using System.Collections.Generic;
using Realms;
using MongoDB.Bson;
public class Dog : RealmObject
{
    [MapTo("_id")]
    [PrimaryKey]
    public ObjectId Id { get; set; }
    [MapTo("age")]
    public int? Age { get; set; }
    [MapTo("breed")]
    public string Breed { get; set; }
    [MapTo("name")]
    [Required]
    public string Name { get; set; }
    [MapTo("details")]
    public RealmValue Details { get; set; }
}

export const DogSchema = {
  name: 'Dog',
  properties: {
    _id: 'objectId',
    age: 'int?',
    breed: 'string?',
    name: 'string',
  },
  primaryKey: '_id',
  details: 'mixed',
};

export const DogSchema = {
   class Dog extends Realm.Object<Dog> {
     _id!: Realm.BSON.ObjectId;
       age?: number;
       breed?: string;
       name!: string;
       details?: Realm.Mixed;
     static schema: ObjectSchema = {
       name: 'Dog',
         properties: {
           _id: 'objectId',
           age: 'int?',
           breed: 'string?',
           name: 'string',
           details: 'mixed?',
         },
       primaryKey: '_id',
};

Datos en Atlas

Una aplicación que utiliza Device Sync para el modelo de datos Dog crea documentos MongoDB en Atlas según los esquemas anteriores.

{
  "_id": ObjectId('616f44305a205add93ff1081'),
  "age": 8,
  "breed": "Golden Retriever",
  "name": "Jasper",
  "details": null
}

{
  "_id": ObjectId('616f44305a205add93ff1081'),
  "age": 8,
  "breed": "Golden Retriever",
  "name": "Jasper",
  "details": {
    "vaccinations": ["rabies", "distemper"],
    "weight": 65.5,
    "isNeutered": true,
    "vetVisits": [
      {
        "date": 2002-08-18T04:56:07.000+00:00,
        "reason": "annual checkup"
      },
      {
        "date": 2003-08-18T04:56:07.000+00:00,
        "reason": "annual checkup"
      }
    ]
  }
}