Pacote io.realm

Classe OrderedRealmCollectionSnapshot<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

io.realm.OrderedRealmCollectionSnapshot<E>

Todas as interfaces implementadas:

io.realm.internal.Freezable<RealmCollection<E>>, io.realm.internal.ManageableObject, OrderedRealmCollection<E>, RealmCollection<E>, Iterable<E>, Collection<E>, List<E>

public class OrderedRealmCollectionSnapshot<E>
extends AbstractList<E>

Um OrderedRealmCollectionSnapshot é um tipo especial de OrderedRealmCollection. Ele pode ser criado ligando para OrderedRealmCollection.createSnapshot(). Ao contrário RealmResults e RealmList, seu tamanho e ordem dos elementos nunca serão alterados após a criação.

OrderedRealmCollectionSnapshot é útil ao fazer alterações que podem impacto o tamanho ou a ordem da collection em loops simples. Por exemplo:

 
 final RealmResults<Dog>  dogs = realm.where(Dog.class).findAll();
 final OrderedRealmCollectionSnapshot<Dog> snapshot = dogs.createSnapshot();
 final int dogsCount = snapshot.size(); // dogs.size() == snapshot.size() == 10
 realm.executeTransaction(new Realm.Transaction() {
     /@Override
     public void execute(Realm realm) {
         for (int i = 0; i < dogsCount; i++) {
         // This won't work since RealmResults is always up-to-date, its size gets decreased by 1 after every loop. An
         // IndexOutOfBoundsException will be thrown after 5 loops.
         // dogs.deleteFromRealm(i);
         snapshot.deleteFromRealm(i); // Deletion on OrderedRealmCollectionSnapshot won't change the size of it.
         }
     }
 });
 
 

Resumo do campo

Campos

Modificador e tipo	Campo	Descrição
io.realm.BaseRealm	baseRealm	A instância BaseRealm na qual reside esta collection.

Resumo do método

Modificador e tipo	Método	Descrição
void	add(int index, E element)	Obsoleto.
boolean	add(E element)	Obsoleto.
boolean	addAll(int location, Collection<? extends E> collection)	Obsoleto.
boolean	addAll(Collection<? extends E> collection)	Obsoleto.
double	average(String fieldName)	Retorna a média de um determinado campo.
void	clear()	Obsoleto.
boolean	contains(Object object)	Pesquisar este OrderedRealmCollection para o objeto especificado.
OrderedRealmCollectionSnapshot<E>	createSnapshot()	Cria um snapshot a partir deste OrderedRealmCollection.
boolean	deleteAllFromRealm()	Isso exclui todos os objetos da collection do Realm subjacente.
boolean	deleteFirstFromRealm()	Exclui o primeiro objeto do Realm.
void	deleteFromRealm(int location)	Exclui o objeto no índice fornecido do Realm.
boolean	deleteLastFromRealm()	Exclui o último objeto do Realm.
E	first()	Obtém o primeiro objeto da collection.
E	first(E defaultValue)	Obtém o primeiro objeto da collection.
OrderedRealmCollection<E>	freeze()
E	get(int location)	Retorna o elemento no local especificado nesta lista.
Realm	getRealm()	Retorna a instância Realm à qual esta coleção pertence.
boolean	isFrozen()
boolean	isLoaded()	Verifica se uma collection já terminou de carregar seus dados.
boolean	isManaged()	Um RealmResults ou um OrderedRealmCollectionSnapshot é sempre uma managed collection.
boolean	isValid()	Verifica se a collection ainda é válida para uso, ou seja, a instância Realm não foi fechada.
Iterator<E>	iterator()	Retorna um iterador para os resultados de uma query.
E	last()	Obtém o último objeto da collection.
E	last(E defaultValue)	Obtém o último objeto da collection.
ListIterator<E>	listIterator()	Retorna um iterador de lista para os resultados de uma query.
ListIterator<E>	listIterator(int location)	Retorna um iterador de lista nos resultados de uma query.
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.
E	remove(int index)	Obsoleto.
boolean	remove(Object object)	Obsoleto.
boolean	removeAll(Collection<?> collection)	Obsoleto.
boolean	retainAll(Collection<?> collection)	Obsoleto.
E	set(int location, E object)	Obsoleto.
int	size()	Retorna o número de elementos neste resultado da query.
RealmResults<E>	sort(String fieldName)	Não suportado por OrderedRealmCollectionSnapshot.
RealmResults<E>	sort(String[] fieldNames, Sort[] sortOrders)	Não suportado por OrderedRealmCollectionSnapshot.
RealmResults<E>	sort(String fieldName, Sort sortOrder)	Não suportado por OrderedRealmCollectionSnapshot.
RealmResults<E>	sort(String fieldName1, Sort sortOrder1, String fieldName2, Sort sortOrder2)	Não suportado por OrderedRealmCollectionSnapshot.
Number	sum(String fieldName)	Calcula a soma de um determinado campo.
RealmQuery<E>	where()	Obsoleto.

