Lista de domínios de classe

Adiciona o objeto especificado no final desta lista.

1. RealmLists não gerenciados: é possível adicionar objetos gerenciados e não gerenciados. Se adicionar objetos gerenciados a um RealmList não gerenciado, eles não serão copiados para o Realm novamente se usarem o Realm.copyToRealm(RealmModel, ImportFlag...) posteriormente.

2. managed RealmLists: é possível adicionar objeto não managed a uma RealmList que já é managed. Nesse caso, o objeto será copiado de forma transparente para o Realm usando Realm.copyToRealm(RealmModel, ImportFlag...) ou Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) se tiver uma chave primária.

Parâmetros

• object - o objeto a ser adicionado.

Devoluções

sempre true .

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

Substitui

add na classe AbstractList

Insere o objeto especificado nesta Lista no local especificado. O objeto é inserido antes de qualquer elemento anterior no local especificado. Se o local for igual ao tamanho desta Lista, o objeto será adicionado no final.

1. RealmLists não gerenciados: é possível adicionar objetos gerenciados e não gerenciados. Se adicionar objetos gerenciados a um RealmList não gerenciado, eles não serão copiados para o Realm novamente se usarem o Realm.copyToRealm(RealmModel, ImportFlag...) posteriormente.

2. managed RealmLists: é possível adicionar objeto não managed a uma RealmList que já é managed. Nesse caso, o objeto será copiado de forma transparente para o Realm usando Realm.copyToRealm(RealmModel, ImportFlag...) ou Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) se tiver uma chave primária.

Parâmetros

• location - o índice no qual inserir.

• element - o elemento a ser adicionado.

Lança

• Exceção de estado ilegal - se a instância de Realm tiver sido fechada ou o objeto de contêiner tiver sido removido.

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

Substitui

add na classe AbstractList

Adiciona um ouvinte de alterações a este RealmList .

Registrar um ouvinte de alterações não impedirá que o RealmList subjacente seja coletado o lixo. Se o RealmList for coletado como lixo, o ouvinte de alterações deixará de ser acionado. Para evitar isso, mantenha uma referência forte pelo tempo apropriado, por exemplo, em uma variável de classe.

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

Parâmetros

• listener - o ouvinte de alterações a ser notificado.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null .

• Exceção de estado ilegal - se você tentar adicionar um ouvinte de um não Looper ou android.app.IntentService tópico.

Adiciona um ouvinte de alterações a este RealmList .

Registrar um ouvinte de alterações não impedirá que o RealmList subjacente seja coletado o lixo. Se o RealmList for coletado como lixo, o ouvinte de alterações deixará de ser acionado. Para evitar isso, mantenha uma referência forte pelo tempo apropriado, por exemplo, em uma variável de classe.

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

Parâmetros

• listener - o ouvinte de alterações a ser notificado.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null .

• Exceção de estado ilegal - se você tentar adicionar um ouvinte de um não Looper ou android.app.IntentService tópico.

Retorna um Rx Observable que monitora as alterações neste RealmList. Ele emitirá o RealmList atual quando estiver inscrito. Para cada atualização no RealmList, um par que consiste no RealmList e no OrderedCollectionChangeSet será enviado. O changeset será null na primeira vez que um RealmList for emitido.

O RealmList será emitido continuamente à medida que o RealmList for atualizado - onComplete nunca será chamado.

