Clase SyncConfiguration.Builder

Agrega un módulo a los módulos ya definidos.

Sets whether or not RealmQueries are allowed from the UI thread.

By default Realm allows queries on the main thread. However, by doing so your application may experience a drop of frames or even ANRs. We recommend diverting queries to non-UI threads or, alternatively, using RealmQuery.findAllAsync() or RealmQuery.findFirstAsync() .

Sets whether or not calls to Realm.executeTransaction are allowed from the UI thread.

WARNING: Realm does not allow synchronous transactions to be run on the main thread unless users explicitly opt in with this method. We recommend diverting calls to executeTransaction to non-UI threads or, alternatively, using Realm.executeTransactionAsync .

Al abrir un Realm por primera vez, en lugar de crear un archivo vacío, el archivo Realm se copiará del archivo de recursos proporcionado y se usará en su lugar. Esto puede usarse para pre-poblar el Realm con datos, para que no sea necesario descargarlos del servidor.

El archivo Realm proporcionado debe ser un Realm sincronizado válido para el usuario dado y debe haber sido creado utilizando la API Realm.writeCopyTo(File).

ADVERTENCIA: Esto podría ser una operación prolongada y, lo ideal, es realizarla en un hilo en segundo plano.

Parámetros

• assetFile - path to the asset database file.

Throws

• IllegalStateException - if this Realm is also marked as inMemory() .

Crea la RealmConfiguration basada en los parámetros del generador.

Devuelve

el SyncConfiguration creado.

Throws

• IllegalStateException - if the configuration parameters are invalid or inconsistent.

Establece el controlador para cuando se produce un reinicio del cliente. Si no se configura ningún controlador, se registra un error al reiniciar el cliente.

Parámetros

• handler - Controlador personalizado en caso de reinicio del cliente.

Sets this to determine if the Realm file should be compacted before returned to the user. It is passed the total file size (data + free space) and the bytes used by data in the file.

Parámetros

• compactOnLaunch - a callback called when opening a Realm for the first time during the life of a process to determine if it should be compacted before being returned to the user. It is passed the total file size (data + free space) and the bytes used by data in the file.

Setting this will cause Realm to compact the Realm file if the Realm file has grown too large and a significant amount of space can be recovered. See DefaultCompactOnLaunchCallback for details.

Establece la clave de bytes io.realm.Realm#ENCRYPTION_KEY_LENGTH utilizada para cifrar y descifrar el archivo Realm.

Parámetros

• key - the encryption key.

Throws

• IllegalArgumentException - if key is invalid.

Establece el gestor de errores utilizado por esta configuración. Solo los errores que no sean manejados por el SyncPolicy definido serán reportados a este gestor de errores.

Parámetros

• errorHandler - gestor de errores utilizado para informar errores al comunicarse con el objeto Realm Server.

Throws

• IllegalArgumentException - si se da null como manejador de errores.

Establece la fábrica de flujos utilizada para crear flujos de corrutinas a partir de objetos de Realm. La fábrica predeterminada es RealmFlowFactory.

Parámetros

• factory - fábrica a utilizar.

Al configurar esto, se creará un dominio en memoria en lugar de guardarlo en el disco. Los dominios en memoria podrían seguir usando espacio en disco si la memoria es insuficiente, pero todos los archivos creados por un dominio en memoria se eliminarán al cerrarlo. Tenga en cuenta que, dado que los dominios en memoria no se almacenan en memoria, debe asegurarse de conservar al menos una referencia no cerrada al objeto del dominio en memoria con el nombre específico mientras desee que los datos perduren.

Establece los datos iniciales en io.realm.Realm. Esta transacción se ejecutará solo la primera vez que se abra (cree) el archivo Realm o durante la migración de datos si se ha definido RealmConfiguration.Builder.deleteRealmIfMigrationNeeded().

Parámetros

• transaction - transaction to execute.

Sets the initial Subscription s for the io.realm.Realm . This will only be executed the first time the Realm file is opened (and the file created). If waitForInitialRemoteData() is configured as well, the realm file isn't fully opened until all subscription data also has been uploaded.

Parámetros

• action - MutableSubscriptionSet where subscriptions can be added.

Establece el número máximo de versiones activas en el archivo Realm antes de que se lance una IllegalStateException al intentar guardar más datos.

Realm is capable of concurrently handling many different versions of Realm objects. This can happen if you have a Realm open on many different threads or are freezing objects while data is being written to the file.

Under normal circumstances this is not a problem, but if the number of active versions grow too large, it will have a negative effect on the filesize on disk. Setting this parameters can therefore be used to prevent uses of Realm that can result in very large Realms.

Tenga en cuenta que el número de versión también aumentará cuando se integren cambios de otros dispositivos en este dispositivo, por lo que la cantidad de versiones activas también dependerá de lo que estén haciendo otros dispositivos que escriben en el mismo Realm.

Parámetros

• number - the maximum number of active versions before an exception is thrown.

Reemplaza los módulos existentes con uno o más RealmModule. Este método reemplaza el esquema actual de este dominio con el esquema definido por los módulos proporcionados.

