Tutorial: Atlas Device Sync para Swift con Swift Interfaz de Usuario

Agregar una propiedad al modelo

Ahora que ha confirmado que todo funciona correctamente, podemos realizar cambios. En este tutorial, hemos decidido añadir una propiedad "priority" a cada elemento para poder filtrarlos por su prioridad. La propiedad "priority" utiliza una enumeración "PriorityLevel" para limitar los valores posibles.

Para ello siga estos pasos:

1. Abra el App.xcodeproj en Xcode.

2. Abra el archivo de clase Item.swift.

3. Agregue la siguiente propiedad a la clase Item:

   @Persisted var priority: PriorityLevel

4. Agregue también un PriorityLevel PersistableEnum debajo de la clase 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 es el protocolo que marca los tipos de enumeración como persistentes directamente en Realm. Aquí, el tipo de la enumeración se establece como Int en lugar de String para poder realizar consultas posteriormente según un nivel de prioridad numérico. Usamos la description propiedad calculada para mostrar una representación de cadena de la prioridad en la interfaz de usuario.

Establecer la prioridad al crear un nuevo elemento

1. En el directorio Views, vaya a CreateItemView.swift. Añada una nueva propiedad @State bajo la propiedad itemSummary existente. Por ahora, establezca el valor predeterminado en prioridad media:

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

2. Ahora, en el Form cuerpo, agregue un selector que permita al usuario elegir el nivel de prioridad del nuevo elemento. Localice el Section que contiene los botones e inserte el siguiente código encima:

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

3. Ahora, desplácese hasta Button(action:, que establece los valores de newItem cuando el usuario presiona el botón Save. Agregue una línea debajo de newItem.summary para establecer también la propiedad priority:

   newItem.summary = itemSummary
   newItem.priority = priority

Ejecutar y probar

En este punto, puede volver a ejecutar la aplicación. Inicie sesión con la cuenta que creó anteriormente en este tutorial. Verá el elemento que creó anteriormente. Añada un nuevo elemento y verá que ahora puede establecer la prioridad. Seleccione High como prioridad y guarde el elemento.

Ahora, regresa a la página de datos del Atlas en tu navegador y actualiza la Item colección. Deberías ver el nuevo elemento con el priority campo añadido y configurado como. El elemento existente no tiene 1 el priority campo.

haga clic para ampliar

Actualizar la suscripción

En el ContentView.swift archivo, creamos la suscripción de Sincronización Flexible que define los documentos que sincronizamos con el dispositivo y la cuenta del usuario. Busque la let config = user.flexibleSyncConfiguration(initialSubscriptions: variable donde configuramos las suscripciones iniciales. En el subscriptions.append() método, puede ver que actualmente nos suscribimos a todos los documentos cuya owner_id propiedad coincide con el ID del usuario autenticado. Queremos mantener esto, pero solo sincronizar los elementos con prioridad alta o severa.

Por eso, configuramos la PriorityLevel enumeración con el Int tipo, donde la prioridad más alta (grave) tiene un valor de 0 y la más baja (baja) tiene un valor 3 de. Podemos realizar comparaciones directas entre un entero y la propiedad de prioridad. Para ello, actualice la consulta para incluir documentos cuya prioridad sea igual o menor que PriorityLevel.High 1 (o), como se muestra aquí.

También agregaremos el valor booleano reRunOnOpen y lo estableceremos en true para forzar la consulta de suscripción a recalcular qué documentos sincronizar cada vez que abramos la aplicación.

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)

Ejecutar y probar

Ejecute la aplicación de nuevo. Inicie sesión con la cuenta que creó anteriormente en este tutorial. Dado que añadimos reRunOnOpen, la aplicación debería resincronizar solo los documentos que coincidan con la consulta de sincronización flexible. Tras un momento inicial, cuando Realm resincroniza la colección de documentos, solo verá el nuevo elemento de alta prioridad que creó.

El documento de elemento que creó inicialmente no está sincronizado porque no tiene el campo priority. Si desea que este elemento se sincronice, puede editarlo en la interfaz de usuario de Atlas y agregar un valor al campo de prioridad.

Si desea probar la funcionalidad con más detalle, puede crear elementos con diferentes prioridades. Verá que un nuevo elemento con menor prioridad aparece brevemente en la lista de elementos y luego desaparece. El gestor de errores de sincronización proporciona un mensaje que describe este comportamiento:

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

También puedes ver este mensaje en el registro de la consola.

En este escenario, Realm crea el elemento localmente, lo sincroniza con el backend y luego revierte la escritura porque no cumple con las reglas de suscripción.