ProjectionObservable

投影的基础类型 — Realm Object或EmbeddedObject的子类型。

被投影的对象

注册一个区块，以便在每次投影的底层对象发生变化时进行调用。

在每个写入事务后，将异步调用该区块，该写入事务会删除底层对象或修改对象的任何投影属性，包括将属性设置为其现有值的自分配。

对于在不同线程或不同进程中执行的写事务（write transaction），当管理 Realm（自动）刷新到包含更改的版本时，将调用该区块，而对于本地写事务（write transaction），将在提交写事务（write transaction）后的未来某个时间点调用该区块。

如果没有给出键路径，则在插入、修改或删除所有投影属性（包括任何嵌套、链接对象的投影属性）时都将执行该区块。如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。例如，如果：

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

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

let token = projectedPerson.observe(keyPaths: ["name"], { changes in
   // ...
})

• 上述通知块会在投影的底层Person对象的Person.firstName属性发生更改时触发，但不会在对Person.lastName或Person.friends列表进行任何更改时触发。
• 通知块会因PersonProjection.name属性更改而触发，但不会因其他投影的属性更改而触发。

• 如果观察到的键路径为["firstFriendsName"] ，则对friends列表的firstName的任何插入、删除或修改都将trigger区块。对someFriend.lastName的更改不会trigger该区块（其中someFriend是friends中包含的元素）

如果未指定队列，则将通过标准事件循环传递通知，因此当事件循环被其他活动阻塞时无法传递通知。如果给出了队列，则将通知传递到该队列。 当无法立即传递通知时，可以将多个通知合并为一个通知。

与List和Results不同，添加新的通知块后，不会执行“初始”回调。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

在回调块中捕获对观察到的对象的强引用是安全的。 由于回调由返回的令牌而不是对象本身保留，因此不存在保留周期。

   let token = projectedPerson.observe { changes in
       if case .change(_, let propertyChanges) = changes {
           propertyChanges[0].newValue as? String, "Winterfell" // Will notify the new value
           propertyChanges[1].newValue as? String, "555-555-555" // Will notify with the current value, which hasn't change.
       }
   })

   try realm.write {
       person.address.country = "Winterfell"
   }
   ```

注册一个区块，以便在每次投影的底层对象发生变化时进行调用。

在每个写入事务后，将异步调用该区块，该写入事务会删除底层对象或修改对象的任何投影属性，包括将属性设置为其现有值的自分配。

对于在不同线程或不同进程中执行的写事务（write transaction），当管理 Realm（自动）刷新到包含更改的版本时，将调用该区块，而对于本地写事务（write transaction），将在提交写事务（write transaction）后的未来某个时间点调用该区块。

如果没有给出键路径，则在插入、修改或删除所有投影属性（包括任何嵌套、链接对象的投影属性）时都将执行该区块。如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。例如，如果：

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

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

let token = projectedPerson.observe(keyPaths: [\PersonProjection.name], { changes in
   // ...
})

• 上述通知块会在对象的firstName属性发生更改时触发，但不会在lastName或friends列表发生任何更改时触发。

• 如果观察到的键路径为[\PersonProjection.firstFriendsName] ，则对friends列表的firstName的任何插入、删除或修改都将trigger区块。对someFriend.lastName的更改不会trigger该区块（其中someFriend是friends中包含的元素）

如果未指定队列，则将通过标准事件循环传递通知，因此当事件循环被其他活动阻塞时无法传递通知。如果给出了队列，则将通知传递到该队列。 当无法立即传递通知时，可以将多个通知合并为一个通知。

与List和Results不同，添加新的通知块后，不会执行“初始”回调。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

在回调块中捕获对观察到的对象的强引用是安全的。 由于回调由返回的令牌而不是对象本身保留，因此不存在保留周期。

注册一个区块，以便在每次投影的底层对象发生变化时进行调用。

每次写事务（write transaction）后，将在 actor 上异步调用该区块，该写事务（write transaction）会删除底层对象或修改对象的任何投影属性，包括将属性设置为其现有值的自分配。

对于在不同线程或不同进程中执行的写事务（write transaction），当管理 Realm（自动）刷新到包含更改的版本时，将调用该区块，而对于本地写事务（write transaction），将在提交写事务（write transaction）后的未来某个时间点调用该区块。

如果没有给出键路径，则在插入、修改或删除所有投影属性（包括任何嵌套、链接对象的投影属性）时都将执行该区块。如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。例如，如果：

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

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

let token = projectedPerson.observe(keyPaths: ["name"], { changes in
   // ...
})

• 上述通知块会在投影的底层Person对象的Person.firstName属性发生更改时触发，但不会在对Person.lastName或Person.friends列表进行任何更改时触发。
• 通知块会因PersonProjection.name属性更改而触发，但不会因其他投影的属性更改而触发。
• 如果观察到的键路径为["firstFriendsName"] ，则对friends列表的firstName的任何插入、删除或修改都将trigger区块。对someFriend.lastName的更改不会trigger该区块（其中someFriend是friends中包含的元素）

通知将传递到该 actor 执行器上与给定 actor 隔离的函数。 如果 actor 正在执行阻塞工作，则多个通知可能会合并为一个通知。

与collection通知不同，它没有“初始”通知，并且该函数返回的时间与首次捕获更改的时间之间没有间隔。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

注册一个区块，以便在每次投影的底层对象发生变化时进行调用。

每次写事务（write transaction）后，将在 actor 上异步调用该区块，该写事务（write transaction）会删除底层对象或修改对象的任何投影属性，包括将属性设置为其现有值的自分配。

对于在不同线程或不同进程中执行的写事务（write transaction），当管理 Realm（自动）刷新到包含更改的版本时，将调用该区块，而对于本地写事务（write transaction），将在提交写事务（write transaction）后的未来某个时间点调用该区块。

如果没有给出键路径，则在插入、修改或删除所有投影属性（包括任何嵌套、链接对象的投影属性）时都将执行该区块。如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。例如，如果：

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

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

let token = projectedPerson.observe(keyPaths: [\PersonProjection.name], { changes in
   // ...
})

• 上述通知块会在投影的底层Person对象的Person.firstName属性发生更改时触发，但不会在对Person.lastName或Person.friends列表进行任何更改时触发。
• 通知块会因PersonProjection.name属性更改而触发，但不会因其他投影的属性更改而触发。
• 如果观察到的键路径为[\.firstFriendsName] ，则对friends列表的firstName的任何插入、删除或修改都将trigger区块。对someFriend.lastName的更改不会trigger该区块（其中someFriend是friends中包含的元素）

通知将传递到该 actor 执行器上与给定 actor 隔离的函数。 如果 actor 正在执行阻塞工作，则多个通知可能会合并为一个通知。

与collection通知不同，它没有“初始”通知，并且该函数返回的时间与首次捕获更改的时间之间没有间隔。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。