Introducción a la sincronización de dispositivos Realm Web y Atlas (versión preliminar)

Reino de importación

Importa el reino en la parte superior de tus archivos de origen donde interactúas con la base de datos:

import Realm, { App } from "realm";

Inicializar una aplicación

Device Sync utiliza Atlas App Services para gestionar la autenticación y sincronizar datos entre dispositivos. Para usar Device Sync desde tu aplicación web, debes conectarte a una aplicación de App Services que tenga Device Sync habilitado.

Te conectas a una aplicación usando su ID de aplicación cliente. Para saber cómo obtenerlo, consulta "Buscar el ID de tu aplicación".

const app = new App({ id: "<your-app-id>" });

Autenticar un usuario

Para autenticar a un usuario, llama al App.logIn() método en la instancia de tu aplicación. Puedes iniciar sesión con cualquier proveedor de autenticación. Para más ejemplos,consulta "Autenticar un usuario".

const credentials = Realm.Credentials.anonymous();
await app.logIn(credentials);

Define un modelo de objeto

Realm usa objetos nativos de JavaScript para modelar los datos de tu aplicación. Defines tipos de objetos donde todos los objetos de un tipo dado comparten un esquema que controla el contenido del objeto.

Para definir un tipo de objeto de dominio, cree un objeto de esquema que especifique los valores name y properties del tipo. El nombre del tipo debe ser único entre los tipos de objeto de un dominio.

const TaskSchema = {
  name: "Task",
  properties: {
    _id: "int",
    name: "string",
    status: "string?",
    owner_id: "string?",
  },
  primaryKey: "_id",
};

Abrir un reino

Para abrir un dominio sincronizado, llame a Realm.open() con un objeto de configuración que especifique el esquema del dominio e incluya un objeto de configuración sync. La configuración de sincronización debe especificar el usuario autenticado y definir las suscripciones iniciales que controlan los datos que se sincronizan:

const realm = await Realm.open({
  schema: [TaskSchema],
  sync: {
    user: app.currentUser,
    flexible: true,
    // Define initial subscriptions to start syncing data as soon as the
    // realm is opened.
    initialSubscriptions: {
      update: (subs, realm) => {
        subs.add(
          // Get objects that match your object model, then filter them by
          // the `owner_id` queryable field
          realm.objects(Task).filtered(`owner_id == "${anonymousUser.id}"`)
        );
      },
    },
  },
});

Abre un Realm no sincronizado

Para abrir un reino local en memoria que no se sincroniza, llame a Realm.open() con un objeto de configuración de reino local:

const realm = await Realm.open({
  schema: [TaskSchema]
});

Crear, modificar y eliminar objetos de Realm

Una vez abierto un dominio, puede crear, modificar y eliminar objetos en él. Todas las operaciones de escritura deben realizarse dentro de un bloque de transacción Realm.write().

const allTasks = realm.objects(Task);
// Add a couple of Tasks in a single, atomic transaction.
realm.write(() => {
  realm.create(Task, {
    _id: 1,
    name: "go grocery shopping",
    status: "Open",
  });
  realm.create(Task, {
    _id: 2,
    name: "go exercise",
    status: "Open",
  });
});
const task1 = allTasks.find((task) => task._id == 1);
const task2 = allTasks.find((task) => task._id == 2);
realm.write(() => {
  // Modify an object.
  task1!.status = "InProgress";
  // Delete an object.
  realm.delete(task2);
});

Buscar, ordenar y filtrar objetos

Puedes query objetos en un realm usando el método Realm.objects(). Las consultas deben especificar el tipo de objeto Realm a consultar. Opcionalmente, puedes filtrar y ordenar los resultados de una query utilizando una API de cadena de métodos fluida.

// Query for specific obect using primary key.
const specificTask = realm.objectForPrimaryKey(Task, 0);
// Query realm for all instances of the "Task" type.
const tasks = realm.objects(Task);
// Filter for all tasks with a status of "Open".
const openTasks = tasks.filtered("status = 'Open'");
// Sort tasks by name in ascending order.
const tasksByName = tasks.sorted("name");

Cerrar un reino

Llame al método Realm.close() cuando termine con una instancia de reino para evitar pérdidas de memoria.

// Close the realm.
realm.close();