Métodos herdados da classe java.util.Lista de resumos

equals, hashCode, indexOf, lastIndexOf, subList

Métodos herdados da classe java.util.Coleção abstrata

containsAll, isEmpty, toArray, toArray, toString

Métodos herdados da classe java.lang.objeto

getClass, notify, notifyAll, wait, wait, wait

Métodos herdados da interface java.util.collection

parallelStream, removeIf, stream, toArray

Métodos herdados da interface java.lang.Iterável

forEach

Métodos herdados da interface java.util.Lista

containsAll, equals, hashCode, indexOf, isEmpty, lastIndexOf, replaceAll, sort, spliterator, subList, toArray, toArray

Detalhes do campo

baseRealm

public final io.realm.BaseRealm baseRealm

A instância BaseRealm na qual reside esta collection.

Aviso: este campo está exposto apenas para uso interno e não deve ser usado.

Detalhes do método

Tamanho

public int size()

Retorna o número de elementos neste resultado da query.

Especificado por:

size na interface Collection<E>

Especificado por:

size na interface List<E>

Retorna:

o número de elementos neste resultado da query.

sort

public RealmResults<E> sort(String fieldName)

Não suportado por OrderedRealmCollectionSnapshot . Em vez disso, use "sort()" no OrderedRealmCollection original.

Especificado por:

sort na interface OrderedRealmCollection<E>

Parâmetros:

fieldName - o nome do campo pelo qual classificar. Somente campos do tipo booleano, curto, int, longo, flutuante, duplo, Data e String são permitidos.

Retorna:

um novo RealmResults ordenado será criado e devolvido. A collection original permanece inalterada.

Lançamentos:

UnsupportedOperationException

sort

public RealmResults<E> sort(String fieldName,
                            Sort sortOrder)

Não suportado por OrderedRealmCollectionSnapshot . Em vez disso, use "sort()" no OrderedRealmCollection original.

Especificado por:

sort na interface OrderedRealmCollection<E>

Parâmetros:

fieldName - o nome do campo pelo qual classificar. Somente campos do tipo booleano, curto, int, longo, flutuante, duplo, Data e String são permitidos.

sortOrder - a direção pela qual classificar.

Retorna:

um novo RealmResults ordenado será criado e devolvido. A collection original permanece inalterada.

Lançamentos:

UnsupportedOperationException

sort

public RealmResults<E> sort(String fieldName1,
                            Sort sortOrder1,
                            String fieldName2,
                            Sort sortOrder2)

Não suportado por OrderedRealmCollectionSnapshot . Em vez disso, use "sort()" no OrderedRealmCollection original.

Especificado por:

sort na interface OrderedRealmCollection<E>

Parâmetros:

fieldName1 - nome do primeiro campo. Somente campos do tipo booleano, curto, int, longo, flutuante, duplo, Data e String são permitidos.

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

fieldName2 - nome do segundo campo. Somente campos do tipo booleano, curto, int, longo, flutuante, duplo, Data e String são permitidos.

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

Retorna:

um novo RealmResults ordenado será criado e devolvido. A collection original permanece inalterada.

Lançamentos:

UnsupportedOperationException

sort

public RealmResults<E> sort(String[] fieldNames,
                            Sort[] sortOrders)

Não suportado por OrderedRealmCollectionSnapshot . Em vez disso, use "sort()" no OrderedRealmCollection original.

Especificado por:

sort na interface OrderedRealmCollection<E>

Parâmetros:

fieldNames - uma array de nomes de campos para classificar. Somente campos do tipo booleano, curto, int, longo, flutuante, duplo, Data e String são permitidos.

sortOrders - as instruções para classificar por.

Retorna:

um novo RealmResults ordenado será criado e devolvido. A collection original permanece inalterada.

Lançamentos:

UnsupportedOperationException

ONDE

@Deprecated
public RealmQuery<E> where()

Obsoleto.

Não suportado por OrderedRealmCollectionSnapshot . Em vez disso, use "where()" no OrderedRealmCollection original.

Retorna:

um objeto RealmQuery.

Lançamentos:

UnsupportedOperationException

Veja também:

RealmQuery

isLoaded

public 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

carga booleana pública()

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.

createSnapshot

public OrderedRealmCollectionSnapshot<E> createSnapshot()

Cria um snapshot a partir deste OrderedRealmCollection.

Especificado por:

createSnapshot na interface OrderedRealmCollection<E>

