CRUD - Swift SDK

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

Realm は高効率のストレージ エンジンを使用してオブジェクトを永続化します。 Realm でオブジェクトを作成し、Realm 内のオブジェクトを更新し、最終的に Realm からオブジェクトを削除することができます。 これらの操作は Realm の状態を変更するため、書込み (write) と呼びます。

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

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

Realm では一度に 1 つのトランザクションのみを開くことができます。 Realm は、開いているトランザクションが完了するまで、他のスレッドへの他の書込みをブロックします。 その結果、トランザクション内で Realm から値を読み取るときに競合状態は発生しません。

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

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

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

// Open the default realm.
RLMRealm *realm = [RLMRealm defaultRealm];
// Open a thread-safe transaction.
[realm transactionWithBlock:^() {
    // ... Make changes ...
    // Realm automatically cancels the transaction in case of exception.
    // Otherwise, Realm automatically commits the transaction at the
    // end of the code block.
}];

// Open the default realm.
let realm = try! Realm()
// Prepare to handle exceptions.
do {
    // Open a thread-safe transaction.
    try realm.write {
        // Make any writes within this code block.
        // Realm automatically cancels the transaction
        // if this code throws an exception. Otherwise,
        // Realm automatically commits the transaction
        // after the end of this code block.
    }
} catch let error as NSError {
    // Failed to write to realm.
    // ... Handle error ...
}

インターフェース駆動型書込み

Realm は常に通知を非同期に配信するため、UI スレッドをブロックすることはありません。 ただし、UI に変更を即座に反映する必要がある状況もあります。 書き込みと同時に UI を直接更新すると、最終通知はその更新をdoubleにする可能性があります。 これにより、UI とバッキング データ ストア間の状態が一致しないため、アプリがクラッシュする可能性があります。 これを回避するには、特定のハンドラーに通知を送信せずに書き込みます。 このタイプのトランザクションはインターフェース駆動型書込みと呼ばれます。

インターフェース駆動型書込み（サイレント書込みとも呼ばれる）は、同期された Realm できめ細かなコレクション通知を使用する場合に特に便利です。 現在のユーザーの更新にインターフェースベースの書込み (write) を使用し、UI をすぐに更新しますが、同期プロセスでは標準の通知を使用して UI を更新できます。