プロジェクション

open class Projection<Root> : RealmCollectionValue, ProjectionObservable where Root : RLMObjectBase, Root : RealmCollectionValue, Root : ThreadConfined

extension Projection: KeypathSortable

extension Projection: ThreadConfined where Root: ThreadConfined

extension Projection: ObservableObject, RealmSubscribable where Root: ThreadConfined

Projection は、元の Realm ObjectまたはEmbeddedObjectの軽量モデルです。 またはProjectionをビューモデルとして使用すると、ビューアテンプレートを最小限に抑えることができます。

使用例:

public class Person: Object {
    @Persisted var firstName = ""
    @Persisted var lastName = ""
    @Persisted var address: Address?
    @Persisted var friends: List<Person>
    @Persisted var reviews: List<String>
}

public class Address: EmbeddedObject {
    @Persisted var city: String = ""
    @Persisted var country = ""
}

class PersonProjection: Projection<Person> {
    @Projected(\Person.firstName) var firstName
    @Projected(\Person.lastName.localizedUppercase)
    var lastNameCaps
    @Projected(\Person.address.city) var homeCity
    @Projected(\Person.friends.projectTo.firstName)
    var friendsFirstName: ProjectedCollection<String>
}

Atlas でサポートされているプロパティの型

プロジェクションは、元の@Persistedプロパティをいくつかの方法で変換できます。

• Passthrough - Projectionのプロパティは、元のオブジェクトと同じ名前とタイプになります。 詳しくはPersonProjection.firstNameを参照してください。
• Rename - プロジェクションのプロパティは、新しい名前を持つだけで元のオブジェクトと同じタイプになります。
• Keypath resolution - プロジェクションされたObjectの特定のプロパティにアクセスできます。 詳しくは、 PersonProjection.lastNameCapsとPersonProjection.homeCityを参照してください。
• Collection mapping -List MutableSetまたはObject の とEmbeddedObject は、プリミティブ値のコレクションとしてプロジェクションできます。詳しくはPersonProjection.friendsFirstNameを参照してください。
• Exclusion - プロジェクション モデルで定義されていない元の Realm オブジェクトのすべてのプロパティは、プロジェクションから除外されます。 これらのプロパティで変更が発生しても、Projection の変更通知はtriggerされません。 元のObjectまたはEmbeddedObjectに引き続きアクセスし、通知を直接確認できます。

クエリ

Realm から特定のタイプのすべてのプロジェクションを検索するには、Realm のobjects(_:)またはプロジェクションの クラスのinit(projecting:)を呼び出します。

let projections = realm.object(PersonProjection.self)
let personObject = realm.create(Person.self)
let singleProjection = PersonProjection(projecting: personObject)