Class DynamicRealm

Adds a change listener to the Realm.The listeners will be executed when changes are committed by this or another thread.

Realm instances are cached per thread. For that reason it is important to remember to remove listeners again either using removeChangeListener(RealmChangeListener) or removeAllChangeListeners() . Not doing so can cause memory leaks.

Parámetros

• listener - the change listener.

Throws

• IllegalArgumentException - if the change listener is null .

Returns an RxJava Flowable that monitors changes to this Realm. It will emit the current state when subscribed to. Items will continually be emitted as the Realm is updated - onComplete will never be called.

Los elementos emitidos por Realm Flowables están congelados (consulta freeze()). Esto significa que son inmutables y pueden ser leídos en cualquier subproceso.

Realm Flowables always emit items from the thread holding the live Realm. This means that if you need to do further processing, it is recommend to observe the values on a computation scheduler:

realm.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxRealm -> doExpensiveWork(rxRealm))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

If you would like the asFlowable() to stop emitting items, you can instruct RxJava to only emit only the first item by using the first() operator:

realm.asFlowable().first().subscribe( ... ); // You only get the results once

Devuelve

RxJava Observable that only calls onNext . It will never call onComplete or OnError .

Anulaciones

asFlowable in class BaseRealm

Instantiates and adds a new embedded object to the Realm.This method should only be used to create objects of types marked as embedded.

Parámetros

• className - the class name of the object to create.

• parentObject - El objeto principal que debe tener una referencia al objeto incrustado. Si la propiedad principal es una lista, el objeto incrustado se añadirá al final de esa lista.

• parentProperty - the property in the parent class which holds the reference.

Devuelve

the newly created embedded object.

Throws

• IllegalArgumentException - si clazz no es una clase embebida o si la propiedad de la clase padre no puede contener objetos del tipo adecuado.

Creates an object with a given primary key. Classes without a primary key defined must use createObject(String) } instead.

Devuelve

el nuevo objeto. Todos los campos tendrán valores por defecto para su tipo, excepto el campo de llave primaria que tendrá el valor proporcionado.

Throws

• RealmException - if object could not be created due to the primary key being invalid.

• IllegalStateException - if the model clazz does not have a primary key defined.

• IllegalArgumentException - si el primaryKeyValue no tiene un valor que pueda convertirse al valor esperado.

Instantiates and adds a new object to the Realm.

Parámetros

• className - the class name of the object to create.

Devuelve

the new object.

Throws

• RealmException - si no se pudo crear el objeto.

Deletes all objects of the specified class from the Realm.

Parámetros

• className - the class for which all objects should be removed.

Throws

• IllegalStateException - if the Realm is closed or called from an incorrect thread.

Executes a given transaction on the DynamicRealm. beginTransaction() and commitTransaction() will be called automatically. If any exception is thrown during the transaction cancelTransaction() will be called instead of commitTransaction().

Calling this method from the UI thread will throw a RealmException . Doing so may result in a drop of frames or even ANRs. We recommend calling this method from a non-UI thread or using executeTransactionAsync(Transaction) instead.

Parámetros

• transaction - Transaction to execute.

Throws

• IllegalArgumentException - if the transaction is null .

• RealmException - si se llama desde el hilo de la Interfaz de Usuario, a menos que se haya declarado una suscripción explícita en RealmConfiguration.Builder.allowWritesOnUiThread(boolean) .

Similar to executeTransactionAsync(Transaction) , but also accepts an OnSuccess and OnError callbacks.

Parámetros

• transaction - Transaction to execute.

• onSuccess - callback invoked when the transaction succeeds.

• onError - función de retorno invocada cuando la transacción falla.

Devuelve

un RealmAsyncTask que representa una tarea cancelable.

Throws

• IllegalArgumentException - if the transaction is null , or if the realm is opened from another thread.

Similar to executeTransactionAsync(Transaction) , but also accepts an OnError callback.

Parámetros

• transaction - Transaction to execute.

• onError - función de retorno invocada cuando la transacción falla.

Devuelve

un RealmAsyncTask que representa una tarea cancelable.

Throws

• IllegalArgumentException - if the transaction is null , or if the realm is opened from another thread.

Similar to executeTransactionAsync(Transaction) , but also accepts an OnSuccess callback.

Parámetros

• transaction - Transaction to execute.

• onSuccess - callback invoked when the transaction succeeds.

Devuelve

un RealmAsyncTask que representa una tarea cancelable.

Throws

• IllegalArgumentException - if the transaction is null , or if the realm is opened from another thread.

Similar to executeTransaction(Transaction) but runs asynchronously on a worker thread.

Parámetros

• transaction - Transaction to execute.

Devuelve

un RealmAsyncTask que representa una tarea cancelable.

Throws

• IllegalArgumentException - si el transaction es null , o si el Realm se abrió desde otro hilo.

Returns a frozen snapshot of the current Realm. This Realm can be read and queried from any thread without throwing an IllegalStateException . A frozen Realm has its own lifecycle and can be closed by calling close(), but fully closing the Realm that spawned the frozen copy will also close the frozen Realm.

Frozen data can be queried as normal, but trying to mutate it in any way or attempting to register any listener will throw an IllegalStateException .

Nota: Mantener un gran número de Realms con diferentes versiones vivos puede tener un impacto negativo en el tamaño del archivo del Realm. Para evitar una situación así, es posible establecer RealmConfiguration.Builder.maxNumberOfActiveVersions(long) .

Devuelve

a frozen copy of this Realm.

Anulaciones

freeze in class BaseRealm

Realm static constructor that returns a dynamic variant of the Realm instance defined by provided io.realm.RealmConfiguration . Dynamic Realms do not care about schemaVersion and schemas, so opening a DynamicRealm will never trigger a migration.

Devuelve

el DynamicRealm definido por la configuración.

Throws

• RealmFileException - if an error happened when accessing the underlying Realm file.

• IllegalArgumentException - si el argumento configuration es null .

The creation of the first Realm instance per RealmConfiguration in a process can take some time as all initialization code need to run at that point (Setting up the Realm, validating schemas and creating initial data). This method places the initialization work in a background thread and deliver the Realm instance to the caller thread asynchronously after the initialization is finished.

Parámetros

• configuration - RealmConfiguration used to open the Realm.

• callback - invoked to return the results.

Devuelve

un RealmAsyncTask que representa una tarea cancelable.

Throws

• IllegalArgumentException - if a null RealmConfiguration or a null Callback is provided.

• IllegalStateException - if it is called from a non-Looper or android.app.IntentService thread.

Returns the mutable schema for this Realm.

Devuelve

The RealmSchema for this Realm.

Anulaciones

getSchema in class BaseRealm

Checks if this io.realm.Realm contains any objects.

Devuelve

true if empty, @{code false} otherwise.

Anulaciones

isEmpty in class BaseRealm

Removes all user-defined change listeners.

Throws

• IllegalStateException - if you try to remove listeners from a non-Looper Thread.

Removes the specified change listener.

Parámetros

• listener - the change listener to be removed.

Throws

• IllegalArgumentException - if the change listener is null .

• IllegalStateException - if you try to remove a listener from a non-Looper Thread.

Returns a RealmQuery, which can be used to query the provided class.

Parámetros

• className - the class of the object which is to be queried.

Devuelve

a RealmQuery, which can be used to query for specific objects of provided type.

Throws

• IllegalArgumentException - if the class doesn't exist.