Classe RealmResults

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

Registrar um ouvinte de alterações não impedirá que o RealmResults subjacente seja coletado o lixo. Se o RealmResults 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 RealmResults<Person> results; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      results = realm.where(Person.class).findAllAsync();
      results.addChangeListener(new OrderedRealmCollectionChangeListener<RealmResults<Person>>() {
          @Override
          public void onChange(RealmResults<Person> persons, 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.

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

Registrar um ouvinte de alterações não impedirá que o RealmResults subjacente seja coletado o lixo. Se o RealmResults 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 RealmResults<Person> results; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      results = realm.where(Person.class).findAllAsync();
      results.addChangeListener(new RealmChangeListener<RealmResults<Person>>() {
          @Override
          public void onChange(RealmResults<Person> persons) {
              // 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 RealmResults. Ele emitirá o RealmResults atual quando for inscrito. Para cada atualização do RealmResult, um par que consiste no RealmResults e no OrderedCollectionChangeSet será enviado. O changeset será null na primeira vez que um RealmResults for emitido.

O RealmResults será emitido continuamente à medida que o RealmResults 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:

realm.where(Foo.class).findAllAsync().asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxResults, changes) -> doExpensiveWork(rxResults, 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 RealmResults. Ele emitirá o RealmResults atual quando for inscrito. O RealmResults será emitido continuamente à medida que o RealmResults 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 RealmResults ativo. Isso significa que, se você precisar fazer processamento adicional, é recomendável observar os valores em um agendador de computação:

realm.where(Foo.class).findAllAsync().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() :

realm.where(Foo.class).findAllAsync().asFlowable()
     .filter(results -> results.isLoaded())
     .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.

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

Retorna uma representação JSON das correspondências de um RealmQuery . Os ciclos serão retornados como índices de linha. Este é um método auxiliar usado para inspecionar dados ou, para fins de depuração, esse método pode puxar uma string grande, o que pode causar um erro de OutOfMemory.

Devoluções

representação de string de uma array JSON contendo entradas do RealmQuery resultante .

Retorna false se os resultados ainda não estiverem carregados, true se estiverem carregados.

Devoluções

true se a query tiver sido concluída e os dados estiverem disponíveis, false se a query ainda estiver em execução em segundo plano.

Cria um bloqueio de query assíncrono. Isso também trigger qualquer RealmChangeListener registrado quando a query for concluída.

Devoluções

true se concluiu a query com sucesso, false caso contrário.

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 .

Define o valor binário do campo fornecido em todos os objeto na collection.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo binário.

Define o valor boolean do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo booleano.

Define o valor byte do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, é uma propriedade de chave primária ou não é um campo de bytes.

Define o valor Date do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um Date campo .

Define o valor Decimal128 do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um Decimal128 campo .

Define o valor double do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo duplo.

Define o valor float do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo flutuante.

Define o valor int do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo inteiro.

Substitui o RealmList no campo fornecido em todos os objeto nesta collection.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• list - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, não for um campo RealmList, se os objetos na lista não forem gerenciados ou o tipo dos objetos na lista estiver errado.

Define o valor long do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo longo .

Define o valor para null para o campo fornecido em todos os objeto na collection.

Parâmetros

• fieldName - nome do campo a ser atualizado.

Lança

• IllegalArgumentException - se o nome do campo não existir ou for uma propriedade de chave primária.

• Exceção de estado ilegal - se o campo não puder conter null valores.

Define uma referência a outro objeto no campo fornecido em todos os objetos da collection.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo objeto referenciado por este campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo de referência do objeto .

Define o valor ObjectId do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um ObjectId campo .

Define o valor short do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um campo curto.

Define o valor String do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, é uma propriedade de chave primária ou não é um campo de string .

Define o valor UUID do campo fornecido em todos os objetos na coleção.

Parâmetros

• fieldName - nome do campo a ser atualizado.

• value - novo valor para o campo.

Lança

• IllegalArgumentException - se o nome do campo não existir, for uma propriedade de chave primária ou não for um UUID campo .

Atualiza o campo fornecido por fieldName em todos os objetos dentro do resultado da query.

Este método tentará converter automaticamente números e booleanos fornecidos como String para o tipo apropriado. Por exemplo, "10" será convertido em 10 se o tipo de campo for RealmFieldType.Integer .

Usar os setters digitados como setInt(string, int) será mais rápido do que usar este método.

Parâmetros

• fieldName - campo para atualizar

• value - valor com o qual atualizar.

Lança

• IllegalArgumentException - se o campo não puder ser encontrado, não puder ser atualizado ou o argumento não corresponder ao tipo de campo ou não puder ser convertido para corresponder ao tipo de campo subjacente.

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 coleção original permanece inalterada.

Substitui

sort na classe OrderedRealmCollectionImpl

Retorna um RealmQuery , que pode ser utilizado para fazer query de objeto específicos desta collection.

Devoluções

um objeto RealmQuery.