您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

FMDB 源碼剖析:FMDatabaseQueue 與 FMDatabasePool 的多執行緒設計

編輯:iOS 開發綜合

一、前言

承接上一篇,先快速盤點 FMDB 的組成:

  • FMResultSet:查詢結果集。
  • FMDatabase:單一 SQLite 資料庫的操作實例,增刪改查都靠它。
  • FMDatabaseAdditions:對 FMDatabase 的分類擴充,簡化單值查詢,並提供表/欄是否存在、版本號、SQL 校驗等能力。
  • FMDatabaseQueue:以序列佇列支援多執行緒操作。
  • FMDatabasePool:以任務池的形式提供多執行緒支援,但官方並不推薦(原話是:除非你只做讀取,否則你會遇到死鎖,請改用 FMDatabaseQueue)。

FMDB 最值得研究的地方就在多執行緒處理,而新版本主要靠 FMDatabaseQueue 來解決。本篇就從這個類下手。

二、FMDatabaseQueue 基本用法

- (void)FMDatabaseQueueTest {
    NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName = [doc stringByAppendingPathComponent:@"students.sqlite"];

    FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];

    [queue inDatabase:^(FMDatabase *db) {
        [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student_2 (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
        [db executeUpdate:@"INSERT INTO t_student_2 (name, age) VALUES ('yixiangZZ', 20);"];
        [db executeUpdate:@"INSERT INTO t_student_2 (name, age) VALUES ('yixiangXX', 25);"];

        FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student_2"];
        while ([rs next]) {
            NSLog(@"%d %@ %d", [rs intForColumn:@"id"], [rs stringForColumn:@"name"], [rs intForColumn:@"age"]);
        }
    }];

    // 事務版本:出問題時把 rollback 設為 YES 即可整體撤銷
    [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        [db executeUpdate:@"UPDATE t_student_2 SET age = 40 WHERE name = 'yixiangZZ'"];
        [db executeUpdate:@"UPDATE t_student_2 SET age = 45 WHERE name = 'yixiangXX'"];
        if (hasProblem) { *rollback = YES; return; }
    }];
}

2.1 初始化:建立一個序列佇列

+ (instancetype)databaseQueueWithPath:(NSString *)aPath {
    FMDatabaseQueue *q = [[self alloc] initWithPath:aPath];
    FMDBAutorelease(q);
    return q;
}

- (instancetype)initWithPath:(NSString *)aPath flags:(int)openFlags vfs:(NSString *)vfsName {
    self = [super init];
    if (self) {
        _db = [[[self class] databaseClass] databaseWithPath:aPath];
        FMDBRetain(_db);
#if SQLITE_VERSION_NUMBER >= 3005000
        BOOL success = [_db openWithFlags:openFlags vfs:vfsName];
#else
        BOOL success = [_db open];
#endif
        if (!success) {
            NSLog(@"Could not create database queue for path %@", aPath);
            FMDBRelease(self);
            return 0x00;
        }
        _path = FMDBReturnRetained(aPath);

        // 重點:建立一個 GCD 序列佇列
        _queue = dispatch_queue_create([[NSString stringWithFormat:@"fmdb.%@", self] UTF8String], NULL);

        // 把這個序列佇列和 self 綁定,日後可用同一組 key 取回綁定的物件
        dispatch_queue_set_specific(_queue, kDispatchQueueSpecificKey, (__bridge void *)self, NULL);
        _openFlags = openFlags;
    }
    return self;
}

2.2 序列執行:inDatabase:

這段程式碼最值得看的是開頭那個防死鎖的判斷。

- (void)inDatabase:(void (^)(FMDatabase *db))block {
    // 取出「當前佇列」綁定的物件。若等於 self,代表我們已經在這個佇列裡了
    FMDatabaseQueue *currentSyncQueue = (__bridge id)dispatch_get_specific(kDispatchQueueSpecificKey);
    assert(currentSyncQueue != self && "inDatabase: was called reentrantly on the same queue, which would lead to a deadlock");

    FMDBRetain(self);
    dispatch_sync(_queue, ^{
        FMDatabase *db = [self database];
        block(db);
        if ([db hasOpenResultSets]) {
            NSLog(@"Warning: there is at least one open result set around after performing [FMDatabaseQueue inDatabase:]");
        }
    });
    FMDBRelease(self);
}

dispatch_sync 把 block 送進序列佇列,同一時間只會有一個 block 在跑,這就是執行緒安全的來源。但如果 block 內部又呼叫一次 inDatabase:,就會在序列佇列上同步等待自己,直接死鎖。蘋果早期提供 dispatch_get_current_queue 用來判斷,但那個 API 因為無法正確表達「某段同步區間」而被废弃;改用 dispatch_queue_set_specific + dispatch_get_specific 才是正解——前者替特定佇列貼上標籤,後者在任何程式碼位置都能讀出當前佇列的標籤,語意精準。

順帶一提,為什麼可以開多個 FMDatabaseQueue?因為每個 queue 各自綁一個 FMDatabase 實例,彼此獨立,可以並發操作不同的連線。

2.3 多執行緒下的行為

把多個任務用 dispatch_async 丟到全域佇列,再各自呼叫同一個 queue 的 inDatabase::

