Lista de reinos de clase

Agrega el objeto especificado al final de esta lista.

1. Listas de dominios no administradas: Es posible agregar objetos administrados y no administrados. Si se agregan objetos administrados a una lista de dominios no administrada, no se volverán a copiar al dominio si se usa posteriormente Realm.copyToRealm(RealmModel, ImportFlag...).

2. Listas de dominios administradas: Es posible agregar objetos no administrados a una lista de dominios ya administrada. En ese caso, el objeto se copiará de forma transparente a Realm mediante Realm.copyToRealm(RealmModel, ImportFlag...) o Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) si tiene una clave principal.

Parámetros

• object - el objeto a agregar.

Devuelve

siempre true .

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

Anulaciones

add en la clase AbstractList

Inserta el objeto especificado en esta lista, en la ubicación indicada. El objeto se inserta antes de cualquier elemento anterior en la ubicación indicada. Si la ubicación es igual al tamaño de esta lista, el objeto se añade al final.

1. Listas de dominios no administradas: Es posible agregar objetos administrados y no administrados. Si se agregan objetos administrados a una lista de dominios no administrada, no se volverán a copiar al dominio si se usa posteriormente Realm.copyToRealm(RealmModel, ImportFlag...).

2. Listas de dominios administradas: Es posible agregar objetos no administrados a una lista de dominios ya administrada. En ese caso, el objeto se copiará de forma transparente a Realm mediante Realm.copyToRealm(RealmModel, ImportFlag...) o Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) si tiene una clave principal.

Parámetros

• location - el índice en el que insertar.

• element - el elemento a agregar.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto contenedor.

• IndexOutOfBoundsException - if location < 0 || location > size() .

Anulaciones

add en la clase AbstractList

Agrega un detector de cambios a esta RealmList.

Registrar un detector de cambios no impedirá que la RealmList subyacente sea objeto de recolección de basura. Si se realiza la recolección de basura de la RealmList, el detector de cambios dejará de activarse. Para evitar esto, mantenga una referencia fuerte durante el tiempo que sea necesario, por ejemplo, en una variable de clase.

public class MyActivity extends Activity {
    private RealmList<Dog> dogs; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      dogs = realm.where(Person.class).findFirst().getDogs();
      dogs.addChangeListener(new RealmChangeListener<RealmList<Dog>>() {
          @Override
          public void onChange(RealmList<Dog> dogs) {
              // React to change
          }
      });
    }
}

Parámetros

• listener - el oyente de cambios que debe ser notificado.

Lanzamientos

• IllegalArgumentException: si el detector de cambios null es.

• IllegalStateException: si intenta agregar un oyente desde un hilo que no sea Looper o android.app.IntentService.

Agrega un detector de cambios a esta RealmList.

Registrar un detector de cambios no impedirá que la RealmList subyacente sea objeto de recolección de basura. Si se realiza la recolección de basura de la RealmList, el detector de cambios dejará de activarse. Para evitar esto, mantenga una referencia fuerte durante el tiempo que sea necesario, por ejemplo, en una variable de clase.

public class MyActivity extends Activity {
    private RealmList<Dog> dogs; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      dogs = realm.where(Person.class).findFirst().getDogs();
      dogs.addChangeListener(new OrderedRealmCollectionChangeListener<RealmList<Dog>>() {
          @Override
          public void onChange(RealmList<Dog> dogs, OrderedCollectionChangeSet changeSet) {
              // React to change
          }
      });
    }
}

Parámetros

• listener - el oyente de cambios que debe ser notificado.

Lanzamientos

• IllegalArgumentException: si el detector de cambios null es.

• IllegalStateException: si intenta agregar un oyente desde un hilo que no sea Looper o android.app.IntentService.

Devuelve un Observable Rx que monitoriza los cambios en esta RealmList. Emitirá la RealmList actual al suscribirse. Por cada actualización de la RealmList, se enviará un par compuesto por la RealmList y el OrderedCollectionChangeSet. El conjunto de cambios será null la primera vez que se emita una RealmList.

RealmList se emitirá continuamente a medida que se actualice RealmList: onComplete nunca se llamará.

