Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /
io.realm

Realms Migration de la interfaz

The RealmMigration class is used to perform the migration of one Realm schema to another. The schema for a Realm is defined by all classes in a project that extend io.realm.RealmObject or implement io.realm.RealmModel , so any changes to these classes will require a migration.

Para admitir migraciones de cualquier versión de esquema anterior a la más reciente, se recomienda el siguiente patrón al escribir una migración:

public class CustomMigration implements RealmMigration {
@Override
public long migrate(DynamicRealm realm, long oldVersion, long newVersion) {
RealmSchema schema = realm.getSchema();
if (oldVersion == 0) {
// Migrate from v0 to v1
oldVersion++;
}
if (oldVersion == 1) {
// Migrate from v1 to v2
oldVersion++;
}
if (oldVersion < newVersion) {
throw new IllegalStateException(String.format(Locale.US, "Migration missing from v%d to v%d", oldVersion, newVersion));
}
}
}

Durante el desarrollo, cuando las clases de RealmObject pueden cambiar con frecuencia, es posible utilizar io.realm.Realm.deleteRealm(RealmConfiguration) . Esto eliminará el archivo de la base de datos y eliminará la necesidad de cualquier migración.

Tip

Modificador y Tipo
Método y descripción

public void

long oldVersion,
long newVersion
)

This method will be called if a migration is needed.

public void migrate (
long oldVersion,
long newVersion
)

Este método se llamará si se necesita una migración. El método completo está envuelto en una transacción de escritura, por lo que es posible crear, actualizar o borrar cualquier objeto existente sin encapsularlo en tu propia transacción.

Parámetros

  • realm - the Realm schema on which to perform the migration.

  • oldVersion - la versión del esquema del Realm al comienzo de la migración.

  • newVersion - la versión del esquema de Realm tras ejecutar la migración.

Volver

RealmMap

En esta página