sincronização baseada em partição - Java SDK

Abrir um Realm sincronizado enquanto estiver online

Para abrir um Realm sincronizado, chame getInstanceAsync(), passando um objeto SyncConfiguration . O código a seguir demonstra como criar um Realm com configurações de sincronização específicas criadas usando um objeto SyncConfiguration :

SyncConfiguration config = new SyncConfiguration.Builder(app.currentUser(), PARTITION)
        .allowQueriesOnUiThread(true)
        .allowWritesOnUiThread(true)
        .build();
Realm.getInstanceAsync(config, new Realm.Callback() {
    @Override
    public void onSuccess(Realm realm) {
        Log.v(
                "EXAMPLE",
                "Successfully opened a realm with reads and writes allowed on the UI thread."
        );
    }
});

val config = SyncConfiguration.Builder(app.currentUser(), PARTITION)
    .allowQueriesOnUiThread(true)
    .allowWritesOnUiThread(true)
    .build()
Realm.getInstanceAsync(config, object : Realm.Callback() {
    override fun onSuccess(realm: Realm) {
        Log.v("EXAMPLE", "Successfully opened a realm with reads and writes allowed on the UI thread.")
    }
})

O código acima mostra como abrir o domínio de forma assíncrona usando getInstanceAsync(). Você também pode abrir um domínio de forma síncrona usando getInstance(), que retorna um domínio aberto antes de sincronizar todos os dados do backend. No entanto, isso pode levar a inconsistências temporárias de dados durante o download dos dados remotos e geralmente não é recomendado. Você pode usar a opção de configuração waitForInitialRemoteData() para forçar o SDK a buscar dados remotos antes de abrir o domínio para evitar essas inconsistências.

O valor da partição especifica qual subconjunto dos seus dados sincronizar. Normalmente, esse é um ID de usuário, ID de projeto, ID de loja ou algum outro identificador de categoria em seu aplicativo que tenha relevância específica para o usuário atual.

Abrir um Realm sincronizado enquanto estiver offline

Você pode abrir um Realm sincronizado quando estiver off-line com a mesma sintaxe usada para abrir um Realm sincronizado enquanto estiver on-line. Nem todos os SDKs seguem esse padrão, portanto, os desenvolvedores de várias plataformas devem consultar a documentação de cada SDK para saber mais.

Atualizando o código do cliente após a migração

A migração automática da sincronização baseada em partição para a Flexible Sync não exige nenhuma alteração no código do cliente. No entanto, para suportar essa funcionalidade, o Realm lida automaticamente com as diferenças entre os dois modos de sincronização por:

• Criando automaticamente assinaturas de Flexible Sync para cada Tipo de objeto de Realm em que partitionKey == partitionValue.

• Injetando um campo partitionKey em cada objeto, se ainda não existir um. Isso é necessário para a assinatura automática do Flexible Sync.

Se você precisar fazer atualizações no código do cliente após a migração, considere atualizar a base de código do cliente para remover a funcionalidade de migração oculta. Talvez você queira atualizar a base de código do cliente quando:

• Você adiciona um novo modelo ou altera um modelo na base de código do cliente

• Você adiciona ou altera funcionalidades que envolvem a leitura ou escrita de Objeto de Realm

• Você deseja implementar um controle mais refinado sobre quais dados você sincroniza

Faça essas alterações para converter seu código de cliente de sincronização baseada em partição para usar o Flexible Sync:

• Atualize seu SyncConfiguration.Builder para usar o Flexible Sync. Isso envolve remover o partitionValue e adicionar um conjunto de assinaturas iniciais, se necessário.

• Adicione propriedades relevantes aos seus modelos de objetos para usar em suas assinaturas do Flexible Sync. Por exemplo, você pode adicionar uma propriedade ownerId para permitir que um usuário sincronize somente seus próprios dados.

• Remova assinaturas automáticas do Flexible Sync. Se você não adicionou assinaturas iniciais em SyncConfiguration.Builder, crie manualmente as assinaturas relevantes.

Para obter exemplos de estratégias de permissões de Flexible Sync , incluindo exemplos de como modelar dados para essas estratégias, consulte o Guia de permissões de Device Sync .