Los elementos emitidos desde los Observables de Realm están congelados (ver freeze()). Esto significa que son inmutables y se pueden leer en cualquier hilo.

Los observables de Realm siempre emiten elementos desde el hilo que contiene el Realm activo. Esto significa que, si necesita realizar más procesamiento, se recomienda observar los valores en un programador de cómputo:

list.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxList, changes) -> doExpensiveWork(rxList, changes))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

Devuelve

Observable de RxJava que solo llama a onNext . Nunca llamará a onComplete ni a OnError .

Lanzamientos

• UnsupportedOperationException: si el marco RxJava requerido no está en la ruta de clase o la instancia de Realm correspondiente no admite RxJava.

• IllegalStateException: si el reino no se abrió en un hilo de Looper.

Devuelve un Rx Flowable que monitoriza los cambios en esta RealmList. Emitirá la RealmList actual al suscribirse. RealmList se emitirá continuamente a medida que se actualice; nunca se llamará a onComplete.

Los elementos emitidos desde Realm Flowables están congelados (ver freeze()). Esto significa que son inmutables y se pueden leer en cualquier hilo.

Los flujos de Realm siempre emiten elementos desde el hilo que contiene la RealmList activa. Esto significa que, si necesita realizar más procesamiento, se recomienda observar los valores en un programador de cálculos:

list.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxResults -> doExpensiveWork(rxResults))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

Si desea que asFlowable() deje de emitir elementos, puede indicarle a RxJava que solo emita el primer elemento utilizando el operador first():

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

Devuelve

Observable de RxJava que solo llama a onNext . Nunca llamará a onComplete ni a OnError .

Lanzamientos

• UnsupportedOperationException: si el marco RxJava requerido no está en la ruta de clase o la instancia de Realm correspondiente no admite RxJava.

Devuelve el promedio de un campo dado.

Devuelve

el promedio del campo indicado entre los objetos de los resultados de la query. Esto será del tipo double para todos los campos de tipo numérico. Si no existen objetos o todos tienen null como valor para el campo dado, 0 será devuelto. Al calcular el promedio, se ignoran los objetos con valores null.

Elimina todos los elementos de esta lista, dejándola vacía. Este método no elimina los objetos del dominio.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

Anulaciones

clear en la clase AbstractList

Devuelve true si la lista contiene el elemento especificado al asociarse a un dominio. Este método consultará el motor de almacenamiento nativo subyacente del dominio para encontrar rápidamente el elemento especificado.

Si la lista no está asociada a un Reino, se realizará la implementación predeterminada de List.contains(Object).

Parámetros

• object - el elemento cuya presencia en esta lista se va a comprobar.

Devuelve

true si esta lista contiene el elemento especificado; de lo contrario, false .

Anulaciones

contains en la clase AbstractCollection

Crea una instantánea de esta OrderedRealmCollection.

Devuelve

La instantánea de esta colección.

Esto elimina todos los objetos de la colección, tanto del reino subyacente como de la colección.

Devuelve

true Si se eliminaron objetos, false en caso contrario.

Elimina el primer objeto del dominio. Esto también lo elimina de esta colección.

Devuelve

true si se eliminó un objeto, false en caso contrario.

Elimina el objeto en el índice dado del dominio. Esto también lo elimina de la colección.

Elimina el último objeto del dominio. Esto también lo elimina de esta colección.

Devuelve

true si se eliminó un objeto, false en caso contrario.

Obtiene el primer objeto de la colección. Si la colección está vacía, se usará el valor predeterminado proporcionado.

Devuelve

el primer objeto o el predeterminado proporcionado.

Obtiene el primer objeto de la colección.

Devuelve

El primer objeto.

Devuelve el elemento en la ubicación especificada en esta lista.

Parámetros

• location - el índice del elemento a devolver.

Devuelve

el elemento en el índice especificado.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

• IndexOutOfBoundsException - if location < 0 || location >= size() .

Anulaciones

get en la clase AbstractList

Devuelve la instancia de Realm a la que pertenece esta colección.

