Objeto

Um editor que emite um cancelamento toda vez que o objeto muda.

Apesar do nome, isso é realmente emitido após a mudança do objeto.

Cria uma instância não gerenciada de um objeto de Realm.

O argumento value é utilizado para preencher o objeto. Pode ser um objeto compatível com codificação key-value, uma array ou dicionário retornado dos métodos em NSJSONSerialization ou um Array contendo um elemento para cada propriedade gerenciada. Uma exceção será lançada se alguma propriedade obrigatória não estiver presente e essas propriedades não tiverem sido definidas com valores padrão.

Ao passar um Array como argumento value , todas as propriedades devem estar presentes, válidas e na mesma ordem que as propriedades definidas no modelo.

Chame add(_:) em uma instância Realm para adicionar um objeto não gerenciado a esse Realm.

O Realm que managed o objeto ou nil se o objeto não for gerenciado.

O esquema de objetos que lista as propriedade managed do objeto.

Indica se o objeto não pode mais ser acessado porque agora é inválido.

Um objeto não poderá mais ser acessado se o objeto tiver sido excluído do Realm que o managed ou se invalidate() for chamado nesse Realm. Esta propriedade é observável por valor-chave.

Uma descrição legível por humanos do objeto.

Substitua este método para especificar o nome de uma propriedade a ser usada como chave primária.

Somente propriedades dos tipos String, Int, ObjectId e UUID podem ser designadas como a chave primária. As propriedades da chave primária impõem exclusividade para cada valor sempre que a propriedade é definida, o que incorre em menor sobrecarga. Os índices são criados automaticamente para propriedades de chave primária.

Substitua este método para especificar os nomes das propriedades a serem ignoradas. Essas propriedade não serão managed pelo Realm que managed o objeto.

Retorna uma matriz de nomes de propriedades para propriedades que devem ser indexadas.

Somente propriedades de string, inteiro, booleano, Date e NSDate são aceitas.

Substitua este método para especificar um mapa de nomes de propriedades público-privadas. Isso definirá um nome de propriedade persistente diferente no Realm e permitirá o uso do nome público para qualquer operação com a propriedade. (Ex: query, classificação, ...). Isto é muito útil se você precisar mapear os nomes das propriedades do seu JSON schema Device Sync para os nomes de propriedades locais.

class Person: Object {
    @Persisted var firstName: String
    @Persisted var birthDate: Date
    @Persisted var age: Int

    override class public func propertiesMapping() -> [String : String] {
        ["firstName": "first_name",
         "birthDate": "birth_date"]
    }
}

let migrationBlock = { migration, oldSchemaVersion in
    migration.enumerateObjects(ofType: "Person", { oldObj, newObj in
       let oldPropertyValue = oldObj!["first_name"] as! String
       // Use this value in migration
    })
}

Isso também deve ser feito ao renomear uma propriedade.

let migrationBlock = { migration, oldSchemaVersion in
    migration.renameProperty(onType: "Person", from: "first_name", to: "complete_name")
}

Retorna ou define o valor da propriedade com o nome fornecido.

Registra um bloco a ser chamado cada vez que o objeto for alterado.

O bloqueio será chamado de forma assíncrona após cada transação de escrita que exclua o objeto ou modifique qualquer uma das propriedades managed do objeto, incluindo autoatribuições que definem uma propriedade ao 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-chave for fornecido, o bloqueio será executado em qualquer inserção, modificação ou exclusão para todas as propriedades de primeiro nível do objeto. As notificações Object são rasas por padrão, qualquer modificação de propriedade aninhada não trigger uma notificação, a menos que o caminho chave para essa propriedade seja especificado. 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 Dog: Object {
    @Persisted var name: String
    @Persisted var adopted: Bool
    @Persisted var siblings: List<Dog>
}