A reference to the default Realm module containing all Realm classes in the project (but not dependencies), can be found using Realm.getDefaultModule() . Combining the schema from the app project and a library dependency is thus done using the following code:

builder.modules(Realm.getDefaultMode(), new MyLibraryModule());

Parámetros

• modules - list of modules tthe first Realm module (required).

Throws

• IllegalArgumentException - if any of the modules don't have the RealmModule annotation.

Reemplaza los módulos existentes con uno o más RealmModule. Este método reemplaza el esquema actual de este dominio con el esquema definido por los módulos proporcionados.

A reference to the default Realm module containing all Realm classes in the project (but not dependencies), can be found using Realm.getDefaultModule() . Combining the schema from the app project and a library dependency is thus done using the following code:

builder.modules(Realm.getDefaultMode(), new MyLibraryModule());

Parámetros

• baseModule - el primer módulo de Realm (obligatorio).

• additionalModules - los módulos adicionales de Realm

Throws

• IllegalArgumentException - if any of the modules don't have the RealmModule annotation.

Sets the filename for the Realm file on this device.

Parámetros

• filename - name for the Realm file.

Configurar esto hará que el Realm se vuelva de solo lectura y todas las transacciones de escritura realizadas contra este Realm fallarán con una IllegalStateException .

This in particular mean that initialData(Realm.Transaction) will not work in combination with a read only Realm and setting this will result in a IllegalStateException being thrown.

Marcar un dominio como de solo lectura solo se aplica al dominio en este proceso. Otros procesos y dispositivos aún pueden escribir en el dominio.

Establece la RxObservableFactory que se usa para crear Rx Observables a partir de objetos Realm. La fábrica por defecto es RealmObservableFactory .

Parámetros

• factory - fábrica a utilizar.

Establece la versión del esquema de Realm. Solo los Realms sincronizados admiten cambios aditivos en el esquema que pueden aplicarse sin requerir una migración manual. La versión del esquema solo se utilizará como una indicación para la capa de almacenamiento subyacente para remover o agregar índices. Estos serán recalculados si la versión del esquema proporcionada difiere de la versión en el archivo Realm. ADVERTENCIA: No se garantiza que el valor insertado aquí sea el mismo que retorna Realm.getVersion(). Debido a la naturaleza de los Realms sincronizados, el valor tanto puede ser superior como inferior.

• Será menor si otro cliente con un schemaVersion menor se conecta al servidor por primera vez después de que se utilizó esta schemaVersion.

• Será mayor si otro cliente con un schemaVersion más alto se conecta al servidor después de la creación de este Realm.

Parámetros

• schemaVersion - the schema version.

Throws

• IllegalArgumentException - if schema version is invalid.

Sets the handler for when a Client Reset occurs. If no handler is set, and error is logged when a Client Reset occurs. This strategy is only available for synced realms using partition based sync. Realms using flexible sync currently only support syncClientResetStrategy(ManuallyRecoverUnsyncedChangesStrategy) .

Parámetros

• handler - custom seamless loss handler in case of a Client Reset.

Establece el controlador para cuando se produce un reinicio del cliente. Si no se configura ningún controlador, se registra un error al reiniciar el cliente.

Parámetros

• handler - custom manual handler in case of a Client Reset.

The prefix that is prepended to the path in the WebSocket request that initiates a sync connection to MongoDB Realm. The value specified must match the server’s configuration otherwise the device will not be able to create a connection. This value is optional and should only be set if a specific firewall rule requires it.

Parámetros

• urlPrefix - The prefix to append to the sync connection url.

Al configurar esto, Realm descargará todos los cambios conocidos del servidor la primera vez que se abra. Realm no se abrirá hasta que se hayan descargado todos los datos. Esto significa que, si un dispositivo está sin conexión, Realm no se abrirá. Dado que descargar todos los cambios puede ser una operación larga que podría bloquear el hilo de la interfaz de usuario, los Realms con esta configuración habilitada solo deben abrirse en hilos en segundo plano o con Realm.getInstanceAsync(RealmConfiguration, Realm.Callback) en el hilo de la interfaz de usuario.

This check is only enforced the first time a Realm is created. If you otherwise want to make sure a Realm has the latest changes, use SyncSession.downloadAllServerChanges() .

Parámetros

• timeout - cuánto tiempo esperar para que la descarga se complete antes de que se genere una io.realm.exceptions.DownloadingRealmInterruptedException.

• unit - la unidad de tiempo utilizada para definir el tiempo de espera.

Al configurar esto, Realm descargará todos los cambios conocidos del servidor la primera vez que se abra. Realm no se abrirá hasta que se hayan descargado todos los datos. Esto significa que, si un dispositivo está sin conexión, Realm no se abrirá. Dado que descargar todos los cambios puede ser una operación larga que podría bloquear el hilo de la interfaz de usuario, los Realms con esta configuración habilitada solo deben abrirse en hilos en segundo plano o con Realm.getInstanceAsync(RealmConfiguration, Realm.Callback) en el hilo de la interfaz de usuario.

This check is only enforced the first time a Realm is created. If you otherwise want to make sure a Realm has the latest changes, use SyncSession.downloadAllServerChanges() .