Retorna:

o snapshot da collection.

Veja também:

OrderedRealmCollectionSnapshot

congelar

public OrderedRealmCollection<E> freeze()

deleteFromRealm

public void deleteFromRealm(int location)

Exclui o objeto no índice fornecido do Realm. O objeto no índice fornecido se tornará inválido. Apenas retorna se o objeto já for inválido.

Especificado por:

deleteFromRealm na interface OrderedRealmCollection<E>

Parâmetros:

location - o índice da array identificando o objeto a ser removido.

Lançamentos:

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

IllegalStateException - se o Realm estiver fechado ou o método for chamado da thread errada.

deleteFirstFromRealm

public boolean deleteFirstFromRealm()

Exclui o primeiro objeto do Realm. O primeiro objeto se tornará inválido.

Especificado por:

deleteFirstFromRealm na interface OrderedRealmCollection<E>

Retorna:

true se um objeto foi excluído, false caso contrário.

Lançamentos:

IllegalStateException - se o Realm estiver fechado ou o método for chamado na thread errada.

deleteLastFromRealm

public boolean deleteLastFromRealm()

Exclui o último objeto do Realm. O último objeto se tornará inválido.

Especificado por:

deleteLastFromRealm na interface OrderedRealmCollection<E>

Retorna:

true se um objeto foi excluído, false caso contrário.

Lançamentos:

IllegalStateException - se o Realm estiver fechado ou o método for chamado da thread errada.

deleteAllFromRealm

public boolean deleteAllFromRealm()

Isso exclui todos os objetos da collection do Realm subjacente. Todos os objetos no snapshot da collection se tornarão inválidos.

Especificado por:

deleteAllFromRealm na interface RealmCollection<E>

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.

IsFrozen

public boolean isFrozen()

é válido

public boolean isValid()

Verifica se a collection ainda é válida para uso, ou seja, a instância Realm não foi fechada. Ele sempre retornará true para uma coleção não gerenciada.

Especificado por:

isValid na interface io.realm.internal.ManageableObject

Especificado por:

isValid na interface RealmCollection<E>

Retorna:

true se ainda for válido para usar ou uma collection não gerenciada, false caso contrário.

isManaged

public boolean isManaged()

Um RealmResults ou um OrderedRealmCollectionSnapshot é sempre uma managed collection.

Especificado por:

isManaged na interface io.realm.internal.ManageableObject

Especificado por:

isManaged na interface RealmCollection<E>

Retorna:

true.

Veja também:

RealmCollection.isManaged()

contém

boolean público contém(objeto @Nullable
                        Object )

Pesquisar este OrderedRealmCollection para o objeto especificado.

Especificado por:

contains na interface Collection<E>

Especificado por:

contains na interface List<E>

Especificado por:

contains na interface RealmCollection<E>

Substitui:

contains na aula AbstractCollection<E>

Parâmetros:

object - o objeto a ser pesquisado.

Retorna:

true se object é um elemento deste OrderedRealmCollection, false caso contrário.

obter

@Nullable
public E get(localização int)

Retorna o elemento no local especificado nesta lista.

Especificado por:

get na interface List<E>

Especificado por:

get na aula AbstractList<E>

Parâmetros:

location - o índice do elemento a ser retornado.

Retorna:

o elemento no índice especificado.

Lançamentos:

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

primeiro

@Nullable
public E first()

Obtém o primeiro objeto da collection.

Especificado por:

first na interface OrderedRealmCollection<E>

Retorna:

o primeiro objeto.

primeiro

@Nullable E public E first( @Nullable E defaultValue)

Obtém o primeiro objeto da collection. Se a collection estiver vazia, o padrão fornecido será usado.

Especificado por:

first na interface OrderedRealmCollection<E>

Retorna:

o primeiro objeto ou o padrão fornecido.

último

@Nullable
public E last()

Obtém o último objeto da collection.

Especificado por:

last na interface OrderedRealmCollection<E>

Retorna:

o último objeto.

último

@Nullable
public E last(@Nullable
              E defaultValue)

Obtém o último objeto da collection. Se a collection estiver vazia, o padrão fornecido será usado.

Especificado por:

last na interface OrderedRealmCollection<E>

Retorna:

o último objeto ou o padrão fornecido.

iterador

public Iterator<E> iterator()

Retorna um iterador para os resultados de uma query. Qualquer alteração no Realm durante a iteração fará com que este iterador lance um ConcurrentModificationException se acessado.

Especificado por:

iterator na interface Collection<E>

Especificado por:

iterator na interface Iterable<E>

Especificado por:

iterator na interface List<E>

Substitui:

iterator na aula AbstractList<E>

Retorna:

um iterador sobre os elementos desta lista.

