Sincronización basada en particiones - SDK de Java

Abrir un reino sincronizado mientras estás en línea

Para abrir un dominio sincronizado, llame a getInstanceAsync() y pase un objeto SyncConfiguration. El siguiente código muestra cómo crear un dominio con configuraciones de sincronización específicas creadas con un SyncConfiguration objeto:

SyncConfiguration config = new SyncConfiguration.Builder(app.currentUser(), PARTITION)
        .allowQueriesOnUiThread(true)
        .allowWritesOnUiThread(true)
        .build();
Realm.getInstanceAsync(config, new Realm.Callback() {
    @Override
    public void onSuccess(Realm realm) {
        Log.v(
                "EXAMPLE",
                "Successfully opened a realm with reads and writes allowed on the UI thread."
        );
    }
});

val config = SyncConfiguration.Builder(app.currentUser(), PARTITION)
    .allowQueriesOnUiThread(true)
    .allowWritesOnUiThread(true)
    .build()
Realm.getInstanceAsync(config, object : Realm.Callback() {
    override fun onSuccess(realm: Realm) {
        Log.v("EXAMPLE", "Successfully opened a realm with reads and writes allowed on the UI thread.")
    }
})

El código anterior muestra cómo abrir el realm asincrónicamente usando getInstanceAsync(). También puedes abrir un realm de forma síncrona utilizando getInstance(), el cual retorna un realm abierto antes de sincronizar todos los datos desde el backend. Sin embargo, esto puede generar inconsistencias temporales en los datos mientras se descargan los datos remotos y, en general, no se recomienda. Puedes usar la opción de configuración waitForInitialRemoteData() para forzar al SDK a recuperar datos remotos antes de abrir el realm y evitar estas inconsistencias.

El valor de partición especifica qué subconjunto de datos se sincronizará. Normalmente, se trata de un ID de usuario, un ID de proyecto, un ID de tienda o algún otro identificador de categoría de la aplicación que tenga especial relevancia para el usuario actual.

Abrir un reino sincronizado sin conexión

Puedes abrir un reino sincronizado sin conexión con la misma sintaxis que para abrir un reino sincronizado con conexión. No todos los SDK siguen este patrón, por lo que los desarrolladores multiplataforma deben consultar la documentación de cada SDK para obtener más información.

Actualización del código del cliente después de la migración

La migración automática de la sincronización basada en particiones a la sincronización flexible no requiere cambios en el código de cliente. Sin embargo, para facilitar esta funcionalidad, Realm gestiona automáticamente las diferencias entre los dos modos de sincronización mediante:

• Creación automática de suscripciones de sincronización flexible para cada tipo de objeto donde partitionKey == partitionValue.

• Inyectar un campo partitionKey en cada objeto si no existe. Esto es necesario para la suscripción automática a Sincronización Flexible.

Si necesita actualizar el código de su cliente después de la migración, considere actualizar su base de código para eliminar las funciones de migración ocultas. Le recomendamos actualizar su base de código cuando:

• Agregue un nuevo modelo o cambie un modelo en su base de código de cliente.

• Agrega o cambia funcionalidad que implica leer o escribir objetos de Realm

• Desea implementar un control más preciso sobre los datos que sincroniza

Realice estos cambios para convertir el código de cliente de sincronización basada en particiones para utilizar la sincronización flexible:

• Actualiza tu SyncConfiguration.Builder para usar Flexible Sync. Esto implica remover el partitionValue y agregar un conjunto de suscripciones iniciales, si es necesario.

• Agregue propiedades relevantes a sus modelos de objetos para usarlas en sus suscripciones de Sincronización Flexible. Por ejemplo, podría agregar una propiedad ownerId para permitir que un usuario sincronice solo sus propios datos.

• Eliminar las suscripciones automáticas de Sincronización Flexible. Si no agregó suscripciones iniciales en SyncConfiguration.Builder, cree manualmente las suscripciones correspondientes.

Para obtener ejemplos de estrategias de permisos de sincronización flexible, incluidos ejemplos de cómo modelar datos para estas estrategias, consulte la Guía de permisos de sincronización de dispositivos.