Docs Menu
Docs Home
/ /
io.realm

Clase RealmQuery

java.lang.Object
io.realm.RealmQuery

Una RealmQuery encapsula una query en un io.realm.realm o un io.realm.RealmResults utilizando el patrón Builder. La consulta se ejecuta usando findAll() o findFirst() .

La entrada de muchas funciones de consulta toma un nombre de campo como String. Tenga en cuenta que esto no es seguro para tipos. Si se refactoriza una clase RealmObject, se debe tener cuidado de no interrumpir ninguna consulta.

Un io.realm.Realm no está ordenado, lo que significa que no hay garantía de que al consultar un Realm se devuelvan los objetos en el orden en que se insertaron. Utilice sort(String) (String)} y métodos similares si se requiere un orden específico.

No se puede pasar un RealmQuery entre diferentes subprocesos.

La mayoría de las veces, los resultados se obtienen rápidamente. Sin embargo, ejecutar consultas pesadas desde el hilo de la interfaz de usuario puede provocar una pérdida de fotogramas o incluso ANR. Para evitar estos comportamientos, puede instanciar un dominio usando una RealmConfiguration que establezca explícitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) en false De esta forma, las consultas se verán obligadas a iniciarse desde un hilo que no sea de interfaz de usuario. Como alternativa, también puede usar findAllAsync() o findFirstAsync().

Tip

Modificador y Tipo
Método y descripción

Este predicado nunca coincidirá, resultando en que la query siempre devuelva 0 resultados.

Este predicado siempre coincidirá.

and ()

Condiciones lógicas y dos condiciones Realm aplica automáticamente las condiciones lógicas y dos condiciones entre todas las declaraciones de consulta, por lo que esto está pensado únicamente como un medio para aumentar la legibilidad.

doble público

String fieldName
)

Devuelve el promedio de un campo dado.

Decimal128público

Devuelve el promedio de un campo dado.

Decimal128público

Devuelve el promedio de un campo dado.

Comenzar a agrupar condiciones ("paréntesis izquierdo").

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo comience con la subcadena especificada.

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo comience con la subcadena especificada.

String fieldName,
RealmAny value
)

Condición de que el valor del campo comience con la cadena especificada.

String fieldName,
String value
)

Condición de que el valor del campo comience con la cadena especificada.

String fieldName,
Decimal128 from,
Decimal128 to
)

Entre condiciones.

String fieldName,
RealmAny from,
)

Entre condiciones.

String fieldName,
Date from,
Date to
)

Entre condiciones.

String fieldName,
float from,
float to
)

Entre condiciones.

String fieldName,
double from,
double to
)

Entre condiciones.

String fieldName,
long from,
long to
)

Entre condiciones.

String fieldName,
int from,
int to
)

Entre condiciones.

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo contenga la subcadena especificada.

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo contenga la subcadena especificada.

String fieldName,
RealmAny value
)

Condición de que el valor del campo contenga la subcadena especificada.

String fieldName,
String value
)

Condición de que el valor del campo contenga la subcadena especificada.

Condición de que el valor, si es un campo de diccionario, contenga la entrada especificada.

String fieldName,
String key
)

Condición de que el valor, si es un campo de diccionario, contenga la clave especificada.

String fieldName,
ObjectId value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Decimal128 value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Date value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
byte[] value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
String value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Float value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Double value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Long value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Integer value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Short value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Byte value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

String fieldName,
Boolean value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

public long

Cuenta el número de objetos que cumplen las condiciones de consulta.

String firstFieldName,
java.lang.String[] remainingFieldNames
)

Selecciona un conjunto distinto de objetos de una clase específica.

Finaliza la agrupación de condiciones ("paréntesis derecho") que se abrió mediante una llamada a beginGroup() .

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo termine con la subcadena especificada.

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo termine con la subcadena especificada.

String fieldName,
RealmAny value
)

Condición de que el valor del campo termine con la cadena especificada.

String fieldName,
String value
)

Condición de que el valor del campo termine con la cadena especificada.

String fieldName,
ObjectId value
)

