Pacote io.realm
Interface RealmCollection<E>
-
- Parâmetros do tipo:
E
- tipo deRealmObject
armazenado na collection.
- Todas as interfaces:
Collection<E>
,io.realm.internal.Freezable<RealmCollection<E>>
,Iterable<E>
,io.realm.internal.ManageableObject
- Todas as subinterfaces conhecidas:
OrderedRealmCollection<E>
- Todas as classes de implementação conhecidas:
OrderedRealmCollectionSnapshot
,RealmList
,RealmResults
,RealmSet
public interface RealmCollection<E> extends Collection<E>, io.realm.internal.ManageableObject, io.realm.internal.Freezable<RealmCollection<E>>
RealmCollection
é a raiz da hierarquia de collection que o Realm suporta. Define operações em collection de dados e o comportamento que elas terão em todas as implementações deRealmCollection
s.As collection Realm são visualizações "ativas" dos dados subjacentes. Isso significa que eles serão automaticamente mantidos atualizados. Como consequência, o uso de métodos como
Collections.unmodifiableCollection(Collection)
não impedirá que uma collection seja modificada.
-
-
Resumo do método
Todos os métodos Métodos de instância Métodos abstratos Modificador e tipo Método Descrição double
average(String fieldName)
Retorna a média de um determinado campo.boolean
contains(Object object)
Testa se esteCollection
contém o objeto especificado.boolean
deleteAllFromRealm()
Isso exclui todos os objetos da collection do Realm subjacente e da collection.boolean
isLoaded()
Verifica se uma collection já terminou de carregar seus dados.boolean
isManaged()
Verifica se a collection é gerenciada pelo Realm.boolean
isValid()
Verifica se a collection ainda é válida para uso, ou seja, a instânciaRealm
não foi fechada.boolean
load()
Bloqueia a collection até que todos os dados estejam disponíveis.Number
max(String fieldName)
Localiza o valor máximo de um campo.Date
maxDate(String fieldName)
Encontra a data máxima.Number
min(String fieldName)
Localiza o valor mínimo de um campo.Date
minDate(String fieldName)
Encontra a data mínima.Number
sum(String fieldName)
Calcula a soma de um determinado campo.RealmQuery<E>
where()
Retorna umRealmQuery
, que pode ser utilizado para fazer query de objetos específicos desta coleção.-
Métodos herdados da interface java.util.collection
add, addAll, clear, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray
-
-
-
-
Detalhes do método
-
ONDE
RealmQuery < E > onde ()
Retorna umRealmQuery
, que pode ser utilizado para fazer query de objetos específicos desta coleção.- Retorna:
- um objeto RealmQuery.
- Lançamentos:
IllegalStateException
- se a Instância de Realm tiver sido fechada ou as query não estiverem disponíveis de outra forma.- Veja também:
RealmQuery
-
min
@Nullable Número 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.- Retorna:
- 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se o campo não for um tipo de número.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
max
@Nullable Número máximo (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.- Retorna:
- 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se o campo não for um tipo de número.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
soma
Soma do número (String fieldName)
Calcula a soma de um determinado campo.- Parâmetros:
fieldName
- o campo a ser somado. Somente campos numéricos são permitidos.- Retorna:
- a soma. 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se o campo não for um tipo de número.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
média
média dupla (String fieldName)
Retorna a média de um determinado campo.- Parâmetros:
fieldName
- o campo para calcular a média. Somente campos numéricos são permitidos.- Retorna:
- 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se o campo não for um tipo de número.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
maxDate
@Nullable Date maxDate( String fieldName)
Encontra a data máxima.- Parâmetros:
fieldName
- o campo para procurar a data máxima. Se fieldName não for do tipo Date, uma exceção será lançada.- Retorna:
- 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se fieldName não for um campo de data.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
minDate
@Nullable Data minDate (String fieldName)
Encontra a data mínima.- Parâmetros:
fieldName
- o campo para procurar a data mínima. Se fieldName não for do tipo Date, uma exceção será lançada.- Retorna:
- 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 valoresnull
são ignorados. - Lançamentos:
IllegalArgumentException
- se fieldName não for um campo de data.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
deleteAllFromRealm
boolean deleteAllFromRealm()
Isso exclui todos os objetos da collection do Realm subjacente e da collection.- Retorna:
true
se os objetos foram excluídos,false
caso contrário.- Lançamentos:
IllegalStateException
- se o Realm correspondente estiver fechado ou em um thread incorreto.IllegalStateException
- se o Realm tiver sido fechado ou chamado de um tópico incorreto.
-
isLoaded
boolean isLoaded()
Verifica se uma collection já terminou de carregar seus dados.- Retorna:
true
se os dados tiverem sido carregados e estiverem disponíveis,false
se os dados ainda estiverem sendo carregados.
-
carregar
boolean load()
Bloqueia a collection até que todos os dados estejam disponíveis.- Retorna:
true
se os dados puderem ser carregados com sucesso,false
caso contrário.
-
é válido
boolean isValid()
Verifica se a collection ainda é válida para uso, ou seja, a instânciaRealm
não foi fechada. Ele sempre retornarátrue
para uma coleção não gerenciada.- Especificado por:
isValid
na interfaceio.realm.internal.ManageableObject
- Retorna:
true
se ainda for válido para usar ou uma collection não gerenciada,false
caso contrário.
-
isManaged
boolean isManaged()
Verifica se a collection é managed pelo Realm. Uma managed collection é apenas um invólucro que envolve os dados no Arquivo de Realm subjacente. Nos threads do loop de eventos, uma managed collection será atualizada ao vivo para que sempre ponto para os dados mais recentes. As managed collection são confinadas por threads para que não possam ser acessadas de outros threads além daquele que as criou.Se esse método retornar
false
, a collection não será gerenciada. Uma collection não gerenciada é apenas uma Java collection normal, portanto, não será atualizada em tempo real.- Especificado por:
isManaged
na interfaceio.realm.internal.ManageableObject
- Retorna:
true
se este for umRealmCollection
managed,false
caso contrário.
-
contém
boolean contém(objeto @Nullable Object )
Testa se esteCollection
contém o objeto especificado. Retornatrue
se e somente se pelo menos um elementoelem
nesteCollection
atender ao seguinte requisito:(object==null ? elem==null : object.equals(elem))
.- Especificado por:
contains
na interfaceCollection<E>
- Parâmetros:
object
- o objeto a ser pesquisado.- Retorna:
true
se o objeto for um elemento desteCollection
,false
caso contrário.- Lançamentos:
NullPointerException
- se o objeto a procurar fornull
e esteCollection
não suportar elementosnull
.
-
-