教程：附带 Swift 用户界面的 Atlas Device Sync for Swift

向模型添加属性

现在您已经确认一切都按预期进行，我们可以添加更改。在本教程中，我们决定为每个事项添加“priority”属性，以便我们可以按事项的优先级过滤事项。优先级属性使用 PriorityLevel 枚举来限制可能的值。

为此，请按照以下步骤操作：

1. 在 Xcode 中打开 App.xcodeproj。

2. 打开 Item.swift 类文件。

3. 将以下属性添加到 Item 类：

   @Persisted var priority: PriorityLevel

4. 还要在Item类下面添加一个 PriorityLevelPersistableEnum：

   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 是直接在 Realm 中将枚举类型标记为可持久的协议。我们在这里将枚举的类型设置为Int而不是String ，以便稍后根据数字优先级进行查询。我们使用description计算属性在用户界面中显示优先级的字符串表示形式。

创建新事项时设置优先级

1. 在 Views 目录中，转到 CreateItemView.swift。在现有的 itemSummary 属性下添加新的 @State 属性。暂时将默认值设为中等优先级：

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

2. 现在，在 Form 主体中添加一个选取器，让用户能够选择为新事项设置何种优先级。找到包含按钮的 Section，并在其上方插入以下代码：

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

3. 现在，向下移动到 Button(action:，当用户按下 Save 按钮时，它会设置 newItem 的值。在 newItem.summary 下方添加一行来同时设置 priority 属性：

   newItem.summary = itemSummary
   newItem.priority = priority

运行和测试

此时，您可以再次运行应用程序。使用本教程前面创建的帐户登录。您将看到先前创建的一个列项。添加新列项，您将看到现在可以设置优先级。为优先级选择 High 并保存条目。

现在切换回浏览器中的 Atlas 数据页面，并刷新 Item 集合。您现在应该会看到添加了 priority 字段并将其设置为1 的新项目。现有项目没有 priority 字段。

点击放大

更新订阅

在 ContentView.swift 文件中，我们创建了灵活同步订阅，其中定义了我们与用户设备和帐户同步的文档。查找我们设置初始订阅的 let config = user.flexibleSyncConfiguration(initialSubscriptions: 变量。在 subscriptions.append() 方法中，您可以看到我们当前订阅 owner_id 属性与经过身份验证的用户 ID 匹配的所有文档。我们希望保持这一点，但仅 同步标记为高或严重优先级的事项。

因此，我们将 PriorityLevel 枚举设置为 Int 类型，最高优先级（严重）的值为 0，最低优先级（低）的值为 3。我们可以直接将一个整数 (Int) 与优先级属性进行比较。为此，请更新查询语句以包含优先级等于或小于 PriorityLevel.High（或 1）的文档，如下所示。

我们还将添加布尔型参数 reRunOnOpen，并将其设置为 true，即强制订阅查询在每次打开应用时重新计算要同步的文档。

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)

运行和测试

再次运行应用程序。使用本教程前面创建的帐户登录。因为我们添加了 reRunOnOpen，所以应用应该仅重新同步与灵活同步查询匹配的文档。在 Realm 重新同步文档集合的初始时刻之后，您将只能看到您创建的新的高优先级事项。

您最初创建的事项文档未同步，因为它没有priority 字段。如果希望同步此事项，您可以在 Atlas 用户界面中编辑文档并为优先级字段添加值。

如果要进一步测试此功能，您可以创建各种优先级的事项。您将看到一个优先级较低的新事项短暂出现在事项清单中，继而又消失。同步错误处理程序提供了一条说明此行为的消息，十分有帮助：

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

您还可以在控制台日志中看到此消息。

在这种情况下，Realm 会在本地创建该事项并将其与后端进行同步，然后撤销写入操作，因为它不符合订阅规则。