Comparación de igualdad.

String fieldName,
Decimal128 value
)

Comparación de igualdad.

String fieldName,
RealmAny value,
Case casing
)

Comparación de igualdad.

String fieldName,
String value,
Case casing
)

Comparación de igualdad.

String fieldName,
String value
)

Comparación de igualdad.

Encuentra todos los objetos que cumplen las condiciones de la query.

Encuentra todos los objetos que cumplen las condiciones de la query.

público E

Encuentra el primer objeto que cumple las condiciones de la consulta.

público E

Similar a findFirst() pero se ejecuta de forma asincrónica en un hilo de trabajo.

Devuelve una descripción textual de esta consulta.

public long

Devuelve el puntero a la consulta C++ subyacente.

public Realm

Devuelve la instancia de Realm a la que pertenece esta consulta.

Devuelve el nombre del reino interno del tipo que se está consultando.

String fieldName,
ObjectId value
)

Comparación mayor que.

String fieldName,
Decimal128 value
)

Comparación mayor que.

String fieldName,
RealmAny value
)

Comparación mayor que.

String fieldName,
Date value
)

Comparación mayor que.

String fieldName,
float value
)

Comparación mayor que.

String fieldName,
double value
)

Comparación mayor que.

String fieldName,
long value
)

Comparación mayor que.

String fieldName,
int value
)

Comparación mayor que.

String fieldName,
ObjectId value
)

Comparación de mayor o igual a.

String fieldName,
Decimal128 value
)

Comparación de mayor o igual a.

String fieldName,
Date value
)

Comparación de mayor o igual a.

String fieldName,
float value
)

Comparación de mayor o igual a.

String fieldName,
double value
)

Comparación de mayor o igual a.

String fieldName,
long value
)

Comparación de mayor o igual a.

String fieldName,
int value
)

Comparación de mayor o igual a.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
)

En comparación.

in (
String fieldName,
Case casing
)

En comparación.

in (
String fieldName,
)

En comparación.

String fieldName
)

Condición que encuentra valores que se consideran "vacíos", es decir, una lista vacía, una cadena de longitud 0o una matriz de bytes.

String fieldName
)

Condición que encuentra valores que se consideran "No vacíos", es decir, una lista, una cadena o una matriz de bytes con valores no vacíos.

String fieldName
)

Comprueba si un campo no es null .

String fieldName
)

Comprueba si un campo es null .

booleanopúblico

Comprueba si io.realm.RealmQuery sigue siendo válido para su uso, es decir, que la instancia Realm no ha sido cerrada y cualquier io.realm.RealmResults principal sigue siendo válido.

String fieldName,
ObjectId value
)

Comparación inferior.

String fieldName,
Decimal128 value
)

Comparación inferior.

String fieldName,
long value
)

Comparación inferior.

String fieldName,
int value
)

Comparación inferior.

String fieldName,
ObjectId value
)

Comparación menor o igual a.

String fieldName,
Decimal128 value
)

Comparación menor o igual a.

String fieldName,
long value
)

Comparación menor o igual a.

String fieldName,
int value
)

Comparación menor o igual a.

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

String fieldName,
String value,
Case casing
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

String fieldName,
RealmAny value
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

String fieldName,
String value
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

long limit
)

Limita la cantidad de objetos devueltos en caso de que la consulta coincida con más objetos.

Númeropúblico

max (
String fieldName
)

Encuentra el valor máximo de un campo.

público RealmAny

String fieldName
)

Encuentra el valor máximo de un campo RealmAny.

String fieldName
)

Encuentra el valor máximo de un campo.

Númeropúblico

min (
String fieldName
)

Encuentra el valor mínimo de un campo.

público RealmAny

String fieldName
)

Encuentra el valor mínimo de un campo RealmAny.

String fieldName
)

Encuentra el valor mínimo de un campo.

not ()

Negar condición.

String fieldName,
ObjectId value
)

Comparación no igual a.

String fieldName,
Decimal128 value
)

Comparación no igual a.

String fieldName,
RealmAny value,
Case casing
)

Comparación no igual a.

