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