No se recomienda llamar a Realm.close() en la instancia devuelta, ya que es lo mismo que llamarlo en la instancia de Realm original, lo que puede provocar que Realm se cierre por completo e invalide la lista.

Devuelve

Instancia de reino a la que pertenece esta colección o null si la colección no está administrada.

Lanzamientos

• IllegalStateException: si el Reino es una instancia de DynamicRealm o el Reino ya estaba cerrado.

Comprueba si una colección ya ha terminado de cargar sus datos.

Devuelve

true si se han cargado los datos y están disponibles, false si todavía se están cargando los datos.

Comprueba si la colección está administrada por Realm. Una colección administrada es simplemente un contenedor de los datos del archivo Realm subyacente. En los subprocesos de Looper, una colección administrada se actualiza en tiempo real para que siempre apunte a los datos más recientes. Las colecciones administradas están confinadas en el subproceso, por lo que no se puede acceder a ellas desde otros subprocesos que no sean el que las creó. Si este método devuelve false , la colección no está administrada. Una colección no administrada es simplemente una colección Java normal, por lo que no se actualiza en tiempo real.

Devuelve

true si se trata de una RealmCollection administrada, en casofalse contrario.

Comprueba si la colección sigue siendo válida, es decir, si la instancia io.realm.Realm no se ha cerrado. Siempre devolverá true para una colección no administrada.

Devuelve

true si aún es válido para usar o es una colección no administrada, false en caso contrario.

Anulaciones

iterator en la clase AbstractList

Obtiene el último objeto de la colección. Si la colección está vacía, se usará el valor predeterminado proporcionado.

Devuelve

el último objeto o el predeterminado proporcionado.

Obtiene el último objeto de la colección.

Devuelve

El último objeto.

Anulaciones

listIterator en la clase AbstractList

Anulaciones

listIterator en la clase AbstractList

Bloquea la recopilación hasta que todos los datos estén disponibles.

Devuelve

true si los datos se pudieran cargar correctamente, false de lo contrario.

Encuentra el valor máximo de un campo.

Devuelve

Si no existen objetos o todos tienen null como valor para el campo dado, se devolverá null. De lo contrario, se devolverá el valor máximo. Al determinar el valor máximo, se ignoran los objetos con valores null.

Encuentra la fecha máxima.

Devuelve

Si no existen objetos o si todos tienen null como valor para el campo de fecha dado, se devolverá null. De lo contrario, se devuelve la fecha máxima. Al determinar la fecha máxima, los objetos con valores null se ignoran.

Encuentra el valor mínimo de un campo.

Devuelve

si no existen objetos o todos tienen null como valor para el campo dado, se devolverá null. De lo contrario, se devuelve el valor mínimo. Al determinar el valor mínimo, se ignoran los objetos con valores null.

Encuentra la fecha mínima.

Devuelve

Si no existen objetos o todos tienen null como valor para el campo de fecha dado, se devolverá null. De lo contrario, se devolverá la fecha mínima. Al determinar la fecha mínima, se ignoran los objetos con valores null.

Mueve un objeto de una posición a otra, manteniendo una lista de tamaño fijo. Los objetos Realm se desplazarán para que no se introduzcan valores null.

Parámetros

• oldPos - índice de RealmObject a mover.

• newPos - Posición objetivo. Si newPos < oldPos, el objeto en la ubicación se desplazará a la derecha. Si oldPos < newPos, los índices > oldPos se desplazarán una vez a la izquierda.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

• java.lang.IndexOutOfBoundsException: si alguna posición está fuera de0 [, tamaño()].

Elimina una instancia del objeto especificado de este Collection si contiene una. Esta implementación itera sobre este Collection y comprueba cada elemento e devuelto por el iterador para determinar si e es igual al objeto dado. Si es object != null, esta comprobación se realiza mediante object.equals(e) ; de lo contrario, mediante object == null . Si se encuentra un elemento igual al objeto dado, se llama al método remove en el iterador y se devuelve true; en caso contrario, se devuelve false. Si el iterador no admite la eliminación de elementos, se lanza un UnsupportedOperationException.

Parámetros

• object - el objeto a eliminar.

Devuelve

true si se modifica este Collection, false en caso contrario.