String fieldName,
String value,
Case casing
)

Comparación no igual a.

String fieldName,
String value
)

Comparación no igual a.

or ()

Lógico-o dos condiciones.

String predicate,
)

Cree un predicado basado en texto utilizando el lenguaje de consulta Realm.

java.lang.String[] fieldNames,
io.realm.Sort[] sortOrders
)

Ordena el resultado de la consulta por los nombres de campo específicos en los órdenes proporcionados.

String fieldName1,
Sort sortOrder1,
String fieldName2,
Sort sortOrder2
)

Ordena el resultado de la consulta por los nombres de campo específicos en los órdenes proporcionados.

String fieldName,
Sort sortOrder
)

Ordena el resultado de la consulta por el nombre de campo y el orden especificados.

String fieldName
)

Ordena el resultado de la consulta por el nombre del campo específico en orden ascendente.

Númeropúblico

sum (
String fieldName
)

Calcula la suma de un campo dado.

  • Métodos heredados de la clase getClasshashCodeequalsclonetoStringnotifynotifyAllwaitwaitwaitjava.lang.Object:,,,,,,,,,, finalize

Este predicado nunca coincidirá, resultando en que la query siempre devuelva 0 resultados.

Este predicado siempre coincidirá.

public RealmQuery and ()

Condiciones lógicas y dos condiciones Realm aplica automáticamente las condiciones lógicas y dos condiciones entre todas las declaraciones de consulta, por lo que esto está pensado únicamente como un medio para aumentar la legibilidad.

Devuelve

el objeto de consulta

public double average (
String fieldName
)

Devuelve el promedio de un campo determinado. No admite la notación de campos con puntos.

Parámetros

  • fieldName - Campo para calcular el promedio. Solo se admiten campos numéricos.

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.

Lanzamientos

public Decimal128 averageDecimal128 (
String fieldName
)

Devuelve el promedio de un campo determinado. No admite la notación de campos con puntos.

Parámetros

  • fieldName - El campo para calcular el promedio. Solo128 se admiten campos decimales. Para otros tipos de números, considere usar average(String).

Devuelve

El promedio del campo dado entre los objetos en los resultados de la consulta. Este será de tipo decimal128. Si no existen objetos o todos tienen null como valor para el campo dado, se devolverá 0. Al calcular el promedio, se ignoran los objetos con valores null.

Lanzamientos

public Decimal128 averageRealmAny (
String fieldName
)

Devuelve el promedio de un campo determinado. No admite la notación de campos con puntos.

Parámetros

  • fieldName - El campo para calcular el promedio. Solo se admiten campos RealmAny. Para otros tipos, considere usar average(String).

Devuelve

El promedio del campo dado entre los objetos en los resultados de la consulta. Este será de tipo decimal128. Si no existen objetos o todos tienen null como valor para el campo dado, se devolverá 0. Al calcular el promedio, se ignoran los objetos con valores null.

Lanzamientos

Comienza el agrupamiento de condiciones ("paréntesis izquierdo"). Un grupo debe cerrarse con una llamada a endGroup() .

Devuelve

el objeto de consulta.

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo comience con la subcadena especificada.

Parámetros

Devuelve

el objeto de consulta

Lanzamientos

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo comience con la subcadena especificada.

Parámetros

Devuelve

el objeto de consulta

Lanzamientos

String fieldName,
RealmAny value
)

Condición de que el valor del campo comience con la cadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cuerda.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Condición de que el valor del campo comience con la cadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cuerda.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 from,
Decimal128 to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny from,
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Date from,
Date to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
float from,
float to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
double from,
double to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
long from,
long to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
int from,
int to
)

Entre condiciones.

Parámetros

  • fieldName - el campo a comparar.

  • from - valor más bajo (inclusive).

  • to - valor más alto (inclusive).

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo contenga la subcadena especificada.

Parámetros

Devuelve

El objeto de consulta.

Lanzamientos

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo contenga la subcadena especificada.

Parámetros

Devuelve

El objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value
)

Condición de que el valor del campo contenga la subcadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la subcadena.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Condición de que el valor del campo contenga la subcadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la subcadena.

Devuelve

el objeto de consulta.

Lanzamientos

Condición de que el valor, si es un campo de diccionario, contenga la entrada especificada.

Parámetros

  • fieldName - el campo a comparar.

  • entry - la entrada a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String key
)

Condición de que el valor, si es un campo de diccionario, contenga la clave especificada.

Parámetros

  • fieldName - el campo a comparar.

  • key - la clave a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
ObjectId value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Date value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
byte[] value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Float value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Double value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Long value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Integer value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Short value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Byte value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Boolean value
)

Condición de que el valor, si es un campo de diccionario, contenga el valor especificado.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor a buscar.

Devuelve

el objeto de consulta.

Lanzamientos

public long count ()

Cuenta el número de objetos que cumplen las condiciones de consulta.

Devuelve

el número de objetos coincidentes.

Lanzamientos

String firstFieldName,
java.lang.String[] remainingFieldNames
)

Selecciona un conjunto distinto de objetos de una clase específica. Cuando se proporcionan varios campos distintos, se devolverán todas las combinaciones únicas de valores en ellos. En caso de múltiples coincidencias, no se define qué objeto se devuelve. A menos que el resultado esté ordenado, se devolverá el primer objeto.

Parámetros

  • firstFieldName - primer nombre de campo a utilizar al buscar objetos distintos.

  • remainingFieldNames - nombres de campo restantes al determinar todas las combinaciones únicas de valores de campo.

Lanzamientos

Finaliza la agrupación de condiciones ("paréntesis derecho") que se abrió mediante una llamada a beginGroup() .

Devuelve

el objeto de consulta.

String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor del campo termine con la subcadena especificada.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value,
Case casing
)

Condición de que el valor del campo termine con la subcadena especificada.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value
)

Condición de que el valor del campo termine con la cadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cuerda.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Condición de que el valor del campo termine con la cadena especificada.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cuerda.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
ObjectId value
)

Comparación de igualdad.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación de igualdad.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value,
Case casing
)

Comparación de igualdad.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value,
Case casing
)

Comparación de igualdad.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Comparación de igualdad.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

Encuentra todos los objetos que cumplen las condiciones de la query.Lanzar queries pesadas desde el hilo de la Interfaz de Usuario puede resultar en una caída de cuadros o incluso en ANRs. No recomendamos hacerlo y por lo tanto no está permitido por defecto. Si deseas evitar estos comportamientos puedes obtener un Realm utilizando una RealmConfiguration que establezca explícitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) a false . De esta manera, te verás obligado a ejecutar tus consultas desde un hilo que no sea de la Interfaz de Usuario. De lo contrario, las llamadas a este método provocarán un RealmException . Alternativamente, puedes usar findAllAsync() .

Devuelve

Un io.realm.RealmResults que contiene objetos. Si ningún objeto cumple la condición, se devuelve una lista con cero objetos.

Lanzamientos

Busca todos los objetos que cumplen las condiciones de la consulta. Este método solo está disponible desde un hilo de Looper.

Devuelve

Inmediatamente, un RealmResults vacío. Los usuarios deben registrar un detector io.realm.RealmResults.addChangeListener(RealmChangeListener) para recibir una notificación cuando se complete la consulta.

public E findFirst ()

Encuentra el primer objeto que cumple las condiciones de la consulta. Ejecutar consultas pesadas desde el hilo de la interfaz de usuario puede provocar la pérdida de fotogramas o incluso ANR. No se recomienda, pero está permitido por defecto. Si desea evitar estos comportamientos, puede obtener un dominio mediante una configuración RealmConfiguration que establezca explícitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) false en. De esta forma, se verá obligado a ejecutar las consultas desde un hilo que no sea de la interfaz de usuario; de lo contrario, las llamadas a este método generarán una excepción RealmException. Como alternativa, puede usar findFirstAsync().

Devuelve

el objeto encontrado o null si ningún objeto coincide con las condiciones de la query.

Lanzamientos

public E findFirstAsync ()

