Classe dynamicRealm

Adiciona um ouvinte de alterações ao Realm.Os ouvintes serão executados quando as alterações forem confirmadas por este ou outro thread.

Realm instâncias de domínio são armazenadas em cache por thread. Por esse motivo, é importante lembrar de remover os ouvintes novamente usando removeChangeListener(RealmChangeListener) ou removeAllChangeListeners() . Não fazer isso pode causar vazamentos de memória.

Parâmetros

• listener - o ouvinte de alterações.

Lança

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

Retorna um RxJava Flowable que monitora as alterações nesse Realm. Ele emitirá o estado atual quando for assinado. Os itens serão emitidos continuamente à medida que o Realm for atualizado - onComplete nunca será chamado.

Os itens emitidos do Realm Flowables estã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 tópico 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.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxRealm -> doExpensiveWork(rxRealm))
 .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.asFlowable().first().subscribe( ... ); // You only get the results once

Devoluções

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

Substitui

asFlowable na classe BaseRealm

Instancia e adiciona um novo objeto incorporado ao Realm.Esse método só deve ser usado para criar objetos de tipos marcados como incorporados.

Parâmetros

• className - o nome da classe do objeto a ser criado.

• parentObject - O objeto principal, que deve manter uma referência ao objeto incorporado. Se a propriedade principal for uma lista, o objeto incorporado será adicionado ao final dessa lista.

• parentProperty - a propriedade na classe principal que contém a referência.

Devoluções

o objeto incorporado recém-criado.

Lança

• IllegalArgumentException - se clazz não for uma classe incorporada ou se a propriedade na classe principal não puder conter objetos do tipo apropriado.

Cria um objeto com uma determinada chave primária. As classes sem uma chave primária definida devem usar createObject(string) } .

Devoluções

o novo objeto. Todos os campos terão valores padrão para seu tipo, exceto o campo de chave primária que terá o valor fornecido.

Lança

• RealmException - se o objeto não puder ser criado porque a chave primária é inválida.

• Exceção de estado ilegal - se o modelo cláusulas não tiver uma chave primária definida.

• IllegalArgumentException - se o não primaryKeyValue tiver um valor que possa ser convertido para o valor esperado.

Instancia e adiciona um novo objeto ao Realm.

Parâmetros

• className - o nome da classe do objeto a ser criado.

Devoluções

o novo objeto.

Lança

• RealmException - se o objeto não puder ser criado.

Exclui todos os objetos da classe especificada do Realm.

Parâmetros

• className - a classe para a qual todos os objetos devem ser removidos.

Lança

• Exceção de estado ilegal - se o Realm for fechado ou chamado de um thread incorreto.

Executa uma determinada transação no dynamicRealm. getTransaction () e commitTransaction() serão chamados automaticamente. Se alguma exceção for lançada durante a transação, cancelTransaction() será chamado em vez de commitTransaction().

Chamar esse método a partir do thread da interface do usuário lançará uma RealmException . Isso pode resultar em uma queda de armações ou até mesmo de ANRs. Recomendamos chamar esse método de um thread que não seja da interface do usuário ou usar executeTransactionAsync(Transaction) .

Parâmetros

• transaction - transação a ser executada.

Lança

• IllegalArgumentException - se for transaction null .

• RealmException - se chamado a partir do thread da UI, a menos que uma opção explícita tenha sido declarada em RealmConfiguration.Builder.allowWritesOnUiThread(boolean) .

Semelhante a executeTransactionAsync(Transaction) , mas também aceita chamadas de resposta OnSuccess e OnError.

Parâmetros

• transaction - transação a ser executada.

• onSuccess - chamada de resposta invocada quando a transação é bem-sucedida.

• onError - chamada de resposta invocada em caso de falha da transação.

Devoluções

um RealmAsyncTask representando uma tarefa cancelável.

Lança

• IllegalArgumentException - se for transaction nullou se o Realm for aberto a partir de outro thread.