Lanzamientos

• ClassCastException: si el objeto pasado no es del tipo correcto.

• NullPointerException: object si null es.

Anulaciones

remove en la clase AbstractCollection

Elimina el objeto en la ubicación especificada de esta lista.

Parámetros

• location - el índice del objeto a eliminar.

Devuelve

el objeto eliminado.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

• IndexOutOfBoundsException - if location < 0 || location >= size() .

Anulaciones

remove en la clase AbstractList

Elimina todas las ocurrencias en este Collection de cada objeto en el Collection ​​especificado. Después de que este método retorna, ninguno de los elementos en el Collection pasado se puede encontrar en este Collection.

Esta implementación itera sobre Collection y comprueba si cada elemento e devuelto por el iterador está contenido en el Collection especificado. Si la prueba es positiva, se llama al método remove en el iterador.

Parámetros

• collection - la colección de objetos a eliminar.

Devuelve

true si se modifica este Collection, false en caso contrario.

Lanzamientos

• ClassCastException: si uno o más elementos de no collection son del tipo correcto.

• NullPointerException: collection si null es.

Anulaciones

removeAll en la clase AbstractCollection

Elimina todos los escuchas de cambios definidos por el usuario.

Lanzamientos

• IllegalStateException: si intenta eliminar oyentes de un subproceso que no es Looper.

Elimina el detector de cambios especificado.

Parámetros

• listener - el detector de cambios que se eliminará.

Lanzamientos

• IllegalArgumentException: si el detector de cambios null es.

• IllegalStateException: si intenta eliminar un oyente de un subproceso que no es Looper.

Elimina el detector de cambios especificado.

Parámetros

• listener - el detector de cambios que se eliminará.

Lanzamientos

• IllegalArgumentException: si el detector de cambios null es.

• IllegalStateException: si intenta eliminar un oyente de un subproceso que no es Looper.

Reemplaza el elemento en la ubicación especificada en esta lista con el objeto especificado.

1. Listas de dominios no administradas: Es posible agregar objetos administrados y no administrados. Si se agregan objetos administrados a una lista de dominios no administrada, no se volverán a copiar al dominio si se usa posteriormente Realm.copyToRealm(RealmModel, ImportFlag...).

2. Listas de dominios administradas: Es posible agregar objetos no administrados a una lista de dominios ya administrada. En ese caso, el objeto se copiará de forma transparente a Realm mediante Realm.copyToRealm(RealmModel, ImportFlag...) o Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) si tiene una clave principal.

Parámetros

• location - el índice en el que colocar el objeto especificado.

• object - el objeto a agregar.

Devuelve

el elemento anterior en el índice.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

• IndexOutOfBoundsException - if location < 0 || location >= size() .

Anulaciones

set en la clase AbstractList

Devuelve el número de elementos en este List .

Devuelve

El número de elementos en este List .

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.

Anulaciones

size en la clase AbstractCollection

Ordena una colección en función de los campos y órdenes de clasificación enviados.

Devuelve

Se creará y devolverá un nuevo RealmResults ordenado. La colección original permanece intacta.

Ordena una colección en función de los campos y órdenes de clasificación enviados.

Devuelve

Se creará y devolverá un nuevo RealmResults ordenado. La colección original permanece intacta.

Ordena una colección según el campo proporcionado y el orden de clasificación.

Devuelve

Se creará y devolverá un nuevo RealmResults ordenado. La colección original permanece intacta.

Ordena una colección según el campo proporcionado en orden ascendente.

Devuelve

Se creará y devolverá un nuevo RealmResults ordenado. La colección original permanece intacta.

Calcula la suma de un campo dado.

Devuelve

La suma. Si no existen objetos o todos tienen null como valor para el campo dado, se devolverá 0. Al calcular la suma, se ignoran los objetos con valores null.

Anulaciones

toString en la clase AbstractCollection

Devuelve un RealmQuery, que se puede utilizar para consultar objetos específicos de esta clase.

Devuelve

un objeto RealmQuery.

Lanzamientos

• IllegalStateException: si se ha cerrado la instancia de Realm o se ha eliminado el objeto principal.