Tutorial: Atlas Device Sync para Swift com Swift UI

Adicionar uma propriedade ao modelo

Agora que você confirmou que tudo está funcionando como o esperado, podemos adicionar alterações. Neste tutorial, decidimos que queremos adicionar uma propriedade "priority" a cada Item para que possamos filtrar os Itens por suas prioridades. A propriedade de prioridade utiliza um enum PriorityLevel para restringir os valores possíveis.

Para fazer isso, siga estas etapas:

1. Abra o App.xcodeproj no Xcode.

2. Abra o arquivo de classe Item.swift.

3. Adicione a seguinte propriedade à classe Item:

   @Persisted var priority: PriorityLevel

4. Adicione também um PriorityLevel PersistableEnum abaixo da classe Item:

   class Item: Object, ObjectKeyIdentifiable {
      @Persisted(primaryKey: true) var _id: ObjectId
      @Persisted var isComplete = false
      @Persisted var summary: String
      @Persisted var owner_id: String
      @Persisted var priority: PriorityLevel
   }
   enum PriorityLevel: Int, PersistableEnum, CaseIterable {
      case severe = 0
      case high = 1
      case medium = 2
      case low = 3
      var description: String {
         switch self {
         case .severe: return "Severe"
         case .high: return "High"
         case .medium: return "Medium"
         case .low: return "Low"
         }
      }
   }

   PersistableEnum é o protocolo que marca os tipos de enum como persistíveis diretamente no Realm. Definimos o tipo do enum como Int aqui em vez de String para que possamos consultar com base em um nível de prioridade numérica mais tarde. Usamos uma propriedade computada description para exibir uma representação em string da prioridade na interface do usuário.

Definir a prioridade ao criar um novo item

1. No diretório Views, vá para CreateItemView.swift. Adicione uma nova propriedade @State sob a propriedade itemSummary existente. Por enquanto, defina o valor padrão como prioridade média:

   @State var itemSummary = ""
   @State var priority = PriorityLevel.medium

2. Agora, no corpo Form, adicione um seletor que permita ao usuário escolher qual nível de prioridade definir no novo item. Localize o Section que contém os botões e insira o seguinte código acima dele:

   Section(header: Text("Priority")) {
       Picker(selection: $priority, label: Text("Set priority")) {
           ForEach(PriorityLevel.allCases, id: \.self) { priority in
               Text(priority.description)
           }
       }
   }

3. Agora, vá até o Button(action: que define os valores de newItem quando o usuário pressiona o botão Save. Adicione uma linha abaixo de newItem.summary para definir também a propriedade priority:

   newItem.summary = itemSummary
   newItem.priority = priority

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. O item existente não tem um campo priority.

Atualizar a assinatura

No arquivo ContentView.swift, criamos a inscrição da Sincronização Flexível que define quais documentos sincronizamos com o dispositivo e a conta do usuário. Procure a variável let config = user.flexibleSyncConfiguration(initialSubscriptions: onde definimos as assinaturas iniciais. No método subscriptions.append(), você pode ver que, no momento, estamos assinando todos os documentos em que a propriedade owner_id corresponde ao ID do usuário autenticado. Queremos manter isso, mas sincronizar apenas os itens marcados como de prioridade Alta ou Grave.

É por isso que definimos o enum PriorityLevel para o tipo Int, em que a prioridade mais alta (grave) tem valor 0 e a prioridade mais baixa (baixa) tem valor 3. Podemos fazer comparações diretas entre um Int e a propriedade priority. Para fazer isso, atualize a instrução de consulta para incluir documentos em que a prioridade é igual ou menor que PriorityLevel.High (ou 1), conforme mostrado aqui.

Também adicionaremos o conjunto reRunOnOpen e o definiremos como true para forçar a consulta de assinatura a recalcular quais documentos sincronizar toda vez que abrirmos o aplicativo.

let config = user.flexibleSyncConfiguration(initialSubscriptions: { subs in
   if let foundSubscription = subs.first(named: Constants.myItems) {
      foundSubscription.updateQuery(toType: Item.self, where: {
         $0.owner_id == user.id && $0.priority <= PriorityLevel.high
      })
   } else {
      // No subscription - create it
      subs.append(QuerySubscription<Item>(name: Constants.myItems) {
         $0.owner_id == user.id && $0.priority <= PriorityLevel.high
      })
   }
}, rerunOnOpen: true)

Executar e testar

Execute o aplicativo novamente. Faça login usando a conta que você criou neste tutorial. Como adicionamos reRunOnOpen, o aplicativo deve sincronizar novamente apenas os documentos que correspondem à query de Sincronização flexível. Após um momento inicial em que a Realm ressincroniza a coleção de documentos, você verá apenas o novo item de alta prioridade que você criou.

O documento de item que você criou inicialmente não está sincronizado, pois não tem um campo priority. Se você quiser que este Item seja sincronizado, você pode editar o documento na interface do usuário Atlas e adicionar um valor para o campo prioritário.

Se quiser testar ainda mais a funcionalidade, crie Itens de várias prioridades. Você verá um novo item com uma prioridade mais baixa aparecer brevemente na lista de itens e depois desaparecer. O manipulador de erros de sincronização fornece uma mensagem que descreve esse comportamento:

ERROR
"Client attempted a write that is outside
of permissions or query filters; it has been reverted"

Você também pode ver esta mensagem no registro do console.

Nesse cenário, o Realm cria o item localmente, sincroniza-o com o backend e, em seguida, reverte a escrita porque ele não atende às regras de assinatura.