RLMRealm

Obtém uma instância do Realm padrão.

O Realm padrão é utilizado pelos métodos de classe RLMObject que não utilizam um parâmetro RLMRealm , mas de outra forma não é especial. O Realm padrão é mantido como default.realm no diretório documento da sua aplicação no iOS, no diretório de aplicação Support da sua aplicação no macOS e no diretório de Cache no tvOS.

O Realm padrão é criado usando o RLMRealmConfiguration padrão, que pode ser alterado por meio +[RLMRealmConfiguration setDefaultConfiguration:].

Obtém uma instância do Realm padrão vinculado à fila fornecida.

Em vez de ficarem confinados ao thread em que são abertos, os RLMRealms vinculados à fila estão confinados à fila fornecida. Eles podem ser acessados de qualquer thread, desde que seja de dentro de um despacho de blocos para a fila, e as notificações serão entregues na fila em vez do loop de eventos de um thread.

Os domínios só podem ser confinados a uma fila em série. As instâncias de RLMRealm confinadas em fila podem ser obtidas quando não estiverem nessa fila, mas tentar fazer qualquer coisa com essa instância sem primeiro despachá-la para a fila lançará uma exceção de thread incorreta.

O Realm padrão é criado usando o RLMRealmConfiguration padrão, que pode ser alterado por meio +[RLMRealmConfiguration setDefaultConfiguration:].

Obtém uma instância RLMRealm com a configuração fornecida.

Obtém uma instância RLMRealm com a configuração fornecida vinculada à fila fornecida.

Em vez de ficarem confinados ao thread em que são abertos, os RLMRealms vinculados à fila estão confinados à fila fornecida. Eles podem ser acessados de qualquer thread, desde que seja de dentro de um despacho de blocos para a fila, e as notificações serão entregues na fila em vez do loop de eventos de um thread.

Os domínios só podem ser confinados a uma fila em série. As instâncias de RLMRealm confinadas em fila podem ser obtidas quando não estiverem nessa fila, mas tentar fazer qualquer coisa com essa instância sem primeiro despachá-la para a fila lançará uma exceção de thread incorreta.

Obtém uma instância RLMRealm persistente em uma URL de arquivo especificada.

Abra de forma assíncrona um Realm e entregue-o a um bloco na fila fornecida.

A abertura de um Realm de forma assíncrona executará todo o trabalho necessário para colocar o Realm em um estado utilizável (como a execução de migrações potencialmente demoradas) em um thread em segundo plano antes de ser enviado para a fila fornecida. Além disso, os Realms sincronizados aguardam que todo o conteúdo remoto disponível no momento em que a operação começou seja baixado e esteja disponível localmente.

O realm passado para a função da chamada de resposta está confinado à fila da chamada de resposta como se -[RLMRealm realmWithConfiguration:queue:error] fosse usado.

O RLMSchema usado pelo Realm.

Indica se o Realm está atualmente envolvido em uma transação de escrita.

O objeto RLMRealmConfiguration que foi usado para criar esta instância RLMRealm .

Indica se este Realm contém algum objeto.

Indica se este Realm está congelado.

Retorna um snapshot congelado (imutável) deste Realm.

Um Realm congelado é uma visualização de snapshot imutável de uma versão específica dos dados de um Realm. Ao contrário das instâncias normais do RLMRealm, ele não é atualizado ao vivo para refletir as gravações feitas no Realm e pode ser acessado a partir de qualquer thread. Não é permitido gravar em um Realm congelado, e tentar iniciar uma transação de escrita lançará uma exceção.

Todos os objeto e collection lidos de um Realm congelado também serão congelados.

Retorna uma referência ativa deste Realm.

Todos os objetos e coleções lidos do Realm retornado não serão mais congelados. Este método retornará self se ainda não estiver congelado.

Grava uma cópia compactada e opcionalmente criptografada do Realm na URL local fornecida.

O arquivo de destino já não pode existir.

Observe que, se esse método for chamado de dentro de uma transação de gravação, os dados atuais serão gravados, não os dados do ponto em que a transação de escrita anterior foi confirmada.

Grava uma cópia do Realm em um determinado local especificado por uma determinada configuração.

Se a configuração fornecida for derivada de um RLMUser , este Realm será copiado com a funcionalidade de sincronização habilitada.

O arquivo de destino já não pode existir.

