Mapeamento do modelo de dados

Mapeamento com modo de desenvolvimento

Quando você habilita o modo de desenvolvimento na configuração do Realm Mobile Sync, o App Services pode criar automaticamente collection e esquemas para objeto do Realm que você sincroniza. Ele cria essas collection no reconhecimento de data center que você especifica ao habilitar o modo de desenvolvimento.

Com o modo de desenvolvimento habilitado, a sincronização procura uma coleção cujo esquema do App Services tenha um title que corresponda ao nome do seu tipo de objeto do banco de dados Realm. Essa collection pode estar em qualquer reconhecimento de data center em seu conjunto de dados vinculada. Ele não precisa estar no banco de dados que você adiciona ao configurar o modo de desenvolvimento.

Se não houver um title correspondente em nenhum esquema do App Services no seu conjunto de dados vinculado, o App Services criará uma nova collection para esse Tipo de objeto de Realm. Essa collection é criada no reconhecimento de data center que você especifica ao habilitar o modo de desenvolvimento. O nome da collection corresponde ao Tipo de objeto de Realm e o esquema correspondente do App Services tem um campo title cujo valor é o nome do Tipo de objeto de Realm. Isso cria o mapeamento entre o objeto do reconhecimento de data center do Realm e a nova collection.

Nome do Tipo

O campo title contém o nome do tipo de objeto representado pelo esquema. Isso é equivalente a um nome de classe ou esquema em um Atlas Device SDK. O nome do tipo deve ser exclusivo entre todos os esquemas em seu cluster sincronizado, mas é arbitrário e não precisa corresponder ao nome da coleção.

Uma abordagem convencional é nomear cada Tipo de objeto de Realm com um nome singular, como "Dog" ou "Pessoa". Os esquemas gerados no modo de desenvolvimento ou por amostragem de documentos existentes usam essa convenção.

Tipos de propriedade

Você pode configurar as seguintes restrições para uma determinada propriedade:

Para obter detalhes específicos do SDK sobre tipos de dados, consulte o seguinte:

• Tipos suportados - C++ SDK

• Tipos de dados - Flutter SDK

• Tipos de dados de Realm - SDK Java

• Tipos suportados - Kotlin SDK

• Tipos de campo - .NET SDK

• Tipos de dados do realm - SDK do Node.js

• Tipos de propriedade - React Native SDK

• Tipos de propriedade suportados - Swift SDK

propriedade da matriz

Os modelos de objeto do SDK e os esquemas Atlas App Services suportam propriedades de array.

Para obter detalhes específicos do SDK sobre propriedades da array, consulte o seguinte:

• Tipos suportados - C++ SDK

• Tipos de Dart - Flutter SDK

• Listas - Java SDK

• Tipos suportados - Kotlin SDK

• Listas - .NET SDK

• Tipos de propriedade compatíveis - SDK do Node.js

• Tipos de propriedade suportados - React Native SDK

• Tipos suportados - Swift SDK

Para obter mais informações sobre como modelar propriedades de array em um esquema do Atlas App Services , consulte BSON types - Array. Os esquemas Atlas App Services suportam determinadas restrições que os modelos de objeto do SDK não suportam, como especificar o número mínimo e máximo de itens.

Propriedades mistas

Os modelos de objeto do SDK e os esquemas Atlas App Services oferecem suporte a propriedades de tipo misto.

Um campo misto pode conter qualquer tipo de dados suportado e funcionalmente atua como um objeto ou documento sem uma estrutura predefinida.

Para obter mais informações sobre a modelagem de propriedades mistas em um esquema do Atlas App Services , consulte Misto - Tipos de esquema.

Objetos embarcados

Objetos embarcados são embarcados como dados aninhados dentro de um objeto pai. Um objeto embarcado herda o ciclo de vida de seu objeto pai. Não pode existir como um objeto de banco de dados independente.

Para obter detalhes específicos do SDK sobre objetos incorporados, consulte o seguinte:

• Definir um objeto incorporado - C++ SDK

• objeto incorporado - Flutter SDK

• Definir um campo de objeto incorporado - Java SDK

• Objetos incorporados - Kotlin SDK

• Objetos embarcados - .NET SDK

• Objetos incorporados - SDK do Node.js

• Objetos incorporados - React SDK nativo

• Definir uma propriedade de objeto embarcado - Swift SDK

Para obter mais informações sobre a modelagem de relacionamentos um-para-um em um esquema do Atlas App Services , consulte Relacionamentos de objetos incorporados.

Conjuntos

Os modelos de objeto do SDK e os esquemas do Atlas App Services são compatíveis com o tipo de dados Set. Um conjunto é uma collection de valores únicos.

Para obter detalhes específicos do SDK sobre conjuntos, consulte o seguinte:

• Definir - C++ SDK

• RealmSet - Flutter SDK

• RealmSet - Java SDK

• RealmSet - Kotlin SDK

• Conjuntos - .NET SDK

• Conjuntos - SDK do Node.js

• Conjuntos - React Native SDK

• Conjunto mutável - Swift SDK

Para obter mais informações sobre como modelar conjuntos em um esquema do Atlas App Services , consulte Conjunto.

Dicionários

Os modelos de objeto do SDK e os esquemas do Atlas App Services oferecem suporte ao tipo de dados Dicionário. Um conjunto é uma collection de valores únicos. Um dicionário é uma coleção de chaves de string dinâmicas e únicas emparelhadas com valores de um determinado tipo. Um dicionário é funcionalmente um objeto ou documento sem nomes de campo predefinidos.

Para obter detalhes específicos do SDK sobre dicionários, consulte o seguinte:

• Mapa/Dicionário - C++ SDK

• RealmMap - Flutter SDK

• RealmDictionary - SDK Java

• RealmDictionary - Kotlin SDK

• Dicionários - .NET SDK

• Dicionários - SDK do Node.js

• Dicionários - Reagir SDK nativo

• Mapa/Dicionário - Swift SDK

Para obter mais informações sobre como modelar dicionários em um esquema do Atlas App Services , consulte Dicionário.

appservices schema

Este esquema do Atlas App Services cria o modelo de dados do Dog utilizado pelo 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 objeto do SDK

Os seguintes exemplos de código criam o modelo de objeto do SDK do Dog em cada um dos Atlas Device SDKs.

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',
};

Dados no Atlas

Um aplicativo utilizando o Device Sync para o modelo de dados do Dog cria documentos MongoDB no Atlas baseado nos 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"
      }
    ]
  }
}