Veja também:

Iterator

listIterador

public ListIterator<E> listIterator()

Retorna um iterador de lista para os resultados de uma query. Qualquer alteração no Realm durante a iteração fará com que o iterador lance um ConcurrentModificationException se acessado.

Especificado por:

listIterator na interface List<E>

Substitui:

listIterator na aula AbstractList<E>

Retorna:

um ListItizer nos elementos desta lista.

Veja também:

ListIterator

listIterador

public ListIterator<E> listIterator(int location)

Retorna um iterador de lista nos resultados de uma query. Qualquer alteração no Realm durante a iteração fará com que o iterador lance um ConcurrentModificationException se acessado.

Especificado por:

listIterator na interface List<E>

Substitui:

listIterator na aula AbstractList<E>

Parâmetros:

location - o índice no qual iniciar a iteração.

Retorna:

um ListItizer nos elementos desta lista.

Lançamentos:

IndexOutOfBoundsException - se location < 0 || location > size().

Veja também:

ListIterator

min

Número público min(String fieldName)

Localiza o valor mínimo de um campo.

Especificado por:

min na interface RealmCollection<E>

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 valores null são ignorados.

minDate

data pública minDate(String fieldName)

Encontra a data mínima.

Especificado por:

minDate na interface RealmCollection<E>

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 valores null são ignorados.

max

Número público máximo (String fieldName)

Localiza o valor máximo de um campo.

Especificado por:

max na interface RealmCollection<E>

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 valores null são ignorados.

maxDate

@Nullable
public Date maxDate(String fieldName)

Encontra a data máxima.

Especificado por:

maxDate na interface RealmCollection<E>

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 valores null são ignorados.

Lançamentos:

IllegalArgumentException - se fieldName não for um campo de data.

soma

soma de número público (string fieldName )

Calcula a soma de um determinado campo.

Especificado por:

sum na interface RealmCollection<E>

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 valores null são ignorados.

média

média dupla pública (String fieldName)

Retorna a média de um determinado campo.

Especificado por:

average na interface RealmCollection<E>

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 valores null são ignorados.

remover

@Deprecated
public E remove(índice int)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

remove na interface List<E>

Substitui:

remove na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException

remover

@Deprecated
public boolean remove (objeto de objeto)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

remove na interface Collection<E>

Especificado por:

remove na interface List<E>

Substitui:

remove na aula AbstractCollection<E>

Lançamentos:

UnsupportedOperationException

Remover todos

@Deprecated
public boolean removeAll(Collection<?> collection)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

removeAll na interface Collection<E>

Especificado por:

removeAll na interface List<E>

Substitui:

removeAll na aula AbstractCollection<E>

Lançamentos:

UnsupportedOperationException

set

Conjunto E público @Deprecated (localização int, objeto E)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

set na interface List<E>

Substitui:

set na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException

ReterTodos

@Deprecated
public boolean retainAll(Collection<?> collection)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

retainAll na interface Collection<E>

Especificado por:

retainAll na interface List<E>

Substitui:

retainAll na aula AbstractCollection<E>

Lançamentos:

UnsupportedOperationException

Limpar

@Deprecated
public void clear()

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

clear na interface Collection<E>

Especificado por:

clear na interface List<E>

Substitui:

clear na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException - sempre.

adicionar

@Deprecated
adição booleana pública(elemento E)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

add na interface Collection<E>

Especificado por:

add na interface List<E>

Substitui:

add na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException - sempre.

adicionar

@Deprecated
public void add(int index,
                E element)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

add na interface List<E>

Substitui:

add na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException - sempre.

addAll

@Deprecated
public boolean addAll(int location,
                      Collection<? extends E> collection)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

addAll na interface List<E>

Substitui:

addAll na aula AbstractList<E>

Lançamentos:

UnsupportedOperationException - sempre.

addAll

@Deprecated
public boolean addAll(Collection<? extends E> collection)

Obsoleto.

Não suportado por RealmResults e OrderedRealmCollectionSnapshot.

Especificado por:

addAll na interface Collection<E>

Especificado por:

addAll na interface List<E>

Substitui:

addAll na aula AbstractCollection<E>

Lançamentos:

UnsupportedOperationException - sempre.

getRealm

public Realm getRealm()

Retorna a instância Realm à qual esta coleção pertence.

Chamar Closeable.close() na instância retornada não é recomendado, pois é o mesmo que chamá-la na instância original do Realm, o que pode fazer com que o Realm feche totalmente, invalidando o resultado da query.

Retorna:

Realm instância à qual esta collection pertence.

Lançamentos:

IllegalStateException - se o Realm for uma instância de DynamicRealm ou se o Realm já estiver fechado.