Verifica se o arquivo de Realm para a configuração fornecida existe localmente no disco.

Para Realms não sincronizados e não na memória, isso é equivalente a -[NSFileManager.defaultManager fileExistsAtPath:config.path]. Para Realms sincronizados, ele se encarrega de calcular o caminho real no disco com base no servidor, no caminho virtual e no usuário, como é feito ao abrir o Realm.

Exclui o Arquivo de Realm local e os arquivos temporários associados à configuração fornecida.

Isso exclui os arquivos ".realm", ".note" e ".management" que seriam criados ao abrir o Realm com a configuração fornecida. Ele não exclui o arquivo de bloqueio (que não contém dados persistentes e é recriado do zero toda vez que o Arquivo de Realm é aberto).

O Realm não deve estar atualmente aberto em nenhum thread ou em outro processo. Se for, isso retornará NO e relatará o erro RLMErrorAlreadyOpen. A tentativa de abrir o Realm em outro thread enquanto a exclusão está ocorrendo bloqueará (e, em seguida, criará um novo Realm e abrirá-o depois).

Se o Realm ainda não existir, isso retornará NO e relatará o erro NSFileNoSuchFileError;

Adiciona um manipulador de notificações para alterações nesse Realm e retorna um token de notificação.

Os manipuladores de notificações são chamados após cada transação de escrita ser confirmada, na thread atual ou em outras threads.

Os blocos manipuladores são chamados no mesmo thread em que foram adicionados e só podem ser adicionados em threads que estejam atualmente dentro de um loop de eventos. A menos que você esteja criando e executando especificamente um loop de eventos em um thread em segundo plano, esse normalmente será apenas o thread principal.

O bloco tem a seguinte definição:

typedef void(^RLMNotificationBlock)(RLMNotification notification, RLMRealm *realm);

Ele recebe os seguintes parâmetros:

• NSString *notificação: o nome da notificação recebida. Consulte RLMRealmNotification para obter informações sobre quais notificações são enviadas.

• RLMRealm *realm: o Realm para o qual ocorreu esta notificação.

Inicia uma transação de escrita no Realm.

Somente uma transação de escrita pode ser aberta por vez para cada Arquivo de Realm. As transações de escrita não podem ser aninhadas, e tentar iniciar uma transação de escrita em um Realm que já esteja em uma transação de escrita lançará uma exceção. As chamadas para beginWriteTransaction de instâncias RLMRealm para o mesmo Arquivo de Realm em outras threads ou outros processos serão bloqueadas até que a transação de escrita atual seja concluída ou cancelada.

Antes de iniciar a transação de escrita, o beginWriteTransaction atualiza a instância do RLMRealm para a Versão do Realm, como se o refresh tivesse sido chamado e gera notificações, se aplicável. Isso não tem efeito se o Realm já estiver atualizado.

Raramente é uma boa ideia que as transação de escrita abrangem vários ciclos do loop de eventos, mas se você desejar fazer isso, precisará garantir que o Realm que participa da transação de escrita seja mantido ativo até que a transação de escrita seja confirmada.

Confirma todas as operações de gravação na transação de escrita atual e termina a transação.

Após salvar as alterações, todos os blocos de notificação registrados nesta instância RLMRealm específica são invocados de forma síncrona. Os blocos de notificação registrados em outros threads ou em collection são invocados de forma assíncrona. Se você não quiser receber uma notificação específica para esta transação de escrita, consulte commitWriteTransactionWithoutNotifying:error:.

Esse método pode falhar se não houver espaço em disco suficiente disponível para salvar as gravações feitas ou devido a erros inesperados de E/S. Esta versão do método lança uma exceção quando ocorrem erros. Use a versão com um parâmetro de saída NSError se desejar lidar com erros.

Confirma todas as operações de gravação na transação de escrita atual e termina a transação.

Após salvar as alterações, todos os blocos de notificação registrados nesta instância RLMRealm específica são invocados de forma síncrona. Os blocos de notificação registrados em outros threads ou em collection são invocados de forma assíncrona. Se você não quiser receber uma notificação específica para esta transação de escrita, consulte commitWriteTransactionWithoutNotifying:error:.

Esse método pode falhar se não houver espaço em disco suficiente disponível para salvar as gravações feitas ou devido a erros inesperados de E/S.

Compromete todas as operações de gravação na transação de escrita atual, sem notificar blocos de notificação específicos das alterações.

Após salvar as alterações, todos os blocos de notificação registrados nesta instância RLMRealm específica são invocados de forma síncrona. Os blocos de notificação registrados em outros threads ou em collection estão agendados para serem invocados de forma assíncrona.

Você pode ignorar a notificação de blocos de notificações específicos sobre as alterações feitas nessa transação de escrita passando seus tokens de notificação associados. Isso é útil principalmente quando a transação de escrita está salvando as alterações já feitas na interface do usuário e você não deseja que o bloqueio de notificação tente reaplicar as mesmas alterações.

Os tokens passados para este método devem ser para notificações para esta instância RLMRealm específica. As notificações de threads diferentes não podem ser ignoradas usando esse método.

Esse método pode falhar se não houver espaço em disco suficiente disponível para salvar as gravações feitas ou devido a erros inesperados de E/S.

Reverte todas as gravações feitas durante a transação de escrita atual e encerra a transação.

Isso reverte todos os objetos no Realm para o estado em que estavam no início da transação de escrita e, em seguida, encerra a transação.

Isso restaura os dados dos objetos excluídos, mas não revigora as instâncias de objetos invalidados. Quaisquer RLMObjects que foram adicionados ao Realm serão invalidados em vez de se tornarem não gerenciados. Dado o seguinte código:

ObjectType *oldObject = [[ObjectType objectsWhere:@"..."] firstObject];
ObjectType *newObject = [[ObjectType alloc] init];

[realm beginWriteTransaction];
[realm addObject:newObject];
[realm deleteObject:oldObject];
[realm cancelWriteTransaction];

Tanto oldObject quanto newObject retornarão YES para isInvalidated, mas a reexecução da query que forneceu oldObject retornará novamente o objeto válido.

Os observadores da KVO em quaisquer objetos que foram modificados durante a transação serão notificados sobre a alteração de volta aos seus valores iniciais, mas nenhuma outra notificação será produzida por uma transação de escrita cancelada.

Executa ação contidas dentro do bloco fornecido dentro de uma transação de escrita.

Executa ação contidas dentro do bloco fornecido dentro de uma transação de escrita.

Executa ação contidas dentro do bloco fornecido dentro de uma transação de escrita.

Executa ação contidas dentro do bloco fornecido dentro de uma transação de escrita.

As transações de escrita não podem ser aninhadas, e tentar executar uma transação de escrita em um Realm que já esteja participando de uma transação de escrita lançará uma exceção. As chamadas para transactionWithBlock: de instâncias RLMRealm em outros threads serão bloqueadas até que a transação de escrita atual seja concluída.

Antes de iniciar a transação de escrita, o transactionWithBlock: atualiza a instância do RLMRealm para a Versão do Realm, como se o refresh tivesse sido chamado e gera notificações, se aplicável. Isso não tem efeito se o Realm já estiver atualizado.

Você pode ignorar a notificação de blocos de notificações específicos sobre as alterações feitas nessa transação de escrita passando seus tokens de notificação associados. Isso é útil principalmente quando a transação de escrita está salvando as alterações já feitas na interface do usuário e você não deseja que o bloqueio de notificação tente reaplicar as mesmas alterações.

Os tokens passados para este método devem ser para notificações para esta instância RLMRealm específica. As notificações de threads diferentes não podem ser ignoradas usando esse método.

Indica se o Realm está executando operações de gravação assíncrona no momento. Isso se torna YES após uma chamada para beginAsyncWriteTransaction, commitAsyncWriteTransaction ou asyncTransactionWithBlock:, e permanece assim até que todo o trabalho de gravação assíncrona agendado seja concluído.

Inicia uma transação de escrita assíncrona. Essa função inicia de forma assíncrona uma transação de escrita em um thread em segundo plano e, em seguida, invoca o bloqueio na thread ou fila original assim que a transação começa. Ao contrário de beginWriteTransaction, isso não bloqueará o thread de chamada se outro thread estiver atual dentro de uma transação de escrita e sempre retornará imediatamente. Várias chamadas para esta função (ou para as outras funções que executam transação de escrita assíncrona) enfileirarão os blocos a serem chamados na mesma ordem em que foram enfileirados. Isso inclui chamadas de dentro de um bloco de transação de escrita que, ao contrário da transação síncrona, são permitidas.

