튜토리얼: Swift UI를 사용하는 Swift용 Atlas Device Sync

모델에 속성 추가

이제 모든 것이 예상대로 작동하는지 확인했으므로 변경 사항을 추가할 수 있습니다. 이 튜토리얼에서는 우선 순위에 따라 항목을 필터링할 수 있도록 각 항목에 '우선 순위' 속성을 추가하기로 결정했습니다. 우선 순위 속성은 PriorityLevel 열거형을 사용하여 가능한 값을 제한합니다.

이렇게 하려면 다음 단계를 따라 진행합니다.

1. Xcode에서 App.xcodeproj를 엽니다.

2. Item.swift 클래스 파일을 엽니다.

3. Item 클래스에 다음 속성을 추가합니다.

   @Persisted var priority: PriorityLevel

4. 또한 Item 클래스 아래에 PriorityLevel PersistableEnum을 추가합니다.

   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에서 직접 열거형을 지속 가능한 것으로 표시하는 프로토콜 입니다. 여기서 열거형의 유형을 String 대신 Int 로 설정하여 나중에 숫자 우선 순위 수준을 기반으로 쿼리할 수 있습니다. description 계산된 속성을 사용하여 UI에 우선 순위의 문자열 표현을 표시합니다.

새 항목 생성 시 우선 순위 설정하기

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. 이제 사용자가 Save 버튼을 누를 때 newItem 값을 설정하는 Button(action:으로 이동합니다. 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에서 문서 컬렉션을 다시 동기화하는 초기 시점 이후에는 사용자가 만든 새로운 High 우선순위 항목만 볼 수 있습니다.

처음에 생성한 항목 문서에는 priority 필드가 없기 때문에 동기화되지 않습니다. 이 항목을 동기화하려면 Atlas UI에서 문서를 편집하고 우선 순위 필드에 값을 추가할 수 있습니다.

기능을 추가로 테스트하려면 다양한 우선 순위의 항목을 생성할 수 있습니다. 우선 순위가 낮은 새 항목이 항목 목록에 잠시 나타났다가 사라지는 것을 볼 수 있습니다. 동기화 오류 처리기는 이 동작을 설명하는 메시지를 유용하게 제공합니다.

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

콘솔 로그에서도 이 메시지를 확인할 수 있습니다.

이 시나리오에서 Realm은 항목을 로컬에서 생성하고 백엔드와 동기화한 다음 구독 규칙을 충족하지 않기 때문에 쓰기를 되돌립니다.