FMDB 是 iOS 平台上針對 SQLite 的 Objective-C 封裝框架,用物件導向的方式包裝了原本繁瑣的 C 語言 API。
直接使用 sqlite3 的 C API 時,得自己處理 statement 生命週期、手動綁定參數、逐欄位取值,程式碼冗長且容易出錯。FMDB 帶來的改善是:
1. 使用上更加物件導向,省下大量重複、瑣碎的 C 程式碼。
2. 比蘋果的 Core Data 更輕量、更靈活,SQL 完全由自己掌控。
3. 提供了執行緒安全的資料庫操作方式(FMDatabaseQueue),有效避免多執行緒下的資料混亂。
FMDatabase:一個 FMDatabase 物件代表一個獨立的 SQLite 資料庫,用來執行 SQL 語句。
FMResultSet:執行查詢後得到的結果集,用 next 逐筆遍歷。
FMDatabaseQueue:用於在多執行緒環境中執行多個查詢或更新,本身執行緒安全。
透過指定 SQLite 檔案路徑建立 FMDatabase 物件:
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
NSLog(@"資料庫開啟失敗!");
}
路徑有三種情況:
1. 具體檔案路徑 —— 檔案不存在時會自動建立。
2. 空字串 @"" —— 會在暫存目錄建立一個空的資料庫,當 FMDatabase 連線關閉時,檔案也會被刪除。
3. nil —— 建立一個記憶體內的暫存資料庫,連線關閉時資料即消失。
在 FMDB 中,除了查詢以外的所有操作統稱為「更新」,包括 create、drop、insert、update、delete 等,一律用 executeUpdate: 系列方法:
- (BOOL)executeUpdate:(NSString *)sql, ...; - (BOOL)executeUpdateWithFormat:(NSString *)format, ...; - (BOOL)executeUpdate:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;
[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @"20", @"Jack"];
- (FMResultSet *)executeQuery:(NSString *)sql, ...; - (FMResultSet *)executeQueryWithFormat:(NSString *)format, ...; - (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;
// 查詢資料
FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];
while ([rs next]) {
NSString *name = [rs stringForColumn:@"name"];
int age = [rs intForColumn:@"age"];
double score = [rs doubleForColumn:@"score"];
}
#pragma mark - 開啟資料庫
+ (FMDatabase *)openDB {
NSString *filePath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [filePath stringByAppendingPathComponent:@"BaiduMap.sqlite"];
FMDatabase *db = [FMDatabase databaseWithPath:fileName];
if ([db open]) {
return db;
}
return nil;
}
#pragma mark - 執行更新
+ (BOOL)upDate:(NSString *)sql {
FMDatabase *db = [self openDB];
if (db != nil) {
return [db executeUpdate:sql];
}
return NO;
}
#pragma mark - 建立資料表
+ (BOOL)createTable {
FMDatabase *db = [self openDB];
if (db != nil) {
NSString *sql = @"CREATE TABLE IF NOT EXISTS location_record ("
"ID INTEGER PRIMARY KEY AUTOINCREMENT, "
"latitude REAL NOT NULL, "
"longitude REAL NOT NULL, "
"time TEXT NOT NULL);";
return [db executeUpdate:sql];
}
return NO;
}
#pragma mark - 插入資料
+ (BOOL)insert:(float)latitude :(float)longitude :(NSString *)time {
NSString *sql = [NSString stringWithFormat:
@"INSERT INTO location_record(latitude, longitude, time) VALUES(%f, %f, '%@')",
latitude, longitude, time];
return [self upDate:sql];
}
#pragma mark - 查詢
+ (NSArray *)query:(NSString *)starTime :(NSString *)endTime :(int)startNumber {
FMDatabase *db = [self openDB];
if (db != nil) {
NSString *sql = [NSString stringWithFormat:
@"SELECT latitude, longitude FROM location_record "
"WHERE time > '%@' AND time < '%@' LIMIT %d, 60",
starTime, endTime, startNumber];
FMResultSet *resultSet = [db executeQuery:sql];
NSMutableArray *array = [NSMutableArray array];
while ([resultSet next]) {
double latitude = [resultSet doubleForColumnIndex:0];
double longitude = [resultSet doubleForColumnIndex:1];
[array addObject:[NSNumber numberWithDouble:latitude]];
[array addObject:[NSNumber numberWithDouble:longitude]];
}
return array;
}
return nil;
}
第一,不要用 stringWithFormat 拼 SQL。上面插入方法的寫法示範用,但把外部字串直接拼進 SQL 會造成 SQL Injection 風險,遇到單引號也會直接出錯。正確做法是用佔位符綁定:
+ (BOOL)insert:(float)latitude :(float)longitude :(NSString *)time {
FMDatabase *db = [self openDB];
return [db executeUpdate:@"INSERT INTO location_record(latitude, longitude, time) VALUES(?, ?, ?)",
@(latitude), @(longitude), time];
}
第二,時間欄位用 TEXT 存字串做比較容易出錯。建議改存時間戳(REAL 或 INTEGER),比較與排序都更可靠,也不受字串格式影響。
第三,欄位索引從 0 開始。原範例用 doubleForColumnIndex:1 取 latitude,但 SELECT 的第一個欄位索引應為 0。這類差一錯誤(off-by-one)在 FMDB 中很常見,建議改用 doubleForColumn:@"latitude" 以名稱取值,雖然略慢但可讀性與正確性都更好。
第四,記得關閉資料庫。用完后應呼叫 [db close],長時間持有大量連線會造成檔案鎖與記憶體問題。若有多執行緒存取需求,請改用 FMDatabaseQueue,把所有操作包在 inDatabase: 區塊裡。
前人栽樹後人乘涼——吃水不忘挖井人,也別忘了回頭看看 FMDB 的原始碼,能學到不少 Foundation 與執行緒的實務技巧。