Confirma de forma assíncrona uma transação de escrita. A chamada retorna imediatamente, permitindo que o chamador continue enquanto a E/S é realizada em um thread dedicado em segundo plano. Isso pode ser usado independentemente de a transação de escrita ter sido iniciada com beginWriteTransaction ou beginAsyncWriteTransaction.

Confirma de forma assíncrona uma transação de escrita. A chamada retorna imediatamente, permitindo que o chamador continue enquanto a E/S é realizada em um thread dedicado em segundo plano. Isso pode ser usado independentemente de a transação de escrita ter sido iniciada com beginWriteTransaction ou beginAsyncWriteTransaction.

Confirma de forma assíncrona uma transação de escrita. A chamada retorna imediatamente, permitindo que o chamador continue enquanto a E/S é realizada em um thread dedicado em segundo plano. Isso pode ser usado independentemente de a transação de escrita ter sido iniciada com beginWriteTransaction ou beginAsyncWriteTransaction.

Cancela um bloco em fila para uma transação assíncrona. Isso pode cancelar um bloco passado para um início assíncrono ou uma confirmação assíncrona. O cancelamento de um início cancela totalmente a transação, enquanto o cancelamento de um commit apenas cancela a invocação da chamada de resposta de conclusão, e o commit ainda ocorrerá. A transação só pode ser cancelada antes que o bloco seja invocado, e chamar cancelAsyncTransaction: de dentro do bloco é um no-op.

Executa de forma assíncrona ação contidas no bloco fornecido dentro de uma transação de escrita. A transação de escrita é iniciada de forma assíncrona como se estivesse chamando beginAsyncWriteTransaction: e, por padrão, a transação é confirmada de forma assíncrona após a conclusão do bloco. Você também pode chamar explicitamente commitWriteTransaction ou cancelWriteTransaction de dentro do bloco para confirmar ou cancelar de forma síncrona a transação de escrita.

Executa de forma assíncrona ação contidas no bloco fornecido dentro de uma transação de escrita. A transação de escrita é iniciada de forma assíncrona como se estivesse chamando beginAsyncWriteTransaction: e, por padrão, a transação é confirmada de forma assíncrona após a conclusão do bloco. Você também pode chamar explicitamente commitWriteTransaction ou cancelWriteTransaction de dentro do bloco para confirmar ou cancelar de forma síncrona a transação de escrita.

Atualiza o Realm e os objeto managed pelo Realm para ponto para os dados mais recentes.

Se a versão do Realm for realmente alterada, as notificações do Realm e da collection serão enviadas para refletir as alterações. Isso pode levar algum tempo, pois as notificações de collection são preparadas em um thread em segundo plano. Como resultado, chamar esse método no thread principal não é aconselhável.

Defina esta propriedade como YES para atualizar automaticamente este Realm quando as alterações acontecerem em outros segmentos.

Se definido como YES (o padrão), as alterações feitas em outras threads serão refletidas nesse Realm no próximo ciclo do loop de eventos após as alterações serem confirmadas. Se definido como NO, você deverá chamar manualmente -refresh no Realm para atualizá-lo e obter os dados mais recentes.

Observe que, por padrão, os threads em segundo plano não têm um loop de eventos ativo e você precisará chamar manualmente -refresh para atualizar para a versão mais recente, mesmo que autorefresh esteja definido como YES.

Mesmo com esta propriedade habilitada, você ainda pode chamar o -refresh a qualquer momento para atualizar o Realm antes que a atualização automática ocorra.

As transações de gravação ainda sempre avançarão um Realm para a versão mais recente e produzirão notificações locais no commit, mesmo que a atualização automática esteja desabilitada.

Desativar autorefresh em um Realm sem referências fortes a ele não terá nenhum efeito, e autorefresh será revertido para YES na próxima vez que o Realm for criado. Normalmente, isso é irrelevante, pois significa que não há nada para atualizar (já que RLMObject s, RLMArray s gerenciados e RLMResults têm referências fortes para o Realm que os gerencia), mas significa que a configuração RLMRealm.defaultRealm.autorefresh = NO em application:didFinishLaunchingWithOptions: e somente depois o armazenamento de objetos de Realm não funcionará.

Padrão é YES.

Invalida todos os RLMObjects, RLMResults, RLMLinkingObjects e RLMArrays managed pelo Realm.

