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

iOS 開發之 FMDB:SQLite 資料庫操作完整指南

編輯:iOS 開發綜合

SQLite 作為一個輕量級資料庫,佔用記憶體極少,因此在各類嵌入式裝置中被廣泛使用。iOS SDK 很早就支援 SQLite——只要加入 libsqlite3.dylib 並引入 sqlite3.h 即可使用。但原生 SQLite 的 C API 並不友善,實務上通常會做一層封裝,其中最流行的開源方案就是 FMDB。

FMDB 的三個主要類別

FMDatabase:代表一個獨立的 SQLite 資料庫,用來執行 SQLite 指令。

FMResultSet:代表 FMDatabase 執行查詢後的結果集。

FMDatabaseQueue:在多執行緒環境中執行操作時使用,能確保執行緒安全。

建立資料庫

建立 FMDatabase 物件時需要傳入 SQLite 資料庫檔案路徑,該路徑可以是以下三種之一:

1. 檔案路徑。該檔案不需要真實存在,若不存在會自動建立。

2. 空字串 @""。會在暫存目錄建立一個臨時資料庫,當 FMDatabase 連線關閉時,檔案也被刪除。

3. NULL。會建立一個記憶體資料庫,同樣地,連線關閉時資料即被銷毀。

記憶體與臨時資料庫的差異

通常資料庫存放在磁碟中,但我們也可以讓它駐留在記憶體裡。記憶體資料庫的優點是操作速度快(存取記憶體的耗時遠低於磁碟),但缺點也很明顯:由於沒有被持久化,關閉後立刻消失,斷電或程式崩潰都會導致資料遺失;不支援讀寫互斥,需要自己加鎖;無法被其他進程存取。

臨時資料庫與記憶體資料庫非常相似:各自獨立、連線關閉後自動消失、底層檔案自動刪除。差別在於,當臨時資料庫的資料量過大時,SQLite 為了保留記憶體給其他操作使用,會把部分資料寫到磁碟檔案中;而記憶體資料庫則始終把資料留在記憶體裡。

開啟資料庫

進行任何操作之前,必須先把資料庫打開。若資源或權限不足,開啟會失敗。

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDirectory = [paths objectAtIndex:0];

// 資料庫路徑,存放在 Documents 目錄下
NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"MYTest.db"];

// 建立資料庫實例;若路徑中不存在 MYTest.db,SQLite 會自動建立
FMDatabase *db = [FMDatabase databaseWithPath:dbPath];

if (![db open]) {
    NSLog(@"Could not open db.");
    return;
}

更新操作

除了 SELECT 之外,其餘指令都視為更新操作,包含 CREATE、UPDATE、INSERT、ALTER、COMMIT、BEGIN、DETACH、DELETE、DROP、END、EXPLAIN、VACUUM、REPLACE 等。

// 建立資料表
[db executeUpdate:@"CREATE TABLE myTable (Name text, Age integer)"];

// 插入
[db executeUpdate:@"INSERT INTO myTable (Name, Age) VALUES (?, ?)", @"jason", [NSNumber numberWithInt:20]];

// 更新
[db executeUpdate:@"UPDATE myTable SET Name = ? WHERE Name = ?", @"john", @"jason"];

// 刪除
[db executeUpdate:@"DELETE FROM myTable WHERE Name = ?", @"jason"];

查詢操作

SELECT 指令就是查詢,對應的方法以 executeQuery 開頭。查詢成功會回傳 FMResultSet 物件,失敗則回傳 nil。讀取資料時需要用 while 迴圈逐筆取出:

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
    // 從每一筆紀錄中取出欄位值
}

關閉資料庫

用完之後應該呼叫 close 關閉連線,釋放 SQLite 使用的資源。

[db close];

參數化查詢

按照標準 SQL 語法,用 ? 佔位:

INSERT INTO myTable VALUES (?, ?, ?)

然後透過 executeUpdate 把實際參數傳入,通常用可變參數的方式:

NSString *sql = @"insert into myTable (name, password) values (?, ?)";
[db executeUpdate:sql, user.name, user.password];

要注意的是,參數必須是 NSObject 的子類。像 int、double、bool 這種基本型別必須先包裝:

[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];

使用參數化查詢不只是為了方便,更是為了防止 SQL Injection——絕對不要用字串拼接的方式把外部輸入塞進 SQL 語句裡。

多執行緒操作

FMDatabase 物件本身不是執行緒安全的。多執行緒下操作時必須改用 FMDatabaseQueue:以資料庫檔案路徑初始化佇列,然後把操作包成 block 傳入 inDatabase:。即使多個執行緒同時呼叫,該 queue 也會保證這些操作依序執行。

// 建立佇列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];

// 使用方式
[queue inDatabase:^(FMDatabase *db) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];

    FMResultSet *rs = [db executeQuery:@"select * from foo"];
    while ([rs next]) {
        // ...
    }
}];

事務的處理方式類似,透過 inTransaction:,並在需要回滾時把 rollback 參數設為 YES:

[queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];

    if (somethingWrongHappened) {
        *rollback = YES;   // 發生錯誤,回滾整個事務
        return;
    }

    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];
}];

最後提醒一個實務重點:即便用了 FMDatabaseQueue 保證執行緒安全,「多執行緒同時寫入同一顆資料庫」本身就容易效能瓶頸。常見做法是為寫入與讀取分別建立獨立的 queue(WAL 模式下可支援讀寫並行),並在 FMDatabaseQueue 上設定 shouldDefragment 或搭配 setMaxBusyRetryTimeInterval 處理鎖等待,避免高併發時出現 database is locked 錯誤。

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