Similar a findFirst() pero se ejecuta de forma asíncrona en un hilo de trabajo. Se debe registrar un listener en el RealmObject devuelto para recibir la notificación cuando la query finalice. El listener registrado también se activará si se realizan cambios en el RealmObject query. Si el RealmObject se borra, el listener será llamado una última vez y luego se detendrá. La query no se volverá a ejecutar.

Devuelve

Inmediatamente un RealmObject isLoaded() == falsevacío con. Intentar acceder a cualquier campo del objeto devuelto antes de que se cargue generará IllegalStateException un.

Lanzamientos

Devuelve una descripción textual de esta consulta.

Devuelve

la descripción textual de la consulta.

public long getQueryPointer ()

Devuelve el puntero a la consulta C++ subyacente. Este método solo es público debido a opciones de diseño arquitectónico difíciles de solucionar, por lo que debe considerarse interno y puede cambiar sin previo aviso.

Devuelve

el puntero a la consulta C++ subyacente.

public Realm getRealm ()

Devuelve la instancia de Realm a la que pertenece esta consulta.

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 consulta.

Devuelve

Instancia de reino a la que pertenece esta consulta.

Lanzamientos

Devuelve el nombre del reino interno del tipo que se está consultando.

Devuelve

el nombre interno de la clase del modelo Realm que se está consultando.

String fieldName,
ObjectId value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Date value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
float value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
double value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
long value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
int value
)

Comparación mayor que.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
ObjectId value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Date value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
float value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
double value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
long value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
int value
)

Comparación de mayor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
Case casing
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

  • casing - Cómo se manejan las mayúsculas y minúsculas. Case.INSENSITIVE solo funciona con1 caracteres latinos.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery in (
String fieldName,
)

En comparación. Esto permite comprobar si los objetos coinciden con algún valor de una matriz de valores.

Parámetros

  • fieldName - el campo a comparar.

  • values Matriz de valores para comparar. Si se proporciona null o la matriz vacía, la consulta nunca coincidirá con ningún resultado.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName
)

Condición que encuentra valores que se consideran "vacíos", es decir, una lista vacía, una cadena de longitud 0o una matriz de bytes.

Parámetros

  • fieldName - el campo a comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName
)

Condición que encuentra valores que se consideran "No vacíos", es decir, una lista, una cadena o una matriz de bytes con valores no vacíos.

Parámetros

  • fieldName - el campo a comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName
)

Prueba si un campo no es null . Solo funciona para los campos que permiten nulos.

Parámetros

  • fieldName - el nombre del campo.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName
)

Comprueba si un campo es null . Solo funciona con campos que aceptan valores nulos.

Para las consultas de enlaces, si alguna parte de la ruta del enlace es null, toda la ruta se considera null, por ejemplo, isNull("linkField.stringField") se considerará null si linkField o linkField.stringField es null .

Parámetros

  • fieldName - el nombre del campo.

Devuelve

el objeto de consulta.

Lanzamientos

public boolean isValid ()

Comprueba si io.realm.RealmQuery sigue siendo válido para su uso, es decir, que la instancia Realm no ha sido cerrada y cualquier io.realm.RealmResults principal sigue siendo válido.

Devuelve

true Si aún es válido para usar, false en caso contrario.

String fieldName,
ObjectId value
)

Comparación inferior.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación inferior.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
long value
)

Comparación inferior.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
int value
)

Comparación inferior.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
ObjectId value
)

Comparación menor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación menor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
long value
)

Comparación menor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
int value
)

