FMDB 是 Objective-C 對 SQLite 的物件化封裝,把 C API 的繁瑣指標操作包成 FMDatabase 與 FMResultSet 兩個主要物件,寫起來跟一般 ORM 有幾分相似。專案網址:https://github.com/ccgus/fmdb。
下載後把 FMDB 相關檔案拖進專案,並補上 libsqlite3.dylib(或 libsqlite3.tbd)連結,接著 #import "FMDB.h" 就可以開始。
iOS 的 App 沙盒中,Documents 目錄可讀寫,通常就把資料庫放這裡。若路徑下的檔案不存在,SQLite 會自動建立。
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDirectory = [paths objectAtIndex:0];
NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"Test.db"];
db = [FMDatabase databaseWithPath:dbPath];
if (![db open]) {
NSLog(@"Could not open db.");
return;
}
[db setShouldCacheStatements:YES]; // 開啟 statement 快取,提升查詢效率
-(void)creatTable
{
if (!db) { NSLog(@"資料庫不存在"); }
if (![db open]) { [db open]; }
// 先判斷表是否存在,避免重複建立
if (![db tableExists:@"User"]) {
// Name 為 text,Age 為 integer
[db executeUpdate:@"CREATE TABLE User (Name text, Age integer)"];
}
}
寫入時用 ? 佔位再傳參數,這就是參數化查詢,能避免 SQL 注入與引號處理問題。欄位型別對應關係:text ↔ NSString、integer ↔ NSNumber。
-(void)insertData:(NSString *)name age:(int)age
{
[db executeUpdate:@"INSERT INTO User (Name, Age) VALUES (?, ?)",
name, [NSNumber numberWithInt:age]];
}
取單一值可以直接用 stringForQuery:;要遍歷多筆則用 FMResultSet:
-(void)ResultSet
{
NSString *aa = [db stringForQuery:@"SELECT Name FROM User WHERE Age = ?", @"20"];
NSLog(@"aa is %@", aa);
FMResultSet *rs = [db executeQuery:@"SELECT * FROM User"];
while ([rs next]) {
NSLog(@"%@ %@", [rs stringForColumn:@"Name"], [rs stringForColumn:@"Age"]);
}
[rs close];
}
-(void)Modify
{
[db executeUpdate:@"UPDATE User SET Name = ? WHERE Name = ?", @"李四", @"張三"];
}
-(void)deleteData
{
[db executeUpdate:@"DELETE FROM User WHERE Age = ?", @(23)];
}
[db close],否則容易出現資料庫鎖定。FMDatabaseQueue,它會把操作序列化。[db beginTransaction] 包住整批,速度會比逐筆寫入快上一個數量級。PRAGMA table_info 檢查後再 ALTER TABLE),否則舊使用者的資料會出問題。