Congelar dados - SDK do Flutter
Nesta página
O congelamento cria um snapshot imutável dos dados em um Realm no momento do congelamento. Objeto congelados não estão ativos e não são atualizados automaticamente. Não é possível gravar em dados congelados. Depois que os dados são congelados, eles não podem ser descongelados.
Você pode congelar os seguintes Tipo de objeto de Realm:
Congelar um Realm
Crie um snapshot congelado de um Realm inteiro com Realm.freeze() . Quando terminar de trabalhar com o Realm congelado, você deve fechá-lo para evitar vazamentos de memória.
final config = Configuration.local([Person.schema, Scooter.schema]); final realm = Realm(config); // Add scooter owned by Mace Windu final maceWindu = Person(ObjectId(), "Mace", "Windu"); final purpleScooter = Scooter(ObjectId(), "Purple scooter", owner: maceWindu); realm.write(() { realm.add(purpleScooter); }); // Create frozen snapshot of realm final frozenRealm = realm.freeze(); // Update data in the realm final quiGonJinn = Person(ObjectId(), "Qui-Gon", "Jinn"); realm.write(() { purpleScooter.owner = quiGonJinn; }); // Data changes not in the frozen snapshot final purpleScooterFrozen = frozenRealm.query<Scooter>("name == \$0", ["Purple scooter"]).first; print(purpleScooterFrozen.owner!.firstName); // prints 'Mace' // You must also close the frozen realm before exiting the process frozenRealm.close();
Congelar resultados do Realm
Crie um snapshot congelado de RealmResults
com RealmResults.freeze(). Quando terminar de trabalhar com os dados congelados, você deverá fechar o Realm associado a eles para evitar vazamentos de memória.
// Add data to the realm final maceWindu = Person(ObjectId(), "Mace", "Windu"); final jocastaNu = Person(ObjectId(), "Jocasta", "Nu"); realm.write(() => realm.addAll([maceWindu, jocastaNu])); // Get RealmResults and freeze data final people = realm.all<Person>(); final frozenPeople = people.freeze(); // Update data in the non-frozen realm final newLastName = "Foo"; realm.write(() { for (var person in people) { person.lastName = newLastName; } }); // Data changes not in the frozen snapshot final frozenFooPeople = frozenPeople.query("lastName == \$0", [newLastName]); print(frozenFooPeople.length); // prints 0 // You must also close the frozen realm associated // with the frozen RealmResults before exiting the process frozenPeople.realm.close();
Congelar um RealmObject
Crie um snapshot congelado de um RealmObject
com RealmObject.freeze(). Quando terminar de trabalhar com os dados congelados, você deverá fechar o Realm associado a eles para evitar vazamentos de memória.
final person = realm.query<Person>( 'firstName == \$0 AND lastName == \$1', ["Count", "Dooku"]).first; // Freeze RealmObject final frozenPerson = person.freeze(); // Change data in the unfrozen object. realm.write(() { realm.delete(person); }); // Frozen person snapshot still exists even though data deleted // in the unfrozen realm print(frozenPerson.isValid); // prints true print(person.isValid); // prints false // You must also close the frozen realm associated // with the frozen RealmObject before exiting the process frozenPerson.realm.close();
Congelar um RealmList em um RealmObject
Crie um snapshot congelado de RealmList
em um RealmObject
com RealmList.freeze(). Quando terminar de trabalhar com os dados congelados, você deverá fechar o Realm associado a eles para evitar vazamentos de memória.
final firstPerson = realm.query<Person>("firstName = \$0", ["Yoda"]).first; // Freeze RealmList in a RealmObject final firstPersonAttributesFrozen = firstPerson.attributes.freeze(); // Change data in the unfrozen realm final newAttribute = "quick"; realm.write(() { // Append item to list firstPerson.attributes.add(newAttribute); }); final index = firstPersonAttributesFrozen.indexOf(newAttribute); print(index); // prints -1 because cannot find new attribute // You must also close the frozen realm associated // with the frozen RealmList before exiting the process firstPersonAttributesFrozen.realm.close();
Verifique se os dados estão congelados
Verifique se algum dos tipos de dados congeláveis está congelado com a propriedade isFrozen
. isFrozen
retorna true
se um objeto estiver congelado e false
se for um objeto ativo.
// You can check if all freezable types are frozen // with the `isFrozen` property. final realm = Realm(config); print(realm.isFrozen); final people = realm.all<Person>(); print(people.isFrozen); final firstPerson = realm.query<Person>("firstName = \$0", ["Yoda"]).first; print(firstPerson.isFrozen); final firstPersonAttributes = firstPerson.attributes; print(firstPersonAttributes.isFrozen);