Comparación menor o igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery like (
String fieldName,
RealmAny value,
Case casing
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery like (
String fieldName,
String value,
Case casing
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

Parámetros

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery like (
String fieldName,
RealmAny value
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cadena comodín.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery like (
String fieldName,
String value
)

Condición de que el valor de un campo coincida con la subcadena especificada, con comodines:

  • '*' coincide con [0, n] caracteres unicode

  • '?' coincide con un único carácter Unicode.

Parámetros

  • fieldName - el campo a comparar.

  • value - la cadena comodín.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery limit (
long limit
)

Limita la cantidad de objetos devueltos en caso de que la consulta coincida con más objetos. Tenga en cuenta que al usar este método en combinación con sort(String) y distinct(String, String...) se ejecutarán en el orden en que se agregaron, lo que puede afectar el resultado final.

Parámetros

  • limit - un límite que es ≥ 1 .

Lanzamientos

public Number max (
String fieldName
)

Encuentra el valor máximo de un campo.

Parámetros

  • fieldName - Campo donde se busca el máximo. Solo se admiten campos numéricos.

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.

Lanzamientos

String fieldName
)

Encuentra el valor máximo de un campo RealmAny.

Parámetros

  • fieldName - el campo que contiene un valor RealmAny.

Devuelve

Si no existen objetos o todos tienen null como valor para el campo RealmAny dado, sedevolverá RealmAny.Type.NULL. De lo contrario, se devolverá el valor máximo de RealmAny. Al determinar el valor máximo de RealmAny, se ignoran los objetos con null valores. Consulte la documentación de RealmAny para obtener más información sobre cómo se comparan los valores de RealmAny.

Lanzamientos

public Date maximumDate (
String fieldName
)

Encuentra el valor máximo de un campo.

Parámetros

  • fieldName - el nombre del campo.

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.

Lanzamientos

public Number min (
String fieldName
)

Encuentra el valor mínimo de un campo.

Parámetros

  • fieldName - Campo para buscar el mínimo. Solo se admiten campos numéricos.

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.

Lanzamientos

String fieldName
)

Encuentra el valor mínimo de un campo RealmAny.

Parámetros

  • fieldName - el campo que contiene un valor RealmAny.

Devuelve

Si no existen objetos o todos tienen null como valor para el campo RealmAny dado, sedevolverá RealmAny.Type.NULL. De lo contrario, se devolverá el RealmAny mínimo. Al determinar el RealmAny mínimo, se ignoran los objetos con null valores. Consulte la documentación de RealmAny para obtener más información sobre cómo se comparan los valores de RealmAny.

Lanzamientos

public Date minimumDate (
String fieldName
)

Encuentra el valor mínimo de un campo.

Parámetros

  • fieldName - el nombre del campo

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.

Lanzamientos

public RealmQuery not ()

Negar condición.

Devuelve

el objeto de consulta.

String fieldName,
ObjectId value
)

Comparación no igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
Decimal128 value
)

Comparación no igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
RealmAny value,
Case casing
)

Comparación no igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

  • casing - Cómo se manejan las mayúsculas y minúsculas. Case.INSENSITIVE solo funciona con1 caracteres latinos.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value,
Case casing
)

Comparación no igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

  • casing - Cómo se manejan las mayúsculas y minúsculas. Case.INSENSITIVE solo funciona con1 caracteres latinos.

Devuelve

el objeto de consulta.

Lanzamientos

String fieldName,
String value
)

Comparación no igual a.

Parámetros

  • fieldName - el campo a comparar.

  • value - el valor con el que comparar.

Devuelve

el objeto de consulta.

Lanzamientos

public RealmQuery or ()

Lógico-o dos condiciones.

Devuelve

el objeto de consulta.

String predicate,
)

Cree un predicado basado en texto usando el lenguaje de consulta Realm. Este predicado se puede combinar con otros predicados de tipo seguro o sin formato. Acepta valores de Realm como argumentos. Los nombres de clase y propiedad utilizados en el predicado sin formato pueden ser los nombres definidos en las clases Realm Model o los nombres internos definidos utilizando las anotaciones io.realm.annotations.RealmClass o io.realm.annotations.RealmField. Si un nombre de clase o propiedad contiene espacios, éstos deben estar escapados.

Los argumentos se definen en el predicado de cadena como $argument_index, donde $argument_index es un entero decimal que especifica la posición del argumento en la lista. El primer argumento se referencia mediante0$, el segundo mediante1$, etc. Consulte esta documentación para obtener una descripción más detallada del lenguaje de consulta Realm.