Semelhante a executeTransactionAsync(Transaction) , mas também aceita um retorno de chamada OnError.

Parâmetros

• transaction - transação a ser executada.

• onError - chamada de resposta invocada em caso de falha da transação.

Devoluções

um RealmAsyncTask representando uma tarefa cancelável.

Lança

• IllegalArgumentException - se for transaction nullou se o Realm for aberto a partir de outro thread.

Semelhante a executeTransactionAsync(Transaction) , mas também aceita um retorno de chamada de resposta OnSuccess .

Parâmetros

• transaction - transação a ser executada.

• onSuccess - chamada de resposta invocada quando a transação é bem-sucedida.

Devoluções

um RealmAsyncTask representando uma tarefa cancelável.

Lança

• IllegalArgumentException - se for transaction nullou se o Realm for aberto a partir de outro thread.

Semelhante a executeTransaction(Transaction) , mas é executado de forma assíncrona em um thread de trabalho.

Parâmetros

• transaction - transação a ser executada.

Devoluções

um RealmAsyncTask representando uma tarefa cancelável.

Lança

• IllegalArgumentException - se for transaction nullou se o Realm for aberto a partir de outro thread.

Retorna um snapshot congelado do Realm atual. Este Realm pode ser lido e consultado de qualquer tópico sem lançar um IllegalStateException . Um Realm congelado tem seu próprio ciclo de vida e pode ser fechado chamando close(), mas fechar totalmente o Realm que gerou a cópia congelada também fechará o Realm congelado.

Os dados congelados podem ser consultados normalmente, mas tentar alterá-los de qualquer forma ou tentar registrar qualquer ouvinte criará uma IllegalStateException .

Observação: manter um grande número de Realms com versões diferentes ativos pode ter um impacto negativo no tamanho do arquivo do Realm. Para evitar tal situação, é possível definir RealmConfiguration.Builder.maxNumberOfAtiveVersions(long) .

Devoluções

uma cópia congelada deste Realm.

Substitui

freeze na classe BaseRealm

Construtor estático de Realm que retorna uma variante dinâmica da Instância de Realm definida por io.realm.RealmConfiguration fornecido. Os Realms dinâmicos não se importam com schemaVersion e esquemas, portanto, abrir um dynamicRealm nunca trigger uma migração.

Devoluções

o dynamicRealm definido pela configuração.

Lança

• RealmFileException - se ocorrer um erro ao acessar o arquivo Realm subjacente.

• IllegalArgumentException - se configuration argumento for null .

A criação da primeira Instância de Realm por RealmConfiguration em um processo pode levar algum tempo, pois todo o código de inicialização precisa ser executado nesse ponto (configuração do Realm, validação de esquemas e criação de dados iniciais). Esse método coloca o trabalho de inicialização em um thread de background e entrega a Instância de Realm ao thread do chamador de forma assíncrona após a conclusão da inicialização.

Parâmetros

• configuration - RealmConfiguration usada para abrir o Realm.

• callback - invocado para retornar os resultados.

Devoluções

um RealmAsyncTask representando uma tarefa cancelável.

Lança

• IllegalArgumentException - se um RealmConfiguration nulo ou um Callback nulo for fornecido.

• Exceção de estado ilegal - se for chamado de um não Looper ou android.app.IntentService tópico.

Retorna o esquema mutável para esse Realm.

Devoluções

O RealmSchema para este Realm.

Substitui

getSchema na classe BaseRealm

Verifica se este io.realm.Realm contém algum objeto.

Devoluções

true se vazio, @{code false} caso contrário.

Substitui

isEmpty na classe BaseRealm

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 .

Retorna um RealmQuery, que pode ser usado para query a classe fornecida.

Parâmetros

• className - a classe do objeto que deve ser query.

Devoluções

um RealmQuery, que pode ser usado para fazer query de objetos específicos do tipo fornecido.

Lança

• IllegalArgumentException - se a turma não existir.