Itens emitidos a partir de Realm Observables são congelados (consulte congelar() . Isso significa que eles são imutáveis e podem ser lidos em qualquer thread.

Realm Observables sempre emitem itens do thread que contém o Realm ativo. Isso significa que, se você precisar fazer processamento adicional, é recomendável observar os valores em um agendador de computação:

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

Devoluções

RxJava Observable que chama apenas onNext . Ele nunca chamará onComplete ou OnError .

Lança

• UnsupportedOperationException - se a estrutura RxJava necessária não estiver no caminho de classe ou se a instância do Realm correspondente não suportar RxJava.

• Exceção deestado ilegal - se o Realm não tiver sido aberto em uma thread Looper .

Retorna um Rx Flowable que monitora as alterações neste RealmList. Ele emitirá o RealmList atual quando for inscrito. O RealmList será emitido continuamente à medida que o RealmList for atualizado - onComplete nunca será chamado.

Itens emitidos de Realm Flowables são congelados (consulte congelar() . Isso significa que eles são imutáveis e podem ser lidos em qualquer thread.

Os Realm Flowables sempre emitem itens do thread que mantém o RealmList ativo. Isso significa que, se você precisar fazer processamento adicional, é recomendável observar os valores em um agendador de computação:

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

Se você quiser que o asFlowable() pare de emitir itens, você pode instruir o RxJava a emitir apenas somente o primeiro item usando o operador first() :

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

Devoluções

RxJava Observable que chama apenas onNext . Ele nunca chamará onComplete ou OnError .

Lança

• UnsupportedOperationException - se a estrutura RxJava necessária não estiver no caminho de classe ou se a instância do Realm correspondente não suportar RxJava.

Retorna a média de um determinado campo.

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.

Remove todos os elementos desta lista, deixando-a vazia. Este método não remove os objetos do Realm.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

Substitui

clear na classe AbstractList

Retorna true se a lista contiver o elemento especificado quando anexado a um Realm. Esse método executará uma query do Realm nativo storage engine para localizar rapidamente o elemento especificado.

Se a lista não estiver anexada a um Realm, o padrão List.contains(Object) a implementação ocorrerá.

Parâmetros

• object - o elemento cuja presença nesta lista será testada.

Devoluções

true se esta lista contiver o elemento especificado, caso contrário false .

Substitui

contains na classe AbstractCollection

Cria um snapshot deste OrderedRealmCollection .

Devoluções

o snapshot da collection.

Isso exclui todos os objetos da collection do Realm subjacente e da collection.

Devoluções

true se os objetos foram excluídos, false caso contrário.

Exclui o primeiro objeto do Realm. Isso também o remove desta collection.

Devoluções

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

Exclui o último objeto do Realm. Isso também o remove desta collection.

Devoluções

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

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

Devoluções

o primeiro objeto ou o padrão fornecido.

Obtém o primeiro objeto da collection.

Devoluções

o primeiro objeto.

Retorna o elemento no local especificado nesta lista.

Parâmetros

• location - o índice do elemento a ser retornado.

Devoluções

o elemento no índice especificado.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

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

Substitui

get na classe AbstractList

Retorna a Instância de Realm à qual esta collection 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 lista.

Devoluções

Instância de Realm à qual esta collection pertence ou null se a collection não for gerenciada.

Lança

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

Verifica se uma collection já terminou de carregar seus dados.

Devoluções

true se os dados tiverem sido carregados e estiverem disponíveis, false se os dados ainda estiverem sendo carregados.

Verifica se a collection é managed pelo Realm. Uma coleta gerenciada é apenas um invólucro que envolve os dados no arquivo de Realm subjacente. Nos threads do Looper, uma coleção gerenciada será atualizada ao vivo para que sempre aponte para os dados mais recentes. As coleções gerenciadas são confinadas de threads para que não possam ser acessadas de outros threads além daquele que as criou.Se esse método retornar false , a coleção não será gerenciada. Uma coleção não gerenciada é apenas uma coleção java normal, portanto, não será atualizada em tempo real.

Devoluções

true se esta for uma RealmCollection gerenciada, false caso contrário.

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

Devoluções

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

Substitui

iterator na classe AbstractList

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

Devoluções

o último objeto ou o padrão fornecido.

Obtém o último objeto da collection.

Devoluções

o último objeto.

Substitui

listIterator na classe AbstractList

Substitui

listIterator na classe AbstractList

Bloqueia a collection até que todos os dados estejam disponíveis.

Devoluções

true se os dados puderem ser carregados com sucesso, false caso contrário.

Localiza o valor máximo de um campo.

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.

Encontra a data máxima.

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.

Localiza o valor mínimo de um campo.

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.

Encontra a data mínima.

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.

Move um objeto de uma posição para outra, mantendo uma lista de tamanho fixo. Os RealmObjects serão deslocados para que nenhum valor null seja introduzido.

Parâmetros

• oldPos - índice do RealmObject a ser movido.

• newPos - posição alvo. Se newPos < antigoPos, o objeto no local será deslocado para a direita. Se antigaPos < newPos, indexes > antigaPos será deslocada uma vez para a esquerda.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

• java.lang.IndexOutOfBoundsException - se alguma posição estiver fora de [0, tamanho()].

Remove uma instância do objeto especificado deste Collection se houver. Essa implementação itera sobre esse Collection e testa cada elemento e retornado pelo iterador, se e é igual ao objeto fornecido. Se object != null , este teste será realizado usando object.equals(e) , caso contrário, usando object == null . Se um elemento igual ao objeto fornecido for encontrado, o método remove será chamado no iterador e true será retornado, false caso contrário. Se o iterador não oferecer suporte à remoção de elementos, um UnsupportedOperationException será lançado.

Parâmetros

• object - o objeto a ser removido.

Devoluções

true se este Collection for modificado, false caso contrário.

Lança

• ClassCastException - se o objeto passado não for do tipo correto.

• NullPointerException - se object for null .

Substitui

remove na classe AbstractCollection

Remove o objeto no local especificado desta lista.

Parâmetros

• location - o índice do objeto a ser removido.

Devoluções

o objeto removido.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

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

Substitui

remove na classe AbstractList

Remove todas as ocorrências neste Collection de cada objeto no Collection especificado. Após este método retornar nenhum dos elementos no Collection passado pode ser encontrado neste Collection mais.

Essa implementação itera no Collection e testa cada elemento e retornado pelo iterador, se ele está contido no Collection especificado. Se este teste for positivo, o método remove será chamado no iterador.

Parâmetros

• collection - a collection de objeto a serem removidos.

Devoluções

true se este Collection for modificado, false caso contrário.

Lança

• ClassCastException - se um ou mais elementos de não forem collection do tipo correto.

• NullPointerException - se collection for null .

Substitui

removeAll na classe AbstractCollection

Remove todos os ouvintes de alterações definidos pelo usuário.

Lança

• Exceção deestado ilegal - se você tentar remover ouvintes de um thread que não seja do Looper .

Remove o ouvinte de alterações especificado.

Parâmetros

• listener - o ouvinte de alterações a ser removido.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null .

• Exceção deestado ilegal - se você tentar remover um ouvinte de um thread que não seja do Looper .

Remove o ouvinte de alterações especificado.

Parâmetros

• listener - o ouvinte de alterações a ser removido.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null .

• Exceção deestado ilegal - se você tentar remover um ouvinte de um thread que não seja do Looper .

Substitui o elemento no local especificado nesta lista pelo objeto especificado.

1. RealmLists não gerenciados: é possível adicionar objetos gerenciados e não gerenciados. Se adicionar objetos gerenciados a um RealmList não gerenciado, eles não serão copiados para o Realm novamente se usarem o Realm.copyToRealm(RealmModel, ImportFlag...) posteriormente.

2. managed RealmLists: é possível adicionar objeto não managed a uma RealmList que já é managed. Nesse caso, o objeto será copiado de forma transparente para o Realm usando Realm.copyToRealm(RealmModel, ImportFlag...) ou Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...) se tiver uma chave primária.

Parâmetros

• location - o índice no qual colocar o objeto especificado.

• object - o objeto a ser adicionado.

Devoluções

o elemento anterior no índice.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

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

Substitui

set na classe AbstractList

Retorna o número de elementos neste List .

Devoluções

o número de elementos neste List .

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.

Substitui

size na classe AbstractCollection

Classifica uma collection com base nos campos fornecidos e nas ordens de classificação.

Devoluções

um novo RealmResults classificado será criado e retornado. A collection original permanece inalterada.

Classifica uma collection com base nos campos fornecidos e nas ordens de classificação.

Devoluções

um novo RealmResults classificado será criado e retornado. A collection original permanece inalterada.

Classifica uma collection com base no campo fornecido e na ordem de classificação.

Devoluções

um novo RealmResults classificado será criado e retornado. A collection original permanece inalterada.

Classifica uma collection com base no campo fornecido em ordem crescente.

Devoluções

um novo RealmResults classificado será criado e retornado. A collection original permanece inalterada.

Calcula a soma de um determinado campo.

Devoluções

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.

Substitui

toString na classe AbstractCollection

Retorna um RealmQuery, que pode ser usado para fazer query de objetos específicos desta classe.

Devoluções

um objeto RealmQuery.

Lança

• Exceção de estado ilegal - se a Instância de Realm tiver sido fechada ou o objeto principal tiver sido removido.