프로젝션

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>
}

### 지원되는 속성 유형

프로젝션은 여러 가지 방법으로 원래 @Persisted 속성을 변환할 수 있습니다.

• Passthrough - Projection의 속성은 원본 객체와 동일한 이름 및 유형을 갖습니다. PersonProjection.firstName 을(를) 참조하세요.
• Rename - 프로젝션의 속성은 새 이름만 포함된 원본 객체와 동일한 유형을 갖습니다.
• Keypath resolution - 프로젝션된 Object 의 특정 속성에 액세스할 수 있습니다. PersonProjection.lastNameCaps 및 PersonProjection.homeCity 를 참조하세요.
• Collection mapping - List MutableSet또는 Object의 EmbeddedObject및 는 기본 값의 collection으로 프로젝션될 수 있습니다. PersonProjection.friendsFirstName 를 참조하세요.
• Exclusion - 프로젝션 모델에 정의되지 않은 원본 Realm 객체의 모든 속성은 프로젝션에서 제외됩니다. 해당 속성에 발생한 변경 사항은 Projection 에 대한 변경 알림을 trigger하지 않습니다. 여전히 원본 Object 또는 EmbeddedObject 에 액세스하고 직접 알림을 관찰할 수 있습니다.

쿼리하기

Realm의 objects(_:) 또는 프로젝션 클래스의 init(projecting:) 를 호출하여 Realm에서 특정 유형의 모든 프로젝션을 조회할 수 있습니다.

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