ProjeçãoObservável

O tipo subjacente da projeção - um filho de Realm Object ou EmbeddedObject.

O objeto sendo projetado

Registra um bloco a ser chamado sempre que o objeto subjacente da projeção for alterado.

O bloco será chamado de forma assíncrona após cada transação de escrita que exclui o objeto subjacente ou modifica qualquer uma das propriedades projetadas do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente.

Para transações de gravação realizadas em diferentes threads ou em processos diferentes, o bloco será chamado quando o Realm de gerenciamento for (auto)atualizado para uma versão que inclua as alterações, enquanto para transações de gravação local, ele será chamado em algum momento no futuro após o a transação de escrita está confirmada.

Se nenhum caminho de chave for fornecido, o bloco será executado em qualquer inserção, modificação ou exclusão para todas as propriedades projetadas, incluindo propriedades projetadas de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade Person.firstName do objeto Person subjacente da projeção, mas não para quaisquer alterações feitas na lista Person.lastName ou Person.friends .
• O bloco de notificação é acionado para alterações da propriedade PersonProjection.name , mas não para a alteração de propriedade de outra projeção.

• Se o caminho da chave observado for ["firstFriendsName"], qualquer inserção, exclusão ou modificação do firstName da lista friends trigger o bloqueio. Uma alteração em someFriend.lastName não trigger o bloqueio (onde someFriend é um elemento contido em friends)

Se nenhuma fila for fornecida, as notificações serão entregues por meio do loop de eventos padrão e, portanto, não poderão ser entregues enquanto o loop de eventos estiver bloqueado por outra atividade. Se uma fila for fornecida, as notificações serão entregues para essa fila. Quando as notificações não podem ser entregues instantaneamente, várias notificações podem ser agrupadas em uma única notificação.

Ao contrário de List e Results, não há chamada de resposta "inicial" feita após você adicionar um novo bloco de notificação.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

É seguro capturar uma forte referência ao objeto observado dentro do bloco de chamada de resposta. Não há ciclo de retenção devido ao fato de que a chamada de resposta é retida pelo token retornado e não pelo próprio objeto.

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

Registra um bloco a ser chamado sempre que o objeto subjacente da projeção for alterado.

O bloco será chamado de forma assíncrona após cada transação de escrita que exclui o objeto subjacente ou modifica qualquer uma das propriedades projetadas do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente.

Para transações de gravação realizadas em diferentes threads ou em processos diferentes, o bloco será chamado quando o Realm de gerenciamento for (auto)atualizado para uma versão que inclua as alterações, enquanto para transações de gravação local, ele será chamado em algum momento no futuro após o a transação de escrita está confirmada.

Se nenhum caminho de chave for fornecido, o bloco será executado em qualquer inserção, modificação ou exclusão para todas as propriedades projetadas, incluindo propriedades projetadas de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade firstName do objeto, mas não para quaisquer alterações feitas na lista lastName ou friends .

• Se o caminho da chave observado for [\PersonProjection.firstFriendsName], qualquer inserção, exclusão ou modificação do firstName da lista friends trigger o bloqueio. Uma alteração em someFriend.lastName não trigger o bloqueio (onde someFriend é um elemento contido em friends)

Se nenhuma fila for fornecida, as notificações serão entregues por meio do loop de eventos padrão e, portanto, não poderão ser entregues enquanto o loop de eventos estiver bloqueado por outra atividade. Se uma fila for fornecida, as notificações serão entregues para essa fila. Quando as notificações não podem ser entregues instantaneamente, várias notificações podem ser agrupadas em uma única notificação.

Ao contrário de List e Results, não há chamada de resposta "inicial" feita após você adicionar um novo bloco de notificação.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

É seguro capturar uma forte referência ao objeto observado dentro do bloco de chamada de resposta. Não há ciclo de retenção devido ao fato de que a chamada de resposta é retida pelo token retornado e não pelo próprio objeto.

Registra um bloco a ser chamado sempre que o objeto subjacente da projeção for alterado.

O bloqueio será chamado de forma assíncrona no ator após cada transação de gravação que exclua o objeto subjacente ou modifique qualquer uma das propriedades projetadas do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente.

Para transações de gravação realizadas em diferentes threads ou em processos diferentes, o bloco será chamado quando o Realm de gerenciamento for (auto)atualizado para uma versão que inclua as alterações, enquanto para transações de gravação local, ele será chamado em algum momento no futuro após o a transação de escrita está confirmada.

Se nenhum caminho de chave for fornecido, o bloco será executado em qualquer inserção, modificação ou exclusão para todas as propriedades projetadas, incluindo propriedades projetadas de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade Person.firstName do objeto Person subjacente da projeção, mas não para quaisquer alterações feitas na lista Person.lastName ou Person.friends .
• O bloco de notificação é acionado para alterações da propriedade PersonProjection.name , mas não para a alteração de propriedade de outra projeção.
• Se o caminho da chave observado for ["firstFriendsName"], qualquer inserção, exclusão ou modificação do firstName da lista friends trigger o bloqueio. Uma alteração em someFriend.lastName não trigger o bloqueio (onde someFriend é um elemento contido em friends)

As notificações são entregues a uma função isolada do ator específico, no executor do ator. Se o ator estiver realizando um trabalho de bloqueio, várias notificações podem ser agrupadas em uma única notificação.

Ao contrário das notificações de coleção, não há notificação "Inicial" e não há lacuna entre o momento em que essa função retorna e o momento em que as alterações serão capturadas pela primeira vez.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

Registra um bloco a ser chamado sempre que o objeto subjacente da projeção for alterado.

O bloqueio será chamado de forma assíncrona no ator após cada transação de gravação que exclua o objeto subjacente ou modifique qualquer uma das propriedades projetadas do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente.

Para transações de gravação realizadas em diferentes threads ou em processos diferentes, o bloco será chamado quando o Realm de gerenciamento for (auto)atualizado para uma versão que inclua as alterações, enquanto para transações de gravação local, ele será chamado em algum momento no futuro após o a transação de escrita está confirmada.

Se nenhum caminho de chave for fornecido, o bloco será executado em qualquer inserção, modificação ou exclusão para todas as propriedades projetadas, incluindo propriedades projetadas de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade Person.firstName do objeto Person subjacente da projeção, mas não para quaisquer alterações feitas na lista Person.lastName ou Person.friends .
• O bloco de notificação é acionado para alterações da propriedade PersonProjection.name , mas não para a alteração de propriedade de outra projeção.
• Se o caminho da chave observado for [\.firstFriendsName], qualquer inserção, exclusão ou modificação do firstName da lista friends trigger o bloqueio. Uma alteração em someFriend.lastName não trigger o bloqueio (onde someFriend é um elemento contido em friends)

As notificações são entregues a uma função isolada do ator específico, no executor do ator. Se o ator estiver realizando um trabalho de bloqueio, várias notificações podem ser agrupadas em uma única notificação.

Ao contrário das notificações de coleção, não há notificação "Inicial" e não há lacuna entre o momento em que essa função retorna e o momento em que as alterações serão capturadas pela primeira vez.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.