Pacote io.realm.mongodb.sync

Interface SyncSession.ClientResetHandler

  • Todas as interfaces:
    ManuallyRecoverUnsyncedChangesStrategy, SyncClientResetStrategy
    Classe anexa:
    SyncSession
    @Deprecated
public static interface SyncSession.ClientResetHandler
extends ManuallyRecoverUnsyncedChangesStrategy
    Obsoleto.
    substituído por ManuallyRecoverUnsyncedChangesStrategy
    chamada de resposta para o evento específico conhecido como reinício do cliente, determinado pelo código de erro ErrorCode.CLIENT_RESET.

    Um Realm sincronizado pode precisar ser redefinido porque o Servidor MongoDB Realm encontrou um erro e teve que ser restaurado a partir de um backup ou porque passou muito tempo desde que o cliente se conectou ao servidor, então o servidor rotacionou os logs.

    O reinício do cliente, portanto, ocorre porque o servidor não tem as informações completas necessárias para deixar o cliente totalmente atualizado.

    O processo de redefinição é o seguinte: a cópia local do Realm é copiada em um diretório de recuperação para proteção e, em seguida, excluída do local original. Da próxima vez que o Realm para essa URL for aberto, o Realm será automaticamente baixado do MongoDB Realm e poderá ser usado normalmente.

    Os dados gravados no Realm após a cópia local do Realm particionar da cópia remota de backup estarão presentes na cópia de recuperação local do Arquivo de Realm. O Realm rebaixado conterá inicialmente apenas os dados presentes no momento em que o Realm foi copiado no servidor.

    O processo de reinício do cliente pode ser iniciado de duas maneiras:

    1. Execute ClientResetRequiredError.executeClientReset() manualmente. Todas as Instância de Realm devem ser fechadas antes que este método seja chamado.
    2. Se a redefinição do cliente não for executada manualmente, ela será executada automaticamente na próxima vez que todas as instâncias do Realm tiverem sido fechadas e reabertas. Isso provavelmente será quando o aplicativo for reiniciado.
    AVISO: qualquer gravação no arquivo Realm entre esse retorno de chamada e a redefinição do cliente tiver sido executada não será sincronizada com o MongoDB Realm. Essas alterações só estarão presentes no arquivo de backup. Portanto, é recomendável fechar todas as instâncias abertas do Realm o mais rápido possível.