Classe RealmObject

Adiciona um ouvinte de alterações a um RealmObject que será acionado se qualquer campo de valor ou campo RealmObject referenciado for alterado, ou o próprio campo RealmList for alterado.O registro de um ouvinte de alterações não impedirá que o RealmObject subjacente seja coletado o lixo. Se o RealmObject 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 Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmChangeListener<Person>() {
          @Override
          public void onChange(Person person) {
              // React to change
          }
      });
    }
}

Parâmetros

• object - RealmObject ao qual adicionar o ouvinte.

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

Lança

• IllegalArgumentException - se o object for null ou um objeto não gerenciado, ou o ouvinte de alterações for null .

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

• Exceção de estado ilegal - se você tentar adicionar um ouvinte dentro de uma transação.

Adiciona um ouvinte de alterações a um RealmObject para obter informações detalhadas sobre as alterações. O ouvinte será acionado se qualquer campo de valor ou campo RealmObject referenciado for alterado, ou o próprio campo RealmList for alterado.O registro de um ouvinte de alterações não impedirá que o RealmObject subjacente seja coletado o lixo. Se o RealmObject 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 Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmObjectChangeListener<Person>() {
          @Override
          public void onChange(Person person, ObjectChangeSet changeSet) {
              // React to change
          }
      });
    }
}

Parâmetros

• object - RealmObject ao qual adicionar o ouvinte.

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

Lança

• IllegalArgumentException - se o object for null ou um objeto não gerenciado, ou o ouvinte de alterações for null .

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

• Exceção de estado ilegal - se você tentar adicionar um ouvinte dentro de uma transação.

