CRUD - 作成 - Flutter SDK

書込みトランザクション (write transaction)

SDK はトランザクション単位で書込みを処理します。 トランザクションは 、SDK が単一の分割不可の操作として取り扱う読み取りと書込み操作のリストです。 言い換えれば、トランザクションはすべてであるか、または何もなかったようになります。つまり、トランザクション内のすべての操作が成功するか、トランザクション内のどの操作が有効になりません。

すべての書込み (write) はトランザクション内で発生する必要があります。

データベースでは一度に 1 つのトランザクションのみを許可します。 SDK は、オープン トランザクションが完了するまで、他のスレッドへの他の書込みをブロックします。 その結果、トランザクション内で データベースから値を読み取るときに競合状態は発生しません。

トランザクションが完了すると、SDK はトランザクションをコミットまたはキャンセルします。

• SDK がトランザクションをコミットすると、すべての変更がディスクに書込まれます。 同期されたデータベースの場合、SDK は Atlas Device Sync との同期のために変更をキューに入れます。

• SDK が書込みトランザクションをキャンセルするか、トランザクション内の操作によってエラーが発生すると、すべての変更は破棄されます（または「ロールバック」）。

realm.write((){
  // ...write data to realm
});

final yoda = realm.write<Person>(() {
  return realm.add(Person(ObjectId(), 'Yoda'));
});

// Add Leia to the realm using `writeAsync`
Person leia = Person(ObjectId(), "Leia");
realm.writeAsync(() {
  realm.add<Person>(leia);
});

オブジェクトの作成

このページの例では、 PersonとTeamという 2 つのオブジェクトタイプを使用しています。

@RealmModel()
class _Person {
  @PrimaryKey()
  late ObjectId id;
  late String name;
  late List<String> hobbies;
}
@RealmModel()
class _Team {
  @PrimaryKey()
  late ObjectId id;
  late String name;
  late List<_Person> crew;
  late RealmValue eventLog;
}

realm.write(() {
  realm.add(Person(ObjectId(), 'Lando'));
});

realm.write(() {
  realm.addAll([
    Person(ObjectId(), 'Figrin D\'an'),
    Person(ObjectId(), 'Greedo'),
    Person(ObjectId(), 'Toro')
  ]);
});