Reagir a alterações - SDK do Flutter

Registrar um ouvinte de alteração de query

Você pode registrar um manipulador de notificações em qualquer query dentro de um Realm. O manipulador recebe um RealmResultsChanges objeto, que inclui a descrição das alterações desde a última notificação. RealmResultsChanges contém as seguintes propriedades:

// Listen for changes on whole collection
final characters = realm.all<Character>();
final subscription = characters.changes.listen((changes) {
  changes.inserted; // Indexes of inserted objects.
  changes.modified; // Indexes of modified objects.
  changes.deleted; // Indexes of deleted objects.
  changes.newModified; // Indexes of modified objects after accounting for deletions & insertions.
  changes.moved; // Indexes of moved objects.
  changes.results; // The full List of objects.
  changes.isCleared; // `true` after call to characters.clear(); otherwise, `false`.
});
// Listen for changes on RealmResults.
final hobbits = fellowshipOfTheRing.members.query('species == "Hobbit"');
final hobbitsSubscription = hobbits.changes.listen((changes) {
  // ... all the same data as above
});

Registrar um ouvinte de alteração do RealmObject

Você pode registrar um manipulador de notificações em um objeto específico dentro de um Realm. O Realm notifica seu manipulador quando qualquer propriedade do objeto é alterada. O manipulador recebe um RealmObjectChanges objeto, que inclui a descrição das alterações desde a última notificação. RealmObjectChanges contém as seguintes propriedades:

final frodoSubscription = frodo.changes.listen((changes) {
  changes.isDeleted; // If the object has been deleted.
  changes.object; // The RealmObject being listened to, `frodo`.
  changes.properties; // The changed properties.
});

Registrar ouvintes de alteração de coleção

Você pode registrar um manipulador de notificação em uma coleção de qualquer um dos tipos de dados suportados dentro de outro RealmObject. O Realm notifica seu manipulador quando algum dos itens da coleção é alterado. O manipulador recebe um dos seguintes objetos que inclui uma descrição das alterações desde a última notificação:

• RealmListChanges objeto para RealmList

• RealmSetChanges objeto para RealmSet

• RealmMapChanges objeto para RealmMap

final fellowshipSubscription =
    fellowshipOfTheRing.members.changes.listen((changes) {
  changes.inserted; // Indexes of inserted objects.
  changes.modified; // Indexes of modified objects.
  changes.deleted; // Indexes of deleted objects.
  changes.newModified; // Indexes of modified objects after accounting for deletions & insertions.
  changes.moved; // Indexes of moved objects.
  changes.list; // The full RealmList of objects.
  changes.isCleared; // `true` after call to fellowshipOfTheRing.members.clear(); otherwise, `false`.
  changes.isCollectionDeleted; // `true` if the collection is deleted; otherwise, `false`.
});

Registre um ouvinte de alteração de instância de usuário

No Flutter SDK versão 1.9.0 e posterior, você pode registrar um manipulador de notificações em uma instância User específica dentro de um Realm. O Realm notifica seu manipulador quando qualquer propriedade do usuário é alterada (por exemplo, o token de acesso do usuário é atualizado ou o estado do usuário é alterado). O manipulador recebe um UserChanges objeto, que inclui a descrição das alterações desde a última notificação. UserChanges contém a seguinte propriedade:

final userSubscription = user.changes.listen((changes) {
  changes.user; // the User being listened to
});