Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas Device SDKs
/
SDK para Java
/
Referência da API
/
io.realm

Classe RealmQuery

Nesta página

  • io.realm
  • Resumo do método
  • Métodos herdados
  • Detalhes do método
  • sempre falso
  • sempre verdadeiro
  • e a
  • média
  • médiaDecimal128
  • médiaRealmAny
  • Comece o grupo
  • começa com
  • entre
  • contém
  • contémEntry
  • containsKey
  • contémValor
  • contar
  • distinto
  • EndGroup
  • termina com
  • EqualTo
  • encontrarAll
  • findAllAsync
  • encontrarPrimeiro
  • findFirstAsync
  • Obter descrição
  • getQueryPointer
  • getRealm
  • getTypeQuered
  • maior que
  • maiorThanOrEqualTo
  • Em
  • isEmpty
  • isNotEmpty
  • isNotNull
  • IsNull
  • é válido
  • menos de
  • Menor ou igual a
  • semelhante a
  • limit
  • max
  • maxRealmAny
  • maximumDate
  • min
  • minRealmAny
  • minimumDate
  • não
  • Não é igual a
  • ou
  • Predicado bruto
  • sort
  • soma

io.realm

java.lang.Object
io.realm.RealmQuery

Um RealmQuery encapsula uma query em um io. Realm. Realm ou um io. Realm.RealmResults usando o padrão Builder. A query é executada usando findAll() ou findFirst() .

A entrada de muitas das funções de query usa um nome de campo como String. Observe que isso não é seguro para o tipo. Se uma classe RealmObject for refatorada, deve-se ter cuidado para não interromper nenhuma query.

Aio. Realm. O Realm não é ordenado, o que significa que não há garantia de que a consulta de um Realm retorne os objetos na ordem em que foram inseridos. Use sort(string) (string)} e métodos semelhantes se uma ordem específica for necessária.

Uma RealmQuery não pode ser passada entre threads diferentes.

Os resultados são obtidos rapidamente na maioria das vezes. No entanto, o lançamento de queries pesadas a partir do thread da UI pode resultar em uma queda de armações ou até mesmo em ANRs. Se quiser evitar esses comportamentos, você pode instanciar um Realm usando uma RealmConfiguration que define explicitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) a false . Dessa forma, as queries serão forçadas a serem lançadas a partir de um thread que não seja da UI. Como alternativa, você também pode usar findAllAsync() ou findFirstAsync() .

Dica

Veja também:

Resumo do método

Modificador e tipo
Método e descrição
Public RealmQuery
alwaysFalse ()

Este predicado nunca corresponderá, resultando na consulta sempre retornando 0 resultados.

Public RealmQuery
alwaysTrue ()

Este predicado sempre corresponderá.

Public RealmQuery
and ()

Lógica e duas condições O Realm aplica automaticamente lógica e entre todas as declarações de query, portanto, isso destina-se apenas a ser um meio de aumentar a legibilidade.

duplopúblico
average (
String fieldName
)

Retorna a média de um determinado campo.

Decimal público128
averageDecimal128 (
String fieldName
)

Retorna a média de um determinado campo.

Decimal público128
averageRealmAny (
String fieldName
)

Retorna a média de um determinado campo.

Public RealmQuery
beginGroup ()

Iniciar o agrupamento de condições ("parêntese esquerdo").

Public RealmQuery
beginsWith (
String fieldName,
RealmAny value,
Case casing
)

Condição para que o valor do campo comece com a substring especificada.

Public RealmQuery
beginsWith (
String fieldName,
String value,
Case casing
)

Condição para que o valor do campo comece com a substring especificada.

Public RealmQuery
beginsWith (
String fieldName,
RealmAny value
)

Condição de que o valor do campo comece com a string especificada.

Public RealmQuery
beginsWith (
String fieldName,
String value
)

Condição de que o valor do campo comece com a string especificada.

Public RealmQuery
between (
String fieldName,
Decimal128 from,
Decimal128 to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
RealmAny from,
RealmAny to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
Date from,
Date to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
float from,
float to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
double from,
double to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
long from,
long to
)

Entre a condição.

Public RealmQuery
between (
String fieldName,
int from,
int to
)

Entre a condição.

Public RealmQuery
contains (
String fieldName,
RealmAny value,
Case casing
)

Condição de que o valor do campo contém a substring especificada.

Public RealmQuery
contains (
String fieldName,
String value,
Case casing
)

Condição de que o valor do campo contém a substring especificada.

Public RealmQuery
contains (
String fieldName,
RealmAny value
)

Condição de que o valor do campo contém a substring especificada.

Public RealmQuery
contains (
String fieldName,
String value
)

Condição de que o valor do campo contém a substring especificada.

Public RealmQuery
containsEntry (
String fieldName,
java.util.Map.Entry<java.lang.String, ?> entry
)

Condição de que o valor, se um campo de dicionário, contiver a entrada especificada.

Public RealmQuery
containsKey (
String fieldName,
String key
)

Condição de que o valor, se um campo de dicionário, contém a chave especificada.

Public RealmQuery
containsValue (
String fieldName,
ObjectId value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Decimal128 value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Date value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
byte[] value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
String value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Float value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Double value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Long value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Integer value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Short value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Byte value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Public RealmQuery
containsValue (
String fieldName,
Boolean value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

público longo
count ()

Conta o número de objetos que atendem às condições de query.

Public RealmQuery
distinct (
String firstFieldName,
java.lang.String[] remainingFieldNames
)

Seleciona um conjunto distinto de objetos de uma classe específica.

Public RealmQuery
endGroup ()

Agrupamento final de condições ("parêntese direito") que foi aberto por uma chamada para beginGroup() .

Public RealmQuery
endsWith (
String fieldName,
RealmAny value,
Case casing
)

Condição de que o valor do campo termine com a substring especificada.

Public RealmQuery
endsWith (
String fieldName,
String value,
Case casing
)

Condição de que o valor do campo termine com a substring especificada.

Public RealmQuery
endsWith (
String fieldName,
RealmAny value
)

Condição de que o valor do campo termine com a string especificada.

Public RealmQuery
endsWith (
String fieldName,
String value
)

Condição de que o valor do campo termine com a string especificada.

Public RealmQuery
equalTo (
String fieldName,
ObjectId value
)

Comparação igual a.

Public RealmQuery
equalTo (
String fieldName,
Decimal128 value
)

Comparação igual a.

Public RealmQuery
equalTo (
String fieldName,
RealmAny value,
Case casing
)

Comparação igual a.

Public RealmQuery
equalTo (
String fieldName,
String value,
Case casing
)

Comparação igual a.

Public RealmQuery
equalTo (
String fieldName,
String value
)

Comparação igual a.

findAll ()

Encontra todos os objetos que atendem às condições de query.

findAllAsync ()

Encontra todos os objetos que atendem às condições de query.

público E
findFirst ()

Localiza o primeiro objeto que atende às condições de query.

público E
findFirstAsync ()

Semelhante a findFirst() mas executado de forma assíncrona em uma thread de trabalho.

getDescription ()

Retorna uma descrição textual desta query.

público longo
getQueryPointer ()

Retorna o ponteiro para a query subjacente do C++.

getRealm ()

Retorna a Instância de Realm à qual esta query pertence.

getTypeQueried ()

Retorna o nome do Realm interno do tipo que está sendo query.

Public RealmQuery
greaterThan (
String fieldName,
ObjectId value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
Decimal128 value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
RealmAny value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
Date value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
float value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
double value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
long value
)

Comparação maior que.

Public RealmQuery
greaterThan (
String fieldName,
int value
)

Comparação maior que.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
ObjectId value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
Decimal128 value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
Date value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
float value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
double value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
long value
)

Comparação maior ou igual a.

Public RealmQuery
greaterThanOrEqualTo (
String fieldName,
int value
)

Comparação maior ou igual a.

Public RealmQuery
in (
String fieldName,
io.realm.RealmAny[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.util.Date[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Boolean[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Float[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Double[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Long[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Integer[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Short[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.Byte[] values
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.String[] values,
Case casing
)

Em comparação.

Public RealmQuery
in (
String fieldName,
java.lang.String[] values
)

Em comparação.

Public RealmQuery
isEmpty (
String fieldName
)

Condição que encontra valores considerados "vazios", ou seja, uma lista vazia, a string de comprimento 0 ou array de bytes.

Public RealmQuery
isNotEmpty (
String fieldName
)

Condição que encontra valores considerados "Não vazios", ou seja, uma lista, uma string ou uma array de bytes com valores não vazios.

Public RealmQuery
isNotNull (
String fieldName
)

Testa se um campo não é null .

Public RealmQuery
isNull (
String fieldName
)

Testa se um campo é null .

booleanopúblico
isValid ()

Verifica se io.realm.RealmQuery ainda é válido para uso, ou seja, se io.realm.Realm a instância não foi fechada e qualquer io.realm.RealmResults pai ainda é válido.

Public RealmQuery
lessThan (
String fieldName,
ObjectId value
)

Comparação menos que.

Public RealmQuery
lessThan (
String fieldName,
Decimal128 value
)

Comparação menos que.

Public RealmQuery
lessThan (
String fieldName,
long value
)

Comparação menos que.

Public RealmQuery
lessThan (
String fieldName,
int value
)

Comparação menos que.

Public RealmQuery
lessThanOrEqualTo (
String fieldName,
ObjectId value
)

Comparação menor ou igual a.

Public RealmQuery
lessThanOrEqualTo (
String fieldName,
Decimal128 value
)

Comparação menor ou igual a.

Public RealmQuery
lessThanOrEqualTo (
String fieldName,
long value
)

Comparação menor ou igual a.

Public RealmQuery
lessThanOrEqualTo (
String fieldName,
int value
)

Comparação menor ou igual a.

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

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

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

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Public RealmQuery
like (
String fieldName,
RealmAny value
)

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Public RealmQuery
like (
String fieldName,
String value
)

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Public RealmQuery
limit (
long limit
)

Limita o número de objetos retornados caso a query corresponda a mais objetos.

número público
max (
String fieldName
)

Localiza o valor máximo de um campo.

public RealmAny
maxRealmAny (
String fieldName
)

Localiza o valor máximo de um campo RealmAny .

maximumDate (
String fieldName
)

Localiza o valor máximo de um campo.

número público
min (
String fieldName
)

Localiza o valor mínimo de um campo.

public RealmAny
minRealmAny (
String fieldName
)

Encontra o valor mínimo de um campo RealmAny .

minimumDate (
String fieldName
)

Localiza o valor mínimo de um campo.

Public RealmQuery
not ()

Negar condição.

Public RealmQuery
notEqualTo (
String fieldName,
ObjectId value
)

Comparação não igual a.

Public RealmQuery
notEqualTo (
String fieldName,
Decimal128 value
)

Comparação não igual a.

Public RealmQuery
notEqualTo (
String fieldName,
RealmAny value,
Case casing
)

Comparação não igual a.

Public RealmQuery
notEqualTo (
String fieldName,
String value,
Case casing
)

Comparação não igual a.

Public RealmQuery
notEqualTo (
String fieldName,
String value
)

Comparação não igual a.

Public RealmQuery
or ()

Lógica-ou duas condições.

Public RealmQuery
rawPredicate (
String predicate,
java.lang.Object[] arguments
)

Crie um predicado baseado em texto utilizando a RealmQL.

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

Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas.

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

Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas.

Public RealmQuery
sort (
String fieldName,
Sort sortOrder
)

Classifica o resultado da query pelo nome e ordem do campo especificado.

Public RealmQuery
sort (
String fieldName
)

Classifica o resultado da query pelo nome de campo específico em ordem crescente.

número público
sum (
String fieldName
)

Calcula a soma de um determinado campo.

Métodos herdados

  • Métodos herdados da classe java.lang.Object : getClass , hashCode , equals , clone , toString , notify , notifyAll , wait , wait , wait , finalize

Detalhes do método

sempre falso

Este predicado nunca corresponderá, resultando na consulta sempre retornando 0 resultados.

sempre verdadeiro

Este predicado sempre corresponderá.

e a

public RealmQuery and ()

Lógica e duas condições O Realm aplica automaticamente lógica e entre todas as declarações de query, portanto, isso destina-se apenas a ser um meio de aumentar a legibilidade.

Devoluções

o objeto de query

média

public double average (
String fieldName
)

Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.

Parâmetros

  • fieldName - o campo para calcular a média. Somente campos numéricos são permitidos.

Devoluções

a média do campo fornecido entre os objetos nos resultados da query. Isso será do tipo double para todos os tipos de campos numéricos. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.

Lança

médiaDecimal128

public Decimal128 averageDecimal128 (
String fieldName
)

Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.

Parâmetros

  • fieldName - o campo para calcular a média. Somente campos128 decimais são suportados. Para outros tipos de número, considere usar average(string) .

Devoluções

a média do campo fornecido entre os objetos nos resultados da query. Este será do tipo Decimal128. Se não existirem objetos ou se todos tiverem null , o valor do campo fornecido 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.

Lança

médiaRealmAny

public Decimal128 averageRealmAny (
String fieldName
)

Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.

Parâmetros

  • fieldName - o campo para calcular a média. Somente campos RealmAny são suportados. Para outros tipos, considere usar média(string) .

Devoluções

a média do campo fornecido entre os objetos nos resultados da query. Este será do tipo Decimal128. Se não existirem objetos ou se todos tiverem null , o valor do campo fornecido 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.

Lança

Comece o grupo

Iniciar o agrupamento de condições ("parêntese esquerdo"). Um grupo deve ser fechado com uma chamada para endGroup() .

Devoluções

o objeto de query.

Dica

Veja também:

começa com

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

Condição para que o valor do campo comece com a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query

Lança

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

Condição para que o valor do campo comece com a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query

Lança

public RealmQuery beginsWith (
String fieldName,
RealmAny value
)

Condição de que o valor do campo comece com a string especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a cadeia de caracteres.

Devoluções

o objeto de query.

Lança

public RealmQuery beginsWith (
String fieldName,
String value
)

Condição de que o valor do campo comece com a string especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a cadeia de caracteres.

Devoluções

o objeto de query.

Lança

entre

public RealmQuery between (
String fieldName,
Decimal128 from,
Decimal128 to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
RealmAny from,
RealmAny to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
Date from,
Date to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
float from,
float to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
double from,
double to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
long from,
long to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

public RealmQuery between (
String fieldName,
int from,
int to
)

Entre a condição.

Parâmetros

  • fieldName - o campo para comparar.

  • from - valor mais baixo (inclusive).

  • to - valor mais alto (inclusive).

Devoluções

o objeto de query.

Lança

contém

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

Condição de que o valor do campo contém a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

O objeto de consulta.

Lança

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

Condição de que o valor do campo contém a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

O objeto de consulta.

Lança

public RealmQuery contains (
String fieldName,
RealmAny value
)

Condição de que o valor do campo contém a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

Devoluções

o objeto de query.

Lança

public RealmQuery contains (
String fieldName,
String value
)

Condição de que o valor do campo contém a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

Devoluções

o objeto de query.

Lança

contémEntry

Condição de que o valor, se um campo de dicionário, contiver a entrada especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • entry - a entrada a ser pesquisada.

Devoluções

o objeto de query.

Lança

containsKey

public RealmQuery containsKey (
String fieldName,
String key
)

Condição de que o valor, se um campo de dicionário, contém a chave especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • key - a chave para pesquisar.

Devoluções

o objeto de query.

Lança

contémValor

public RealmQuery containsValue (
String fieldName,
ObjectId value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Decimal128 value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Date value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
byte[] value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
String value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Float value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Double value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Long value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Integer value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Short value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Byte value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

public RealmQuery containsValue (
String fieldName,
Boolean value
)

Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor a ser pesquisado.

Devoluções

o objeto de query.

Lança

contar

public long count ()

Conta o número de objetos que atendem às condições de query.

Devoluções

o número de objetos correspondentes.

Lança

distinto

public RealmQuery distinct (
String firstFieldName,
java.lang.String[] remainingFieldNames
)

Seleciona um conjunto distinto de objetos de uma classe específica. Quando vários campos distintos são fornecidos, todas as combinações exclusivas de valores nos campos serão retornadas. No caso de várias correspondências, é indefinido qual objeto será retornado. A menos que o resultado seja classificado, o primeiro objeto será retornado.

Parâmetros

  • firstFieldName - o primeiro nome do campo a ser usado ao encontrar objetos distintos.

  • remainingFieldNames - nomes de campos restantes ao determinar todas as combinações únicas de valores de campo.

Lança

  • IllegalArgumentException - se os nomes de campo estiverem vazios ou null , não existirem, forem um tipo não suportado ou apontarem para um campo vinculado.

  • Exceção de estado ilegal - se nomes de campo distintos já tiverem sido definidos.

EndGroup

Agrupamento final de condições ("parêntese direito") que foi aberto por uma chamada para beginGroup() .

Devoluções

o objeto de query.

Dica

Veja também:

termina com

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

Condição de que o valor do campo termine com a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

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

Condição de que o valor do campo termine com a substring especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a substring.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

public RealmQuery endsWith (
String fieldName,
RealmAny value
)

Condição de que o valor do campo termine com a string especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a cadeia de caracteres.

Devoluções

o objeto de query.

Lança

public RealmQuery endsWith (
String fieldName,
String value
)

Condição de que o valor do campo termine com a string especificada.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a cadeia de caracteres.

Devoluções

o objeto de query.

Lança

EqualTo

public RealmQuery equalTo (
String fieldName,
ObjectId value
)

Comparação igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery equalTo (
String fieldName,
Decimal128 value
)

Comparação igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

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

Comparação igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

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

Comparação igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

public RealmQuery equalTo (
String fieldName,
String value
)

Comparação igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

encontrarAll

Localiza todos os objetos que atendem às condições de consulta. O lançamento de consultas pesadas a partir do thread da interface do usuário pode resultar em uma queda de armações ou até mesmo em ANRs. Não recomendamos fazer isso e, portanto, não é permitido por padrão. Se você quiser evitar esses comportamentos, poderá obter um Realm usando uma RealmConfiguration que define explicitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) para false . Dessa forma, você será forçado a iniciar suas queries a partir de um thread que não seja da UI, caso contrário, as chamadas para esse método lançarão uma RealmException . Como alternativa, você pode usar findAllAsync() .

Devoluções

um io.realm.RealmResults contendo objetos. Se nenhum objeto corresponder à condição, uma lista com zero objetos será retornada.

Lança

Dica

Veja também:

findAllAsync

Encontra todos os objetos que atendem às condições de query. Este método só está disponível em uma thread de loop de eventos.

Devoluções

imediatamente um RealmResults vazio . Os usuários precisam registrar um ouvinte io.realm.RealmResults.addChangeListener(RealmChangeListener) para serem notificados quando a query for concluída.

Dica

Veja também:

encontrarPrimeiro

public E findFirst ()

Localiza o primeiro objeto que atenda às condições de consulta. O lançamento de consultas pesadas a partir do thread da interface do usuário pode resultar em uma queda de armações ou até mesmo em ANRs. Não recomendamos fazer isso, mas é permitido por padrão. Se você quiser evitar esses comportamentos, poderá obter um Realm usando uma RealmConfiguration que define explicitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) para false . Dessa forma, você será forçado a iniciar suas queries a partir de um thread que não seja da UI, caso contrário, as chamadas para esse método lançarão uma RealmException . Como alternativa, você pode usar findFirstAsync() .

Devoluções

o objeto encontrado ou null se nenhum objeto corresponder às condições de query.

Lança

Dica

Veja também:

findFirstAsync

public E findFirstAsync ()

Semelhante a findFirst() mas executado de forma assíncrona em uma thread de trabalho. Um ouvinte deve ser registrado no RealmObject retornado para receber a notificação quando a query for concluída. O ouvinte registrado também será acionado se houver alterações feitas no RealmObject consultado. Se o RealmObject for excluído, o ouvinte será chamado uma última vez e, em seguida, parará. A query não será executada novamente.

Devoluções

imediatamente um RealmObject vazio com isLoaded() == false . Tentar acessar qualquer campo no objeto retornado antes de ele ser carregado gerará um IllegalStateException .

Lança

Obter descrição

Retorna uma descrição textual desta query.

Devoluções

a descrição textual da query.

getQueryPointer

public long getQueryPointer ()

Retorna o ponteiro para a query subjacente do C++. Esse método só é público devido às opções de design arquitetural que são difíceis de contornar e devem ser consideradas internas e podem mudar sem aviso.

Devoluções

o ponteiro para a query C++ subjacente.

getRealm

public Realm getRealm ()

Retorna a Instância de Realm à qual esta query pertence.

Chamar Realm.close() na instância retornada não é recomendado, pois é o mesmo que chamá-la na Instância de Realm, o que pode fazer com que o Realm feche completamente, invalidando a query.

Devoluções

Realm à qual esta query pertence.

Lança

  • Exceção de estado ilegal - se o Realm for uma instância do DynamicRealm ou se o Realm já tiver sido fechado.

getTypeQuered

Retorna o nome do Realm interno do tipo que está sendo query.

Devoluções

o nome interno da classe de modelo Realm que está sendo query.

maior que

public RealmQuery greaterThan (
String fieldName,
ObjectId value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
Decimal128 value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
RealmAny value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
Date value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
float value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
double value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
long value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThan (
String fieldName,
int value
)

Comparação maior que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

maiorThanOrEqualTo

public RealmQuery greaterThanOrEqualTo (
String fieldName,
ObjectId value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
Decimal128 value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
Date value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
float value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
double value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
long value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery greaterThanOrEqualTo (
String fieldName,
int value
)

Comparação maior ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

Em

public RealmQuery in (
String fieldName,
io.realm.RealmAny[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.util.Date[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Boolean[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Float[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Double[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Long[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Integer[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Short[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.Byte[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.String[] values,
Case casing
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

  • casing - como o invólucro é tratado. Caso.INSENSITIVE funciona apenas para os caracteres Latin-1.

Devoluções

o objeto de query.

Lança

public RealmQuery in (
String fieldName,
java.lang.String[] values
)

Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.

Parâmetros

  • fieldName - o campo para comparar.

  • values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.

Devoluções

o objeto de query.

Lança

isEmpty

public RealmQuery isEmpty (
String fieldName
)

Condição que encontra valores considerados "vazios", ou seja, uma lista vazia, a string de comprimento 0 ou array de bytes.

Parâmetros

  • fieldName - o campo para comparar.

Devoluções

o objeto de query.

Lança

isNotEmpty

public RealmQuery isNotEmpty (
String fieldName
)

Condição que encontra valores considerados "Não vazios", ou seja, uma lista, uma string ou uma array de bytes com valores não vazios.

Parâmetros

  • fieldName - o campo para comparar.

Devoluções

o objeto de query.

Lança

isNotNull

public RealmQuery isNotNull (
String fieldName
)

Testa se um campo não é null . Funciona apenas para campos anuláveis.

Parâmetros

  • fieldName - o nome do campo.

Devoluções

o objeto de query.

Lança

Dica

Veja também:

IsNull

public RealmQuery isNull (
String fieldName
)

Testa se um campo é null . Funciona apenas para campos anuláveis.

Para query de link, se qualquer parte do caminho do link for null , todo o caminho será considerado null por exemplo, isNull("linkField.stringField") será considerado null se linkField ou linkField.stringField for null .

Parâmetros

  • fieldName - o nome do campo.

Devoluções

o objeto de query.

Lança

Dica

Veja também:

é válido

public boolean isValid ()

Verifica se io.realm.RealmQuery ainda é válido para uso, ou seja, se io.realm.Realm a instância não foi fechada e qualquer io.realm.RealmResults pai ainda é válido.

Devoluções

true se ainda for válido para usar, false caso contrário.

menos de

public RealmQuery lessThan (
String fieldName,
ObjectId value
)

Comparação menos que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThan (
String fieldName,
Decimal128 value
)

Comparação menos que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThan (
String fieldName,
long value
)

Comparação menos que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThan (
String fieldName,
int value
)

Comparação menos que.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

Menor ou igual a

public RealmQuery lessThanOrEqualTo (
String fieldName,
ObjectId value
)

Comparação menor ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThanOrEqualTo (
String fieldName,
Decimal128 value
)

Comparação menor ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThanOrEqualTo (
String fieldName,
long value
)

Comparação menor ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery lessThanOrEqualTo (
String fieldName,
int value
)

Comparação menor ou igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

semelhante a

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

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a sequência curinga.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

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

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a sequência curinga.

  • casing - como lidar com o invólucro. Definir isso como Caso.INSENSITIVE só funciona para caracteres Latin-1.

Devoluções

o objeto de query.

Lança

public RealmQuery like (
String fieldName,
RealmAny value
)

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a sequência curinga.

Devoluções

o objeto de query.

Lança

public RealmQuery like (
String fieldName,
String value
)

Condição de que o valor do campo corresponda à substring especificada, com curingas:

  • '*' corresponde a [0, n] caracteres unicode

  • '?' corresponde a um único caractere unicode.

Parâmetros

  • fieldName - o campo para comparar.

  • value - a sequência curinga.

Devoluções

o objeto de query.

Lança

limit

public RealmQuery limit (
long limit
)

Limita o número de objetos retornados caso a consulta corresponda a mais objetos.Observe que, ao usar este método em combinação com sort(string) e distinct(string, string...) , eles serão executados na ordem em que foram adicionados, o que pode afetar o resultado final.

Parâmetros

  • limit - um limite que é ≥ 1 .

Lança

max

public Number max (
String fieldName
)

Localiza o valor máximo de um campo.

Parâmetros

  • fieldName - o campo para procurar um máximo. Somente campos numéricos são permitidos.

Devoluções

se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor máximo é retornado. Ao determinar o valor máximo, os objetos com valores null são ignorados.

Lança

maxRealmAny

public RealmAny maxRealmAny (
String fieldName
)

Localiza o valor máximo de um campo RealmAny .

Parâmetros

  • fieldName - o campo que contém um valor RealmAny.

Devoluções

se não existirem objetos ou se todos eles tiverem null como o valor do campo RealmAny fornecido, RealmAny.Type.NULL será retornado. Caso contrário, o RealmAny máximo será retornado. Ao determinar o RealmAny máximo, os objetos com valores null são ignorados. Consulte a documentação do RealmAny para obter mais detalhes sobre como os valores do RealmAny são comparados.

Lança

maximumDate

public Date maximumDate (
String fieldName
)

Localiza o valor máximo de um campo.

Parâmetros

  • fieldName - o nome do campo.

Devoluções

se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data máxima é retornada. Ao determinar a data máxima, os objetos com valores null são ignorados.

Lança

min

public Number min (
String fieldName
)

Localiza o valor mínimo de um campo.

Parâmetros

  • fieldName - o campo para procurar um mínimo. Somente campos numéricos são permitidos.

Devoluções

se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor mínimo é devolvido. Ao determinar o valor mínimo, os objetos com valores null são ignorados.

Lança

minRealmAny

public RealmAny minRealmAny (
String fieldName
)

Encontra o valor mínimo de um campo RealmAny .

Parâmetros

  • fieldName - o campo que contém um valor RealmAny.

Devoluções

se não existirem objetos ou se todos eles tiverem null como o valor do campo RealmAny fornecido, RealmAny.Type.NULL será retornado. Caso contrário, o mínimo de RealmAny é retornado. Ao determinar o RealmAny mínimo, os objetos com valores null são ignorados. Consulte a documentação do RealmAny para obter mais detalhes sobre como os valores do RealmAny são comparados.

Lança

minimumDate

public Date minimumDate (
String fieldName
)

Localiza o valor mínimo de um campo.

Parâmetros

  • fieldName - o nome do campo

Devoluções

se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data mínima é retornada. Ao determinar a data mínima, os objetos com valores null são ignorados.

Lança

não

public RealmQuery not ()

Negar condição.

Devoluções

o objeto de query.

Não é igual a

public RealmQuery notEqualTo (
String fieldName,
ObjectId value
)

Comparação não igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

public RealmQuery notEqualTo (
String fieldName,
Decimal128 value
)

Comparação não igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

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

Comparação não igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

  • casing - como o invólucro é tratado. Caso.INSENSITIVE funciona apenas para os caracteres Latin-1.

Devoluções

o objeto de query.

Lança

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

Comparação não igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

  • casing - como o invólucro é tratado. Caso.INSENSITIVE funciona apenas para os caracteres Latin-1.

Devoluções

o objeto de query.

Lança

public RealmQuery notEqualTo (
String fieldName,
String value
)

Comparação não igual a.

Parâmetros

  • fieldName - o campo para comparar.

  • value - o valor com o qual comparar.

Devoluções

o objeto de query.

Lança

ou

public RealmQuery or ()

Lógica-ou duas condições.

Devoluções

o objeto de query.

Predicado bruto

public RealmQuery rawPredicate (
String predicate,
java.lang.Object[] arguments
)

Crie um predicado baseado em texto utilizando a Realm Query Language. Este predicado pode ser combinado com outros predicados seguros brutos ou de tipo, ele aceita Realm value como argumentos. Os nomes de classes e propriedade usados no predicado bruto podem ser os nomes definidos nas classes do Modelo Realm ou os nomes internos definidos usando o io.realm .annotations.RealmClass ou io.realm.annotations.RealmField annotations. Se uma classe ou nome de propriedade contiver espaços, estes deverão ser evitados.

Os argumentos são definidos no predicado da string como $argument_index, onde $argument_index é um número inteiro decimal que especifica a posição do argumento na lista de argumentos. O primeiro argumento é referenciado por $0, o segundo por $1, etc. Consulte estes Docs para obter uma descrição mais detalhada do RQL.

Exemplos:

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 - um predicado da Realm Query Language.

  • arguments - Realm value para o predicado.

Lança

sort

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

Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas. Os campos posteriores só serão usados se os valores de campo anteriores forem iguais. Atualmente, a classificação está limitada a conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0- 591). Para outros conjuntos de caracteres, a classificação não terá efeito.

Parâmetros

  • fieldNames - uma array de nomes de campos para classificar.

  • sortOrders - como classificar os nomes dos campos.

Lança

  • IllegalArgumentException - se o nome do campo não existir.

  • Exceção de estado ilegal - se uma ordem de classificação já tiver sido definida.

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

Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas. fieldName2 só é usado no caso de valores iguais em fieldName1 .

No momento, a classificação está limitada aos conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591). Para outros conjuntos de caracteres, a classificação não terá efeito.

Parâmetros

  • fieldName1 - nome do primeiro campo

  • sortOrder1 - ordem de classificação para o primeiro campo

  • fieldName2 - nome do segundo campo

  • sortOrder2 - ordem de classificação para o segundo campo

Lança

  • IllegalArgumentException - se o nome do campo não existir.

  • Exceção de estado ilegal - se uma ordem de classificação já tiver sido definida.

public RealmQuery sort (
String fieldName,
Sort sortOrder
)

Classifica o resultado da query pelo nome e ordem do campo especificado.A classificação está limitada a conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591) . Para outros conjuntos de caracteres, a classificação não terá efeito.

Parâmetros

  • fieldName - o nome do campo pelo qual classificar.

  • sortOrder - como classificar os resultados.

Lança

  • IllegalArgumentException - se o nome do campo não existir.

  • Exceção de estado ilegal - se uma ordem de classificação já tiver sido definida.

public RealmQuery sort (
String fieldName
)

Classifica o resultado da query pelo nome do campo específico em ordem crescente.A classificação é atualmente limitada a conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591 ). Para outros conjuntos de caracteres, a classificação não terá efeito.

Parâmetros

  • fieldName - o nome do campo pelo qual classificar.

Lança

  • IllegalArgumentException - se o nome do campo não existir.

  • Exceção de estado ilegal - se uma ordem de classificação já tiver sido definida.

soma

public Number sum (
String fieldName
)

Calcula a soma de um determinado campo.

Parâmetros

  • fieldName - o campo a ser somado. Somente os campos numéricos e RealmAny são suportados.

Devoluções

a soma dos campos dos objetos correspondentes. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a soma, objetos com valores null são ignorados. Quando aplicado a um campo RealmAny, somente os valores numéricos serão somados (Byte/Integer/Integer/Long/Float/Double/Decimal128) e o tipo de retorno será Decimal128 .

Lança

Voltar

RealmObjectSchema.Function

Próximo

RealmResults