Adiciona um ouvinte de alterações a esse RealmObject que será acionado se qualquer campo de valor ou campo RealmObject referenciado for alterado, ou o próprio campo RealmList for alterado.O registro de um ouvinte de alterações não impedirá que o RealmObject subjacente seja coletado o lixo. Se o RealmObject 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 Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmChangeListener<Person>() {
          @Override
          public void onChange(Person person) {
              // 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 ou o objeto for um objeto não gerenciado.

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

• Exceção de estado ilegal - se você tentar adicionar um ouvinte dentro de uma transação.

Adiciona um ouvinte de alterações a este RealmObject para obter informações detalhadas sobre as alterações. O ouvinte será acionado se qualquer campo de valor ou campo RealmObject referenciado for alterado, ou o próprio campo RealmList for alterado.O registro de um ouvinte de alterações não impedirá que o RealmObject subjacente seja coletado o lixo. Se o RealmObject 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 Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmObjectChangeListener<Person>() {
          @Override
          public void onChange(Person person, ObjectChangeSet 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 ou o objeto for um objeto não gerenciado.

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

• Exceção de estado ilegal - se você tentar adicionar um ouvinte dentro de uma transação.

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

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

obj.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxObj, changes) -> doExpensiveWork(rxObj, changeså))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

Parâmetros

• object - Classe RealmObject que está sendo observada. Must be this class or its super types.

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 Observable que monitora as alterações neste RealmObject. Ele emitirá o RealmObject atual quando for assinado. Para cada atualização do RealmObject, um par que consiste no RealmObject e no ObjectChangeSet será enviado. O changeset será null na primeira vez que o RealmObject for emitido.

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

obj.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxObj, changes) -> doExpensiveWork(rxObj, 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 RxJava Flowable que monitora as alterações neste RealmObject. Ele emitirá o objeto atual quando for assinado. As atualizações de objetos serão emitidas continuamente à medida que o RealmObject for atualizado - onComplete nunca será chamado.

Ao encadear um RealmObject observável, use obj.<MyRealmObjectClass>asFlowable() para passar informações de tipo, caso contrário, o tipo dos seguintes observáveis será RealmObject .

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 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:

obj.asFlowable()
 .observeOn(Schedulers.computation())
 .map((rxObj) -> doExpensiveWork(rxObj))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

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

obj.asFlowable()
     .filter(obj -> obj.isLoaded())
     .first()
     .subscribe( ... ) // You only get the object once

Parâmetros

• object - Classe RealmObject que está sendo observada. Must be this class or its super types.

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 classpath.

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

Retorna um RxJava Flowable que monitora as alterações neste RealmObject. Ele emitirá o objeto atual quando for assinado. As atualizações de objetos serão emitidas continuamente à medida que o RealmObject for atualizado - onComplete nunca será chamado.

Ao encadear um RealmObject, use obj.<MyRealmObjectClass>asFlowable() para passar informações de tipo, caso contrário, o tipo dos seguintes observáveis será RealmObject .

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 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:

obj.asFlowable()
 .observeOn(Schedulers.computation())
 .map((rxObj) -> doExpensiveWork(rxObj))
 .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() :

obj.asFlowable()
     .filter(obj -> obj.isLoaded())
     .first()
     .subscribe( ... ) // You only get the object once

Parâmetros de tipo

• E - Classe RealmObject que está sendo observada. Must be this class or its super types.

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 .

Exclui o objeto do Realm com o qual está associado no momento. Após esse método ser chamado, o objeto será inválido e qualquer operação (leitura ou gravação) executada nele falhará com uma IllegalStateException.

Lança

• Exceção de estado ilegal - se o Realm correspondente estiver fechado ou em uma thread incorreta.

Exclui o objeto do Realm ao qual está associado no momento. Após esse método ser chamado, o objeto será inválido e qualquer operação (leitura ou gravação) executada nele falhará com uma IllegalStateException.

Lança

• Exceção de estado ilegal - se o Realm correspondente estiver fechado ou em uma thread incorreta.

Retorna um snapshot congelado deste objeto. A cópia congelada pode ser lida e consultada de qualquer tópico sem lançar um IllegalStateException .

Congelar um RealmObject também cria um Realm congelado que tem seu próprio ciclo de vida, mas se o Realm que gerou a collection original estiver totalmente fechado (ou seja, todas as instâncias em todos os threads estão fechadas), o Realm e o objeto congelados também serão fechados.

Objetos congelados podem ser consultados normalmente, mas tentar alterá-lo de qualquer forma ou tentar registrar um ouvinte criará uma IllegalStateException .

Observação: manter um grande número de objetos congelados com diferentes versões vivos 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 objeto.

Lança

• Exceção de estado ilegal - se esse método for chamado de dentro de uma transação de gravação.

Retorna um snapshot congelado deste objeto. A cópia congelada pode ser lida e consultada de qualquer tópico sem lançar um IllegalStateException .

Congelar um RealmObject também cria um Realm congelado que tem seu próprio ciclo de vida, mas se o Realm que gerou a collection original estiver totalmente fechado (ou seja, todas as instâncias em todos os threads estão fechadas), o Realm e o objeto congelados também serão fechados.

Objetos congelados podem ser consultados normalmente, mas tentar alterá-lo de qualquer forma ou tentar registrar um ouvinte criará uma IllegalStateException .

Observação: manter um grande número de objetos congelados com diferentes versões vivos 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 objeto.

Lança

• Exceção de estado ilegal - se esse método for chamado de dentro de uma transação de gravação.

retorna a Instância de Realm onde o model pertence.

Você não deve chamar Realm.close() em relação à instância retornada.

Parâmetros

• model - uma instância de RealmModel diferente de DinâmicoRealmObject .

Devoluções

Instância de realm onde o model pertence ou null se o model não for gerenciado.

Lança

• IllegalArgumentException - se for model null .

• Exceção de estado ilegal - se o model for uma instância de DynamicRealmObject ou se este objeto já tiver sido excluído ou o Realm correspondente já tiver sido fechado.

Retorna a instância do Realm onde este RealmObject pertence.

Você não deve chamar Realm.close() em relação à instância retornada.

Devoluções

Instância de domínio onde este objeto pertence ou null se este objeto não for gerenciado.

Lança

• Exceção de estado ilegal - se este objeto for uma instância de DynamicRealmObject ou se este objeto já tiver sido excluído ou o Realm correspondente já tiver sido fechado.

Retorna se este RealmObject está congelado ou não.

Devoluções

true se o RealmObject estiver congelado, false se não estiver.

Retorna se este RealmObject está congelado ou não.

Devoluções

true se o RealmObject estiver congelado, false se não estiver.

Verifica se a query usada para localizar este RealmObject foi concluída.Métodos Async como RealmQuery.findFirstAsync() retornam um RealmObject que representa o resultado futuro do RealmQuery . Pode ser considerado semelhante a um java.util.concurrent.Future a este respeito.

Depois que isLoaded() retornar true , o objeto representa o resultado da query mesmo que a query não tenha encontrado nenhum objeto que corresponda aos parâmetros da query. Nesse caso, o RealmObject se tornará um objeto"nulo".

Objetos "Null" representa null . Uma exceção é lançada se qualquer acessador for chamado, portanto, é importante também verificar isValid() antes de chamar qualquer método. Um padrão comum é:

Person person = realm.where(Person.class).findFirstAsync();
RealmObject.isLoaded(person); // == false
RealmObject.addChangeListener(person, new RealmChangeListener() {
     @Override
     public void onChange(Person person) {
         RealmObject.isLoaded(person); // always true here
         if (RealmObject.isValid(person)) {
             // It is safe to access the person.
         }
     }
});

Os RealmObjects síncronos são, por definição, bloqueantes, portanto, este método sempre retornará true para eles. Esse método retornará true se for chamado em um objeto não gerenciado (criado fora do Realm).

Parâmetros

• object - RealmObject para verificar.

Devoluções

true se a query tiver sido concluída, false se a query estiver em andamento.

Verifica se a query usada para localizar este RealmObject foi concluída.Métodos Async como RealmQuery.findFirstAsync() retornam um RealmObject que representa o resultado futuro do RealmQuery . Pode ser considerado semelhante a um java.util.concurrent.Future a este respeito.

Depois que isLoaded() retornar true , o objeto representa o resultado da query mesmo que a query não tenha encontrado nenhum objeto que corresponda aos parâmetros da query. Nesse caso, o RealmObject se tornará um objeto"nulo".

Objetos "Null" representa null . Uma exceção é lançada se qualquer acessador for chamado, portanto, é importante também verificar isValid() antes de chamar qualquer método. Um padrão comum é:

Person person = realm.where(Person.class).findFirstAsync();
person.isLoaded(); // == false
person.addChangeListener(new RealmChangeListener() {
     @Override
     public void onChange(Person person) {
         person.isLoaded(); // Always true here
         if (person.isValid()) {
             // It is safe to access the person.
         }
     }
});

Os RealmObjects síncronos são, por definição, bloqueantes, portanto, este método sempre retornará true para eles. Esse método retornará true se for chamado em um objeto não gerenciado (criado fora do Realm).

Devoluções

true se a query tiver sido concluída, false se a query estiver em andamento.

Verifica se este objeto é gerenciado pelo Realm. Um objeto gerenciado é apenas um invólucro em torno dos dados no arquivo Realm subjacente. Nas threads Looper, um objeto gerenciado será atualizado ao vivo para que sempre aponte para os dados mais recentes. É possível registrar um ouvinte de alterações usando addChangeListener(RealmModel, RealmChangeListener) para ser notificado quando as alterações acontecerem. Objetos gerenciados são confinados à thread para que não possam ser acessados de outras threads além daquele que os criou.

Se este método retornar false , o objeto não será gerenciado. Um objeto não gerenciado é apenas um objeto Java normal, portanto, pode ser analisado livremente entre threads, mas os dados no objeto não estão conectados ao Realm subjacente, portanto, não serão atualizados ao vivo.

É possível criar um managed objeto a partir de um objeto não gerenciado usando Realm.copyToRealm(RealmModel, ImportFlag...) . Um objeto não gerenciado pode ser criado a partir de um objeto gerenciado usando Realm.copyFromRealm(RealmModel) .

Devoluções

true se o objeto for managed, false se não for managed.

Verifica se o objeto é gerenciado pelo Realm. Um objeto gerenciado é apenas um wrapper em torno dos dados no Arquivo de Realm subjacente. Nas threads Looper, um objeto gerenciado será atualizado ao vivo para que sempre aponte para os dados mais recentes. É possível registrar um ouvinte de alterações usando addChangeListener(RealmChangeListener) para ser notificado quando as alterações acontecerem. Objetos gerenciados são confinados à thread para que não possam ser acessados de outras threads além daquele que os criou.

Se este método retornar false , o objeto não será gerenciado. Um objeto não gerenciado é apenas um objeto Java normal, portanto, pode ser analisado livremente entre threads, mas os dados no objeto não estão conectados ao Realm subjacente, portanto, não serão atualizados ao vivo.

É possível criar um managed objeto a partir de um objeto não gerenciado usando Realm.copyToRealm(RealmModel, ImportFlag...) . Um objeto não gerenciado pode ser criado a partir de um objeto gerenciado usando Realm.copyFromRealm(RealmModel) .

Devoluções

true se o objeto for managed, false se não for managed.

Verifica se o RealmObject ainda é válido para uso, ou seja, o RealmObject não foi excluído nem o io.realm.Realm foi fechado. Ele sempre retornará true para objetos não gerenciados.

Parâmetros

• object - RealmObject para verificar a validade.

Devoluções

true se o objeto ainda estiver acessível ou um objeto não gerenciado, false caso contrário.

Verifica se o RealmObject ainda é válido para uso, ou seja, o RealmObject não foi excluído nem o io.realm.Realm foi fechado. Ele sempre retornará true para objetos não gerenciados.

Note que isto pode ser utilizado para verificar a validade de certas condições como ser null quando observado.

realm.where(BannerRealm.class).equalTo("type", type).findFirstAsync().asFlowable()
     .filter(result.isLoaded() && result.isValid())
     .first()

Devoluções

true se o objeto ainda estiver acessível ou um objeto não gerenciado, false caso contrário.

Cria um bloqueio de query assíncrono. Isso também trigger os ouvintes registrados.Observação: Retornará true se for chamado para um objeto não gerenciado (criado fora do Realm).

Parâmetros

• object - RealmObject para forçar a carga.

Devoluções

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

Cria um bloqueio de query assíncrono. Isso também trigger os ouvintes registrados.Observação: Retornará true se for chamado para um objeto não gerenciado (criado fora do Realm).

Devoluções

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

Remove todos os ouvintes registrados do RealmObject fornecido.

Parâmetros

• object - RealmObject para remover todos os ouvintes.

Lança

• IllegalArgumentException - se o objeto for null ou não for gerenciado pelo Realm.

Remove um ouvinte registrado anteriormente no RealmObject fornecido.

Parâmetros

• object - RealmObject para remover o ouvinte.

• listener - a instância a ser removida.

Lança

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

• IllegalArgumentException - se o objeto for um RealmObject não gerenciado.

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

Remove um ouvinte registrado anteriormente no RealmObject fornecido.

Parâmetros

• object - RealmObject para remover o ouvinte.

• listener - a instância a ser removida.

Lança

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

• IllegalArgumentException - se o objeto for um RealmObject não gerenciado.

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

Remove um ouvinte registrado anteriormente.

Parâmetros

• listener - a instância a ser removida.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null ou o objeto for um objeto não gerenciado.

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

Remove um ouvinte registrado anteriormente.

Parâmetros

• listener - a instância a ser removida.

Lança

• IllegalArgumentException - se o ouvinte de alterações for null ou o objeto for um objeto não gerenciado.

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