튜토리얼: MAUI를 사용한 .NET용 Atlas Device Sync

우선 순위 속성 추가하기

1. RealmTodo 프로젝트에서 Models 폴더를 확장하고 Item 클래스 파일을 엽니다.

2. 추가할 공개 속성:

   [MapTo("priority")]
   public int? Priority { get; set; }

   본 속성을 nullable로 설정했습니다. 이렇게 하면 데이터베이스의 기존 항목(우선 순위 속성이 없는 항목)을 계속 사용할 수 있습니다.

항목 생성 또는 수정 시 우선 순위 설정하기

1. EditItemViewModel ViewModel은 새 항목을 만들고 기존 항목을 수정하는 데 모두 사용됩니다. 항목을 만들거나 수정할 때 사용자는 항목의 우선 순위를 설정하기 위한 UI (및 코드) 가 필요합니다.

2. 우선순위를 유지하려면 ObservableProperty를 추가하세요.

   [ObservableProperty]
   private int? priority;

   참고

   [ObservableProperty] 속성

   속성은 [ObservableProperty] MVVM 툴킷 에서 제공하는 기능입니다. 데이터 바인딩을 간소화합니다.

3. ApplyQueryAttributes 메서드는 이 뷰 모델의 일종의 '생성자' 역할을 하며, 편집을 위해 기존 항목이 이 뷰로 전달되고 있는지 확인합니다. 여기서는 뷰에 표시할 기존 값을 캡처합니다.

   기존 항목을 편집하는 경우 기존 항목의 Priority를 설정하려고 합니다. Priority = InitialItem.Priority;.

   마찬가지로, 새 항목을 만드는 경우 기본 우선순위를 'Medium': Priority = 2;로 설정합니다.

   완료되면 이 메서드는 이제 다음과 같이 표시됩니다.

   public void ApplyQueryAttributes(IDictionary<string, object> query)
   {
         if (query.Count > 0 && query["item"] != null) // we're editing an Item
         {
            InitialItem = query["item"] as Item;
            Summary = InitialItem.Summary;
            Priority = InitialItem.Priority;
            PageHeader = $"Modify Item {InitialItem.Id}";
         }
         else // we're creating a new item
         {
            Summary = "";
            Priority = 2;
            PageHeader = "Create a New Item";
         }
   }

4. 마지막으로 SaveItem() 메서드에서 우선 순위 값을 유지하려고 합니다. 관리 객체를 생성하거나 수정하고 있으므로 변경 사항은 realm.WriteAsync 호출로 래핑됩니다.

   기존 항목의 경우 기존 객체에 InitialItem.Priority를 설정하고, 새 항목의 경우 Add() 호출에서 속성을 설정합니다. 완성된 WriteAsync 블록은 다음과 같이 표시되어야 합니다.

   await realm.WriteAsync(() =>
   {
      if (InitialItem != null) // editing an item
      {
         InitialItem.Summary = Summary;
         InitialItem.Priority = Priority;
      }
      else // creating a new item
      {
         realm.Add(new Item()
         {
               OwnerId = RealmService.CurrentUser.Id,
               Summary = summary,
               Priority = Priority
         });
      }
   });

UI 요소 업데이트

1. 마지막 작업은 우선순위를 설정하고 표시하는 데 필요한 UI 요소를 추가하는 것입니다.

   먼저 ItemsPage.xaml에서 우선 순위를 표시하는 ListView에 레이블을 추가합니다. 다음과 같이 ViewCell 내에서 레이블을 추가하여 항목의 우선 순위를 표시합니다.

   <Label Text="{Binding Priority}"
      HorizontalOptions="Center"
      VerticalOptions="Center"/>

2. EditItemsPage.xaml에서 두 개의 UI 요소, 즉 사용자가 새 항목에 설정할 우선순위 수준을 선택할 수 있는 선택기와 선택기에 대한 라벨을 추가합니다. 요약 설정을 위한 Entry 요소를 찾아 그 아래에 다음 요소를 추가합니다.

   <Label Text="Priority:"/>
   <Picker x:Name="newItemPriority" SelectedIndex="{Binding Priority}">
      <Picker.Items>
            <x:String>Severe</x:String>
            <x:String>High</x:String>
            <x:String>Medium</x:String>
            <x:String>Low</x:String>
      </Picker.Items>
   </Picker>