FMDatabaseQueue *queue1 = [FMDatabaseQueue databaseQueueWithPath:fileName];
[queue1 inDatabase:^(FMDatabase *db) {
    for (int i = 0; i < 10; i++) NSLog(@"queue1---%zi--%@", i, [NSThread currentThread]);
}];
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
    [queue1 inDatabase:^(FMDatabase *db) {
        for (int i = 11; i < 20; i++) NSLog(@"queue1---%zi--%@", i, [NSThread currentThread]);
    }];
});
// 第三個任務同理,i 從 20 到 30

執行結果顯示:即使從多條執行緒呼叫,日誌依然是 0→9、11→19、20→29 嚴格遞增,完全序列化。

原因在設計註解裡寫得很清楚:FMDatabaseQueue 本身並不是佇列,它內部建立一個 serial 的 dispatch_queue_t 來消化 inDatabase / inTransaction 傳入的 block,所以呼叫端看起來是同步的。這樣做是為了避免並發存取資料庫——資料庫請求可能在任何時刻、來自任何執行緒(例如各種網路回呼)。內建序列佇列後,所有資料庫存取都被序列化,而且比 @synchronized 或 NSLock 更有效率。

但不同 queue 之間是可以並發的:

FMDatabaseQueue *queue1 = [FMDatabaseQueue databaseQueueWithPath:fileName];
FMDatabaseQueue *queue2 = [FMDatabaseQueue databaseQueueWithPath:fileName];
// 兩個 queue 各自派發任務到全域佇列

結果是每個 queue 内部保持序列,兩個 queue 之間交錯並行。結論很明確:

也就是說,若你讓多個 queue 去操作同一個資料庫檔,就不再保證執行緒安全了——SQLite 層級還是有自己的鎖機制可以擋,但效能與錯誤處理都會變差。實務上請遵守「一個資料庫連線配一個 queue」的原則。

2.4 事務的實作

事務是資料庫安全的另一道防線:一段 SQL 要嘛全部成功,要嘛全部不生效。

- (void)inTransaction:(void (^)(FMDatabase *db, BOOL *rollback))block {
    [self beginTransaction:NO withBlock:block];
}

- (void)beginTransaction:(BOOL)useDeferred withBlock:(void (^)(FMDatabase *db, BOOL *rollback))block {
    FMDBRetain(self);
    dispatch_sync(_queue, ^{                       // 一樣走序列佇列,保證安全
        BOOL shouldRollback = NO;
        if (useDeferred) [[self database] beginDeferredTransaction];  // 延遲事務
        else             [[self database] beginTransaction];          // 預設排他事務
        block([self database], &shouldRollback);
        if (shouldRollback) [[self database] rollback];
        else                [[self database] commit];
    });
    FMDBRelease(self);
}

關於三種事務模式的差異(SQLite 3.0.8 以上):延遲(DEFERRED)在資料庫第一次被存取前不取鎖,BEGIN 本身什麼都不做;首次讀取建立 SHARED 鎖,首次寫入建立 RESERVED 鎖。因為取鎖被延後,其他執行緒/行程有機會在 BEGIN 之後搶先寫入,進而導致最終寫入時失敗。即時(IMMEDIATE)在執行 BEGIN 時立刻取 RESERVED 鎖,此後其他執行緒不能寫入,但仍可讀取。排他(EXCLUSIVE)直接取 EXCLUSIVE 鎖,事務結束前任何其他執行緒或行程都不能讀也不能寫。鎖得越早,並發度越低但衝突越少,這是一個典型的取捨。

2.5 存檔點與回滾

存檔點(savepoint)讓你能在較大的事務中間標記若干可獨立回退的位置,不必整批作廢。

- (NSError *)inSavePoint:(void (^)(FMDatabase *db, BOOL *rollback))block {
#if SQLITE_VERSION_NUMBER >= 3007000
    static unsigned long savePointIdx = 0;
    __block NSError *err = 0x00;
    FMDBRetain(self);
    dispatch_sync(_queue, ^{
        NSString *name = [NSString stringWithFormat:@"savePoint%ld", savePointIdx++];
        BOOL shouldRollback = NO;
        if ([[self database] startSavePointWithName:name error:&err]) {
            block([self database], &shouldRollback);
            if (shouldRollback) [[self database] rollbackToSavePointWithName:name error:&err];
            [[self database] releaseSavePointWithName:name error:&err];   // 無論如何都要釋放
        }
    });
    FMDBRelease(self);
    return err;
#else
    // SQLite 版本過低時回報錯誤
#endif
}

注意 releaseSavePointWithName: 一定要呼叫,否則存檔點會一直留在連線上,造成資源累積。

三、關於 FMDatabasePool

FMDatabasePool 用任務池的方式提供多執行緒支援,內部維護多個 FMDatabase 實例輪流使用。聽起來很美好,但官方明確表示不推薦——那句全大寫的警告值得抄下來:ONLY_USE_THE_POOL_IF_YOU_ARE_DOING_READS OTHERWISE YOULL_DEADLOCK USE_FMDATABASEQUEUE INSTEAD。原因是池中的連線若被巢狀呼叫反覆借出遲遲不歸還,很快就會耗盡而互等。實務上幾乎用不到,這裡就不展開了;記住結論就好:優先選 FMDatabaseQueue。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved