Gravar em um Realm sincronizado - .NET SDK

Visão geral

Ao gravar dados em um domínio sincronizado usando o Flexible Sync, você usa as mesmas APIs que usa ao gravar em um domínio local. No entanto, há algumas diferenças de comportamento que devem ser levadas em conta.

Quando você escreve em um Realm sincronizado, suas operações de escrita devem corresponder aos dois itens a seguir:

• A query de assinatura de sincronização

• As permissões em seu App Services App

Se você tentar gravar dados que não correspondem à query de assinatura e à expressão de permissões, a gravação será revertida e lançará uma CompensatingWriteException. Você pode examinar os registros do App Services para ver detalhes sobre o motivo pelo qual a gravação foi negada.

Compensação de escritas

Quando um cliente tenta uma gravação "ilegal" de um objeto, ocorre o seguinte:

1. Como o Realm do cliente não tem nenhum conceito de gravações "ilegais", a gravação inicialmente é bem-sucedida até que o Realm resolva o conjunto de alterações com o backend do App Services.

2. Após a sincronização, o servidor aplica as regras e permissões. O servidor determina que o usuário não tem autorização para realizar a gravação.

3. O servidor envia uma operação de reversão, chamada de "escrita compensatória", de volta ao cliente.

4. O realm do cliente reverte a operação de escrita ilegal e lança um CompensatingWriteException.

Qualquer escrita do lado do cliente em um objeto entre a escrita ilegal e a escrita compensatória correspondente será perdida.

Na prática, isso pode parecer um objeto sendo gravado no Realm e desaparecer depois que o servidor enviar a gravação compensatória de volta ao cliente.

Quando um CompensatingWriteException é lançado, ele inclui um enumerável de objetos CompensatingWriteInfo . Cada objeto CompensatingWriteInfo contém propriedades que descrevem o tipo de objeto, sua chave primária e a razão pela qual o servidor executou a gravação compensatória.

Determinando quais dados são sincronizados

A regra que controla quais dados você pode gravar em um Realm sincronizado é a interseção da configuração do Realm Mobile Sync, das permissões do App Services e da query de assinatura do Flexible Sync que você usa quando abre o Realm.

Vejamos um exemplo de como esses componentes trabalham juntos:

{
  "name": "owner-read-write",
  "apply_when": {},
  "document_filters": {
    "read": { "ownerId": "%%user.id" },
    "write": { "ownerId": "%%user.id" }
  },
  "read": true,
  "write": true
}

realm.Subscriptions.Update(() =>
{
    var completedItemsQuery = realm
        .All<MyTask>()
        .Where(i => i.Status == "completed");
    realm.Subscriptions
        .Add(completedItemsQuery,
            new SubscriptionOptions() { Name = "completedItems" });
});