실행 및 테스트

이 시점에서 애플리케이션을 다시 실행할 수 있습니다. 이 튜토리얼의 앞부분에서 생성한 계정을 사용하여 로그인합니다. 이전에 생성한 하나의 항목이 표시됩니다. 새 항목을 추가하면 이제 우선 순위를 설정할 수 있는 것을 볼 수 있습니다. 우선 순위로 High를 선택하고 항목을 저장합니다.

이제 브라우저에서 Atlas 데이터 페이지로 다시 전환하고 Item 컬렉션을 새로 고침 하십시오. 그러면 priority 필드가 추가되고 1로 설정된 새 항목이 표시됩니다. 또한 다음 스크린샷과 같이 기존 항목에도 priority 필드가 있으며, 이 필드가 null로 설정되어 있음을 알 수 있습니다.

구독 업데이트

RealmService.cs 파일에서 두 개의 Flexible Sync(유연한 동기화) 구독을 정의합니다. 하나는 현재 사용자가 만든 항목만 표시하고 다른 하나는 모든 사용자의 모든 항목을 표시합니다.

우선순위가 0 또는 1인 현재 사용자의 항목을 표시하는 새 구독을 추가하겠습니다.

1. RealmService 클래스의 맨 아래에서 SubscriptionType 열거형에 'MyHighPriority'라는 항목을 추가합니다.

   public enum SubscriptionType
   {
      Mine,
      MyHighPriority,
      All,
   }

2. 위로 스크롤하여 GetQueryForSubscriptionType 메서드를 찾습니다. 여기에서 구독을 정의합니다.

   1. 첫 번째 항목인 subType == SubscriptionType.Mine 복사하여 바로 아래의 else if 블록에 붙여넣습니다.

   2. 새 조건을 subType == SubscriptionType.MyHighPriority으로 설정합니다.

   3. 이 새 구독 쿼리를 수정하여 여전히 OwnerId와 2보다 작은 우선 순위 값을 기준으로 필터링하는 LINQ 쿼리를 삽입합니다.

   4. 새 쿼리의 이름을 'myHighPri'로 변경합니다. 코드는 다음과 같이 표시됩니다.

   if (subType == SubscriptionType.Mine)
   {
         query = realm.All<Item>()
            .Where(i => i.OwnerId == CurrentUser.Id)
            .Where(i => i.Priority < 2);
         queryName = "mine";
   }
   else if (subType == SubscriptionType.MyHighPriority)
   {
         query = realm.All<Item>()
           .Where(i => i.OwnerId == CurrentUser.Id &&
                  i.Priority < 2);
         queryName = "myHighPri";
   }
   else if (subType == SubscriptionType.All)
   {
         query = realm.All<Item>();
         queryName = "all";
   }

3. 바로 위의 GetCurrentSubscriptionType 메서드에서 switch 문에 새 구독 이름을 추가하면 다음과 같이 표시됩니다.

   return activeSubscription.Name switch
   {
       "all" => SubscriptionType.All,
       "mine" => SubscriptionType.Mine,
       "myHighPri" => SubscriptionType.MyHighPriority,
       _ => throw new InvalidOperationException("Unknown subscription type")
   };

4. 마지막으로 ItemsViewModel 클래스를 열고 OnIsShowAllTasksChanged 메서드를 찾습니다. 3개의 구독을 허용하도록 UI를 변경하는 대신 기존 '광산' 구독을 새 구독으로 교체하겠습니다. SetSubscription 2} 메서드를 다음과 같이 변경합니다.

   await RealmService.SetSubscription(realm, value
      ? SubscriptionType.All
      : SubscriptionType.MyHighPriority);

실행 및 테스트

애플리케이션을 다시 실행합니다. 로그인하라는 메시지가 표시되면 본 이 튜토리얼의 앞부분에서 만든 계정을 사용하여 로그인합니다.

생성한 항목 중 우선 순위가 '높음'(1) 또는 '심각'(0)인 항목이 표시됩니다. '모든 작업 표시' 스위치를 토글하면 모든 사용자의 모든 작업이 표시됩니다.