Ejemplos:

RealmQuery<Person> query = realm.where(Person.class);
// Simple query
query.rawPredicate("name = 'Jane'");
// Spaces in property name
query.rawPredicate("my\ property = 'Jane'");
// Multiple predicates
query.rawPredicate("name = 'Jane' OR name = 'John'")
// Collection queries
query.rawPredicate("children.@count > 3")
query.rawPredicate("ALL children.age > 18")
// Sub queries
query.rawPredicate("SUBQUERY(children, $child, $child.age > 21 AND $child.gender = 'male').@count > 0");
// Sort, Distinct, Limit
query.rawPredicate("name = 'Jane' SORT(lastName ASC) DISTINCT(city) LIMIT(5)");
// Arguments
query.rawPredicate("name = $0 AND age > $1", "Jane", 18);

Parámetros

  • predicate - un predicado del lenguaje de consulta Realm.

  • arguments - Valores de reino para el predicado.

Lanzamientos

public RealmQuery sort (
java.lang.String[] fieldNames,
io.realm.Sort[] sortOrders
)

Ordena el resultado de la consulta según los nombres de campo específicos en los órdenes proporcionados. Los campos posteriores solo se usarán si los valores de los campos anteriores son iguales. La ordenación está limitada actualmente a los conjuntos de caracteres «Latin Basic», «Latin Supplement», «Latin Extended A» y «Latin Extended B» (UTF-8 rango 0-591). Para otros conjuntos de caracteres, la ordenación no tendrá efecto.

Parámetros

  • fieldNames - una matriz de nombres de campos para ordenar.

  • sortOrders - cómo ordenar los nombres de los campos.

Lanzamientos

public RealmQuery sort (
String fieldName1,
Sort sortOrder1,
String fieldName2,
Sort sortOrder2
)

Ordena el resultado de la consulta por los nombres de campo específicos en los órdenes proporcionados. fieldName2 solo se utiliza en caso de valores iguales en fieldName1 .

La ordenación está limitada actualmente a los conjuntos de caracteres «Latín Básico», «Latín Suplementario», «Latín Extendido A» y «Latín Extendido B» (rango UTF-8 0-591). Para otros conjuntos de caracteres, la ordenación no tendrá efecto.

Parámetros

  • fieldName1 - primer nombre del campo

  • sortOrder1 - orden de clasificación para el primer campo

  • fieldName2 - segundo nombre del campo

  • sortOrder2 - orden de clasificación para el segundo campo

Lanzamientos

public RealmQuery sort (
String fieldName,
Sort sortOrder
)

Ordena el resultado de la consulta según el nombre de campo y el orden especificados. Actualmente, la ordenación está limitada a los conjuntos de caracteres «Latín básico», «Latín suplementario», «Latín extendido A» y «Latín extendido B» (rango UTF-8 0-591). Para otros conjuntos de caracteres, la ordenación no tendrá efecto.

Parámetros

  • fieldName - el nombre del campo por el que ordenar.

  • sortOrder - cómo ordenar los resultados.

Lanzamientos

public RealmQuery sort (
String fieldName
)

Ordena el resultado de la consulta por el nombre del campo específico en orden ascendente. Actualmente, la ordenación está limitada a los conjuntos de caracteres «Latín básico», «Latín suplementario», «Latín extendido A» y «Latín extendido B» (UTF-8, rango 0-591). Para otros conjuntos de caracteres, la ordenación no tendrá efecto.

Parámetros

  • fieldName - el nombre del campo por el que ordenar.

Lanzamientos

public Number sum (
String fieldName
)

Calcula la suma de un campo dado.

Parámetros

  • fieldName - El campo a sumar. Solo se admiten los campos numéricos y RealmAny.

Devuelve

La suma de los campos de los objetos coincidentes. 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. Al aplicarlo a un campo RealmAny, solo se sumarán los valores numéricos (Byte/Entero/Entero/Long/Float/Doble/Decimal128) y el tipo de retorno será Decimal128 .

Lanzamientos

Volver

Esquema de objeto de reino.Función