チュートリアル: Swift UI を使用した Swift 用 Atlas Device Sync

モデルへのプロパティの追加

すべて期待どおりに動作していることが確認できたため、変更を追加できます。 このチュートリアルでは、各アイテムに「優先順位」プロパティを追加し、アイテムに優先順位をつけてフィルタリングできるようにしました。 優先順位プロパティは、可能な値を制限するために PrimaryLevel 列挙型を使用します。

これを行うには、次の手順に従います。

1. Xcode でApp.xcodeprojを開きます。

2. Item.swiftクラスファイルを開きます。

3. 次のプロパティをItemクラスに追加します。

   @Persisted var priority: PriorityLevel

4. また、 Itemクラスの下に優先順位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"
         }
      }
   }

   PeristableEnum は、列挙型を Realm で直接永続可能としてマークするプロトコルです。 ここでは列挙型のタイプをStringではなくIntに設定しているため、後で数値優先レベルに基づいてクエリを実行できます。 description 計算プロパティを使用して、UI に優先順位のstring表現を表示します。

新しいアイテムの作成時の優先順位の設定

1. Views ディレクトリで、CreateItemView.swift にGoします。 既存の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

およびテストの実行

この時点で、アプリケーションを再度実行できます。 このチュートリアルの前半で作成したアカウントを使用してログインします。 過去に作成した 1 つのアイテムが表示されます。 新しいアイテムを追加すると、優先順位を設定できるようになります。 優先順位をHighに選択し、アイテムを保存します。

ブラウザで Atlas データページに切り替え、 Itemコレクションを更新します。 これでpriorityフィールドが追加され、 1に設定された新しいアイテムが表示されます。 既存のアイテムにはpriorityフィールドはありません。

クリックして拡大します

サブスクライブを更新する

ContentView.swiftファイルでは、ユーザーのデバイスおよびアカウントと同期するドキュメントを定義する Flexible Sync サブスクリプションを作成します。 初期サブスクリプションを設定するlet config = user.flexibleSyncConfiguration(initialSubscriptions:変数を探します。 subscriptions.append()メソッド内では、 owner_idプロパティが認証されたユーザーの ID と一致するすべてのドキュメントを現在サブスクライブしていることが確認できます。 これを維持したいが、優先度が「高」または「重要」とマークされたアイテムのみを同期します。

したがって、 PriorityLevel列挙型をIntタイプに設定する理由です。最高優先順位（重大）の値は 0、最低優先順位（低）の値は 3 です。Int と優先順位プロパティ そのためには、ここに示すように、クエリ ステートメントを更新して、優先順位が PrimaryLevel.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を追加したため、アプリは Flexible Sync クエリに一致するドキュメントのみを再同期する必要があります。 Realm がドキュメントコレクションを再同期する最初の瞬間、作成した優先順位の高い新しいアイテムのみが表示されます。

最初に作成したアイテム ドキュメントはpriorityフィールドがないため、同期されません。 このアイテムを同期する場合は、Atlas UI でドキュメントを編集し、優先順位フィールドに値を追加します。

機能をさらにテストしたい場合は、さまざまな優先順位のアイテムを作成できます。 優先順位の低い新しいアイテムがアイテム リストに一時的に表示され、その後消えます。 同期エラー ハンドラーは、この動作を説明するメッセージを提供します。

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

このメッセージは、 コンソール ログにも表示されます。

このシナリオでは、Realm はアイテムをローカルに作成し、バックエンドと同期した後、サブスクライブ ルールを満たしていないため書込みを元に戻します。