FMDB 是 iOS 平台上針對 SQLite 的封裝框架,本質上就是把 SQLite 的 C 語言 API 用 Objective-C 的方式重新包裝了一層。
它的好處很直接:
1. 更物件導向,省下大量繁瑣、重複的 C 語言程式碼;
2. 相較於蘋果自帶的 Core Data,更輕量、更靈活;
3. 提供多執行緒安全的資料庫操作方式,能有效避免資料混亂。
專案地址:
https://github.com/ccgus/fmdb
(1)FMDatabase:一個 FMDatabase 物件代表一個獨立的 SQLite 資料庫,用來執行 SQL 語句。
(2)FMResultSet:執行查詢後得到的結果集。
(3)FMDatabaseQueue:用於多執行緒環境下執行多個查詢或更新,天生執行緒安全。
只要給定 SQLite 檔案路徑,就能建立 FMDatabase 物件:
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
NSLog(@"資料庫開啟失敗!");
}
路徑有三種常見寫法:
(1)具體檔案路徑:若檔案不存在會自動建立。
(2)空字串 @"":會在暫存目錄建立一個空的資料庫,連線關閉時檔案一併刪除。
(3)nil:建立記憶體中的臨時資料庫,連線關閉時資料庫即銷毀。
在 FMDB 的用語裡,除了查詢以外的操作都叫「更新」,包含 create、drop、insert、update、delete 等。
- (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"];
}
第一步,建立專案並匯入 libsqlite3 函式庫,同時加入主標頭檔:

第二步,下載第三方框架 FMDB:

第三步,撰寫程式碼:
#import "YYViewController.h"
#import "FMDB.h"
@interface YYViewController ()
@property (nonatomic, strong) FMDatabase *db;
@end
@implementation YYViewController
- (void)viewDidLoad {
[super viewDidLoad];
// 1. 取得資料庫檔案路徑
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"student.sqlite"];
// 2. 取得資料庫
FMDatabase *db = [FMDatabase databaseWithPath:fileName];
// 3. 開啟資料庫
if ([db open]) {
// 4. 建表
BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
if (result) {
NSLog(@"建表成功");
} else {
NSLog(@"建表失敗");
}
}
self.db = db;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
[self delete];
[self insert];
[self query];
}
// 插入資料
- (void)insert {
for (int i = 0; i < 10; i++) {
NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)];
// 不確定的參數用 ? 佔位
[self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);", name, @(arc4random_uniform(40))];
// 也可以改用 withArgumentsInArray
// [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);" withArgumentsInArray:@[name, @(arc4random_uniform(40))]];
// executeUpdateWithFormat 則用 %@、%d 佔位
// [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);", name, arc4random_uniform(40)];
}
}
// 清空資料
- (void)delete {
[self.db executeUpdate:@"DROP TABLE IF EXISTS t_student;"];
[self.db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
}
// 查詢
- (void)query {
FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];
while ([resultSet next]) {
int ID = [resultSet intForColumn:@"id"];
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSLog(@"%d %@ %d", ID, name, age);
}
}
@end
執行結果:

小提醒:如果 id 設為 autoincrement,把表裡的資料刪掉之後再插入新資料,id 不會從 0 重新開始,而是接著原本的號碼繼續編號。
另外要注意寫法,佔位符不要加上單引號,直接用 %@ 即可,FMDB 會自動判斷為字串:

(1)一樣需要先匯入 FMDB 框架與標頭檔;由於它依賴 libsqlite,這個函式庫也要一併匯入。

(2)程式碼如下:
#import "YYViewController.h"
#import "FMDB.h"
@interface YYViewController ()
@property (nonatomic, strong) FMDatabaseQueue *queue;
@end
@implementation YYViewController
- (void)viewDidLoad {
[super viewDidLoad];
// 1. 取得資料庫檔案路徑
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"person.sqlite"];
// 2. 取得資料庫佇列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];
// 3. 透過佇列操作資料庫
[queue inDatabase:^(FMDatabase *db) {
BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
if (result) {
NSLog(@"建表成功");
} else {
NSLog(@"建表失敗");
}
}];
self.queue = queue;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
// 查詢資料
[self.queue inDatabase:^(FMDatabase *db) {
FMResultSet *resultSet = [db executeQuery:@"SELECT * FROM t_person"];
while ([resultSet next]) {
int ID = [resultSet intForColumn:@"id"];
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSLog(@"%d %@ %d", ID, name, age);
}
}];
}
@end
先插入資料再查詢,輸出如下:

(3)觀念說明:有了佇列物件之後,它內部會自動持有資料庫物件,而且所有操作都是執行緒安全的。

以轉帳為例最容易理解:

張三和李四帳戶裡各有 1000 元,張三要轉帳給李四需要執行兩條 SQL。基於安全性考量,這兩條語句必須「要嘛全部成功,要嘛全部失敗」。事務就是把多條語句包在同一個交易裡,中途出錯就自動回滾,這也是所謂的原子性。
做法一:手動 beginTransaction / commit
[self.queue inDatabase:^(FMDatabase *db) {
[db beginTransaction];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
[db commit];
}];
中途出問題時會自動回滾,也可以選擇手動回滾:
[self.queue inDatabase:^(FMDatabase *db) {
[db beginTransaction];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
[db rollback];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
[db commit];
}];
上面這段程式碼裡,前三條插入語句因為 rollback 而全部作廢。
做法二:使用 inTransaction,由系統自動開啟與提交事務:
[self.queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
}];
它的流程是:先開啟事務,執行 block 中的程式碼,最後提交事務;若將 rollback 設為 YES 即可回滾。這種寫法比手動管理更簡潔,也比較不容易漏掉 commit。