Tutorial: Atlas Device Sync para .NET com MAUI

Adicione a propriedade priority

1. No projeto RealmTodo , expanda a pasta Models e abra o arquivo de classe Item .

2. Adicione a seguinte propriedade pública:

   [MapTo("priority")]
   public int? Priority { get; set; }

   Observe que definimos essa propriedade como anulável, o que garantirá que os Itens existentes em nosso banco de dados (que não têm uma propriedade Priority) continuem disponíveis.

Definir a prioridade ao criar ou modificar um item

1. O EditItemViewModel ViewModel é utilizado para criar novos itens e modificar itens existentes. Ao criar ou modificar um item, o usuário precisa da interface do usuário (e do código) para definir a prioridade de um item.

2. Adicione uma ObservableProperty para manter a prioridade:

   [ObservableProperty]
   private int? priority;

   Observação

   Atributo [ObservableProperty]

   O atributo [ObservableProperty] é uma feição fornecida pelo MVVM Toolkit para simplificar a vinculação de dados.

3. O método ApplyQueryAttributes age como um pouco de "construtor" para este modelo de visualização, verificando se um item existente está sendo passado à esta visualização para edição. Aqui, capturamos qualquer valor existente para exibir na visualização.

   Se estivermos editando um item existente, queremos definir a Prioridade do item existente: Priority = InitialItem.Priority;.

   Da mesma forma, se estivermos criando um novo item, defina a prioridade padrão para "Médio": Priority = 2;.

   Quando concluído, este método deve agora ter a seguinte aparência:

   public void ApplyQueryAttributes(IDictionary<string, object> query)
   {
         if (query.Count > 0 && query["item"] != null) // we're editing an Item
         {
            InitialItem = query["item"] as Item;
            Summary = InitialItem.Summary;
            Priority = InitialItem.Priority;
            PageHeader = $"Modify Item {InitialItem.Id}";
         }
         else // we're creating a new item
         {
            Summary = "";
            Priority = 2;
            PageHeader = "Create a New Item";
         }
   }

4. Finalmente, no método SaveItem() , queremos persistir o valor de Priority. Como estamos criando ou modificando um objeto gerenciado, as alterações estão envolvidas em uma chamada do realm.WriteAsync.

   Para o item existente, defina o InitialItem.Priority no objeto existente e para um novo item, defina a propriedade na chamada Add(). Seu bloco WriteAsync concluído deve ficar assim:

   await realm.WriteAsync(() =>
   {
      if (InitialItem != null) // editing an item
      {
         InitialItem.Summary = Summary;
         InitialItem.Priority = Priority;
      }
      else // creating a new item
      {
         realm.Add(new Item()
         {
               OwnerId = RealmService.CurrentUser.Id,
               Summary = summary,
               Priority = Priority
         });
      }
   });

Atualizar os elementos da interface do usuário

1. A tarefa final é adicionar os elementos da interface do usuário necessários para definir e mostrar a prioridade.

   Primeiro, no ItemsPage.xaml, adicionaremos um rótulo ao ListView que mostra a prioridade. Dentro do ViewCell, adicione um rótulo para exibir a prioridade do item:

   <Label Text="{Binding Priority}"
      HorizontalOptions="Center"
      VerticalOptions="Center"/>

2. Na EditItemsPage.xaml, adicionaremos dois elementos de UI: um seletor que permite ao usuário escolher qual nível de prioridade definir para o novo item e um rótulo para o seletor. Encontre o elemento Entry para definir o resumo e adicione os seguintes elementos abaixo dele:

   <Label Text="Priority:"/>
   <Picker x:Name="newItemPriority" SelectedIndex="{Binding Priority}">
      <Picker.Items>
            <x:String>Severe</x:String>
            <x:String>High</x:String>
            <x:String>Medium</x:String>
            <x:String>Low</x:String>
      </Picker.Items>
   </Picker>

Executar e testar

Nesse ponto, você pode executar o aplicativo novamente. Faça login usando a conta que você criou neste tutorial. Você verá o único item que criou anteriormente. Adicione um novo item e você verá que agora pode definir a prioridade. Escolha High para a prioridade e salve o item.

Agora volte para a página de dados do Atlas em seu navegador e atualize a coleção do Item. Você deve agora visualizar o novo Item com o campo priority adicionado e configurado para 1. Você também notará que o Item existente agora também tem um campo priority e está configurado para nulo, como mostrado na seguinte captura de tela:

clique para ampliar

Atualizar a assinatura

No arquivo RealmService.cs, definimos duas assinaturas Sincronização flexível. Um mostra apenas os itens criados pelo usuário atual, enquanto o outro mostra todos os itens de todos os usuários.

Vamos adicionar uma nova assinatura que mostra os itens do usuário atual que têm priority de 0 ou 1.

1. Na parte inferior da classe RealmService, adicione uma entrada ao enum SubscriptionType chamado "MyHighPriority":

   public enum SubscriptionType
   {
      Mine,
      MyHighPriority,
      All,
   }

2. Role para cima para encontrar o método GetQueryForSubscriptionType. É aqui que definimos as assinaturas.

   1. Copie o primeiro, onde subType == SubscriptionType.Mine, e cole-o em um bloco else if imediatamente abaixo.

   2. Defina o novo condicional para subType == SubscriptionType.MyHighPriority.

   3. Modifique essa nova query de assinatura para inserir uma query LINQ que ainda filtra por OwnerID e também por valores de prioridade menores que 2.

   4. Altere o nome da nova consulta para "myHighPri". Seu código será parecido com o seguinte:

   if (subType == SubscriptionType.Mine)
   {
         query = realm.All<Item>()
            .Where(i => i.OwnerId == CurrentUser.Id)
            .Where(i => i.Priority < 2);
         queryName = "mine";
   }
   else if (subType == SubscriptionType.MyHighPriority)
   {
         query = realm.All<Item>()
           .Where(i => i.OwnerId == CurrentUser.Id &&
                  i.Priority < 2);
         queryName = "myHighPri";
   }
   else if (subType == SubscriptionType.All)
   {
         query = realm.All<Item>();
         queryName = "all";
   }

3. No método GetCurrentSubscriptionType imediatamente acima, adicione o novo nome de assinatura à instrução switch, para que fique assim:

   return activeSubscription.Name switch
   {
       "all" => SubscriptionType.All,
       "mine" => SubscriptionType.Mine,
       "myHighPri" => SubscriptionType.MyHighPriority,
       _ => throw new InvalidOperationException("Unknown subscription type")
   };

4. Finalmente, abra a classe ItemsViewModel e encontre o método OnIsShowAllTasksChanged. Em vez de alterar a interface do usuário para habilitar 3 assinaturas, apenas substituiremos a assinatura "minha" existente pela nova. Altere o método SetSubscription para que ele fique assim:

   await RealmService.SetSubscription(realm, value
      ? SubscriptionType.All
      : SubscriptionType.MyHighPriority);

Executar e testar

Execute o aplicativo novamente. Se solicitado a fazê-lo, faça login usando a conta que você criou anteriormente neste tutorial.

Você deve esperar ver todos os itens criados que tenham uma prioridade de "Alta" (1) ou "Grave" (0). Se você ativar a opção "Mostrar todas as tarefas", todas as tarefas de todos os usuários devem aparecer.