inscrição
Um conjunto de assinaturas é uma visão imutável de todas as assinaturasatuais de um determinado Realm que foi configurado para Flexible Sync.
O Flexible Sync é uma maneira de definir quais dados são sincronizados de e para o dispositivo usando o RealmQuerys. A query e seus metadados são representados por uma Assinatura.
Um conjunto de assinaturas define assim todos os dados que estão disponíveis para o dispositivo e sendo sincronizados com o servidor. Se o conjunto de assinaturas encontrar um erro, por exemplo, contendo uma query inválida, todo o conjunto de assinaturas entrará em um estado SubscriptionSetState.ERROR e nenhuma sincronização ocorrerá até que o erro seja corrigido.
Se uma assinatura for removida, os dados correspondentes também serão, mas ela será removida apenas do dispositivo. Ele não é excluído no servidor.
É possível modificar um conjunto de assinaturas enquanto estiver offline, mas uma modificação não é aceita pelo servidor antes que BaseSubscriptionSet.state retorne SubscriptionSetState.COMplete, o que exige que o dispositivo esteja online.
É possível aguardar que o conjunto de assinaturas seja sincronizado com o servidor usando waitForSynchronization.
Propriedades
Se o estado retornar SubscriptionSetState.ERROR, este método retornará o motivo. Os erros podem ser corrigidos modificando a assinatura adequadamente e, em seguida, chamando SubscriptionSet.waitForSynchronization.
O estado atual do SubscriptionSet. Consulte SubscriptionSetState para obter mais detalhes sobre cada estado.
Funções
Encontre a assinatura com um nome fornecido.
Encontre a primeira assinatura que contém a query fornecida. É possível que várias assinaturas nomeadas contenham a mesma query.
Atualize o estado do conjunto de assinaturas, para que reflita o estado subjacente mais recente das assinaturas.
Modifique o conjunto de assinaturas. Se uma exceção for lançada durante a atualização, nenhuma alteração será aplicada. Se a atualização for bem-sucedida, esse conjunto de assinaturas será atualizado com o estado modificado.
Aguarde o conjunto de subscrições sincronizar com o servidor. Ele retornará quando o servidor aceitar o conjunto de query e tiver baixado dados para elas, ou se ocorrer um erro.