// ... where `dog` is a managed Dog object.
dog.observe(keyPaths: ["adopted"], { changes in
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade adopted , mas não para quaisquer alterações feitas em name.
• Se o caminho da chave observado for ["siblings"] , qualquer inserção, exclusão ou modificação na lista siblings acionará o bloqueio. Uma alteração em someSibling.name não acionaria o bloqueio (onde someSibling é um elemento contido em siblings )

• Se o caminho da chave observado fosse ["siblings.name"] , qualquer inserção ou exclusão na lista siblings acionaria o bloqueio. Para objetos contidos na lista siblings , somente modificações em sua propriedade name acionarão o bloqueio.

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.

Somente objeto managed por um Realm podem ser observados dessa forma. 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 cada vez que o objeto for alterado.

O bloqueio será chamado de forma assíncrona após cada transação de escrita que exclua o objeto ou modifique qualquer uma das propriedades managed do objeto, incluindo autoatribuições que definem uma propriedade ao 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-chave for fornecido, o bloqueio será executado em qualquer inserção, modificação ou exclusão para todas as propriedades de primeiro nível do objeto. As notificações Object são rasas por padrão, qualquer modificação de propriedade aninhada não acionará uma notificação, a menos que o caminho chave para essa propriedade seja especificado. 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, eu

class Dog: Object {
    @Persisted var name: String
    @Persisted var adopted: Bool
    @Persisted var siblings: List<Dog>
}

// ... where `dog` is a managed Dog object.
dog.observe(keyPaths: [\Dog.adopted], { changes in
   // ...
})

• O bloco de notificação acima é acionado para alterações na propriedade adopted , mas não para quaisquer alterações feitas em name.
• Se o caminho da chave observado for [\Dog.siblings] , qualquer inserção, exclusão ou modificação na lista siblings acionará o bloqueio. Uma alteração em someSibling.name não acionaria o bloqueio (onde someSibling é um elemento contido em siblings )

• Se o caminho da chave observado fosse [\Dog.siblings.name] , qualquer inserção ou exclusão na lista siblings acionaria o bloqueio. Para objetos contidos na lista siblings , somente modificações em sua propriedade name acionarão o bloqueio.

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.

Somente objeto managed por um Realm podem ser observados dessa forma. 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 cada vez que o objeto for alterado.

O bloqueio será chamado de forma assíncrona no executor do ator fornecido após cada transação de escrita que exclua o objeto ou modifique qualquer uma das propriedades managed do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente. O bloco recebe uma cópia do objeto isolada para o ator solicitado, que pode ser usada com segurança nesse ator junto com informações sobre o que foi alterado.

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.

Somente objeto managed por um Realm podem ser observados dessa forma. 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.

Por padrão, somente alterações diretas nas propriedades do objeto produzirão notificações, e não alterações em objetos vinculados. Observe que isso é diferente das notificações de alteração de coleção. Se uma array de keypath não nula e não vazia for passada, somente as alterações nas propriedades identificadas por esses keypaths produzirão notificações de alteração. Os keypaths podem percorrer as propriedades do link para receber informações sobre alterações em objetos vinculados.

Registra um bloco a ser chamado cada vez que o objeto for alterado.

O bloqueio será chamado de forma assíncrona no executor do ator fornecido após cada transação de escrita que exclua o objeto ou modifique qualquer uma das propriedades managed do objeto, incluindo auto-atribuições que definem uma propriedade para seu valor existente. O bloco recebe uma cópia do objeto isolada para o ator solicitado, que pode ser usada com segurança nesse ator junto com informações sobre o que foi alterado.

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.

Somente objeto managed por um Realm podem ser observados dessa forma. 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.

Por padrão, somente alterações diretas nas propriedades do objeto produzirão notificações, e não alterações em objetos vinculados. Observe que isso é diferente das notificações de alteração de coleção. Se uma array de keypath não nula e não vazia for passada, somente as alterações nas propriedades identificadas por esses keypaths produzirão notificações de alteração. Os keypaths podem percorrer as propriedades do link para receber informações sobre alterações em objetos vinculados.

Retorna se dois Objeto de Realm são iguais.

O objeto são considerados os mesmos se e somente se forem managed pelo mesmo Realm e ponto para o mesmo objeto subjacente no reconhecimento de data center.

Indica se este objeto está congelado.

Retorna um snapshot congelado (imutável) deste objeto.

A cópia congelada é um objeto imutável que contém os mesmos dados que este objeto contém atualmente, mas não será atualizado quando forem feitas gravações no Realm que a contém. Ao contrário dos objetos ativos, os objetos congelados podem ser acessados de qualquer thread.

Retorna uma referência ativa (mutável) deste objeto.

Esse método cria um acessador gerenciado para uma cópia ativa do mesmo objeto congelado. Retornará a si mesmo se for chamado em um objeto já ativo.