Um Realm mantém um bloqueio de leitura na versão dos dados acessados por ele, de modo que as alterações feitas no Realm em diferentes threads não modifiquem ou excluam os dados vistos por este Realm. A chamada desse método libera o bloqueio de leitura, permitindo que o espaço usado no disco seja reutilizado por transação de escrita posterior, em vez de aumentar o arquivo. Esse método deve ser chamado antes de executar operações de bloqueio longas em um thread em segundo plano no qual você leu anteriormente dados do Realm que não são mais necessários.

Todas as instâncias RLMObject, RLMResults e RLMArray obtidas desta instância RLMRealm na thread atual são invalidadas. RLMObjects e RLMArrays não podem ser usados. RLMResults ficará vazio. O próprio Realm permanece válido e uma nova transação de leitura é implicitamente iniciada na próxima vez que os dados forem lidos do Realm.

Chamar esse método várias vezes seguidas sem ler nenhum dado do Realm, ou antes de ler qualquer dado do Realm, é um modo autônomo.

Retorna o mesmo objeto que o referenciado quando o RLMThreadSafeReference foi criado pela primeira vez, mas resolvido para o Realm atual para este thread. Retorna nil se este objeto foi excluído depois que a referência foi criada.

Adiciona um objeto ao Realm.

Depois de adicionado, esse objeto é considerado managed pelo Realm. Pode ser recuperado usando os seletores objectsWhere: em RLMRealm e em subclasses de RLMObject.

Quando adicionados, todos os relacionamentos filhos referenciados por este objeto também serão adicionados ao Realm se ainda não estiverem nele.

Se o objeto ou quaisquer objeto já estiverem sendo managed por um Realm diferente, uma exceção será lançada. Use -[RLMObject createInRealm:withObject:] para inserir uma cópia de um managed objeto em um Realm diferente.

O objeto a ser adicionado deve ser válido e não pode ter sido excluído anteriormente de um Realm (ou seja, isInvalidated deve ser NO).

Adiciona todos os objeto de uma collection ao Realm.

Isso é equivalente a chamar addObject: para cada objeto em uma collection.

Adiciona ou atualiza um objeto existente no Realm.

O objeto fornecido deve ter uma chave primária designada. Se não existirem objetos no Realm com o mesmo valor de chave primária, o objeto será inserido. Caso contrário, o objeto existente é atualizado com quaisquer valores alterados.

Assim como em addObject:, o objeto ainda não pode ser managed por um diferente Realm. Use -[RLMObject createOrUpdateInRealm:withValue:] para copiar valores para outro Realm.

Se houver uma propriedade ou valor de KVC em object cujo valor for nulo, e ele corresponder a uma propriedade anulável em um objeto existente sendo atualizado, essa propriedade anulável será definida como nula.

Adiciona ou atualiza todos os objeto em uma collection no Realm.

Isso é equivalente a chamar addOrUpdateObject: para cada objeto em uma collection.

Exclui um objeto do Realm. Depois que o objeto é excluído, ele é considerado invalidado.

Exclui um ou mais objetos do Realm.

Isso é equivalente a chamar deleteObject: para cada objeto em uma collection.

Exclui todos os objetos do Realm.

Representa as assinaturas ativas para este Realm, que podem ser usadas para adicionar/remover/atualizar e pesquisar assinaturas de Flexible Sync. Obter as assinaturas de um Realm configurado local ou baseado em partição lançará uma exceção.

Retorna a versão do esquema de um Realm em uma determinada URL local.

Executa o bloco de migração da configuração do Realm fornecido em um Realm no caminho fornecido.

Este método é chamado automaticamente ao abrir um Realm pela primeira vez e não precisa ser chamado explicitamente. Você pode optar por chamar esse método para controlar exatamente quando e como as migrações são realizadas.

As instâncias do RLMRealm são armazenadas em cache internamente pelo Realm e não podem ser criadas diretamente.

Use +[RLMRealm defaultRealm], +[RLMRealm realmWithConfiguration:error:] ou +[RLMRealm realmWithURL] para obter uma referência a um RLMRealm.

As instâncias do RLMRealm são armazenadas em cache internamente pelo Realm e não podem ser criadas diretamente.

Use +[RLMRealm defaultRealm], +[RLMRealm realmWithConfiguration:error:] ou +[RLMRealm realmWithURL] para obter uma referência a um RLMRealm.

Obtenha o RLMSyncSession usado por este Realm. Não terá valor se este não for um Realm sincronizado.