FMDB 是 Objective-C 對 SQLite 的物件導向封裝,讓你不必直接處理 C 的指標與 callback。本文示範兩個實務上最常見的操作:把查詢結果映射成模型陣列,以及在單一交易中批次更新多筆資料。
+ (NSMutableArray *)queryGoodsByDayFlightId:(NSString *)dayFlightId {
FMDatabase *fmdb = [SADBManager sharedDB];
if (!fmdb) {
NSLog(@"資料庫開啟失敗");
return nil;
}
NSString *query = [NSString stringWithFormat:
@"SELECT * FROM FlightGoods WHERE dayFlightId = '%@'", dayFlightId];
FMResultSet *rs = [fmdb executeQuery:query];
NSMutableArray *invArray = [NSMutableArray array];
FlightGoods *goods;
while ([rs next]) {
goods = [[FlightGoods alloc] init];
goods.dayFlightId = [rs stringForColumn:@"dayFlightId"];
goods.goodsCode = [rs stringForColumn:@"goodsCode"];
goods.goodsName = [rs stringForColumn:@"goodsName"];
goods.goodsUnit = [rs stringForColumn:@"goodsUnit"];
goods.remarks = [rs stringForColumn:@"remarks"];
goods.cabinStockNum = @([rs intForColumn:@"cabinStockNum"]);
goods.loseNum = @([rs intForColumn:@"loseNum"]);
goods.actualNum = @([rs intForColumn:@"actualNum"];
// 保留原始值,後續用來比對是否發生變動
goods.tempActualNum = goods.actualNum;
goods.tempLoseNum = goods.loseNum;
goods.tempRemarks = goods.remarks;
[invArray addObject:goods];
}
return invArray;
}
FMResultSet 的 next 行為等同游標往前移,因此用 while 迴圈逐列取出。型別取用方法與 SQLite 對應:stringForColumn:、intForColumn:、doubleForColumn:、dataForColumn:。
+ (BOOL)updateGoods:(NSMutableArray *)flightGoodsArr {
FMDatabase *fmdb = [SADBManager sharedDB];
if (!fmdb) {
return NO;
}
[fmdb beginTransaction];
BOOL isRollBack = NO;
@try {
for (int i = 0; i < flightGoodsArr.count; i++) {
FlightGoods *goods = flightGoodsArr[i];
NSString *sql = [NSString stringWithFormat:
@"UPDATE FlightGoods SET actualNum = '%@', loseNum = '%@', remarks = '%@' "
"WHERE goodsCode = '%@'",
goods.actualNum, goods.loseNum, goods.remarks, goods.goodsCode];
if (![fmdb executeUpdate:sql]) {
NSLog(@"更新失敗:%@", goods.goodsCode);
}
}
} @catch (NSException *exception) {
isRollBack = YES;
[fmdb rollback];
} @finally {
if (!isRollBack) {
[fmdb commit];
}
}
return !isRollBack;
}
批次更新若逐筆各自 commit,每筆都是一次獨立的磁碟寫入。以數百筆資料計算,磁碟 I/O 會成為明顯瓶頸,介面上就是卡住不動。包成單一交易後,所有變更只在最後一次 commit 時落盤,速度通常能有一到兩個數量級的差距。
交易的另一個價值在一致性:若中途任何一筆失敗,rollback 能讓整批資料回到更新前的狀態,不會出現「改了一半」的殘缺資料。
一、SQL 注入風險。範例中用 stringWithFormat: 拼接 SQL,若值來自使用者輸入,攻擊者可藉單引號注入任意指令。正確做法是用參數化查詢:
FMResultSet *rs = [fmdb executeQuery:
@"SELECT * FROM FlightGoods WHERE dayFlightId = ?", dayFlightId];
[fmdb executeUpdate:
@"UPDATE FlightGoods SET actualNum = ?, loseNum = ?, remarks = ? WHERE goodsCode = ?",
goods.actualNum, goods.loseNum, goods.remarks, goods.goodsCode];
除了安全性,參數化也能讓 SQLite 重用已編譯的 statement,效能更好。
二、失敗時應回傳 NO 而非 nil。原範例的 updateGoodsByFlightGoods: 宣告回傳 BOOL 卻寫成 return nil;,雖然 nil 會被轉為 NO 而不報錯,但語意上仍以 return NO; 為宜。
三、單筆失敗不該靜默。目前邏輯在 executeUpdate 回傳 NO 時只印 log 就繼續,最後仍會 commit。若要求全批要嘛全成功、要嘛全失敗,應在失敗時把 isRollBack 設為 YES 並跳出迴圈。
FMDatabaseQueue,它會為每個操作配一條序列佇列。resultDictionary 搭配 KVC 批量賦值,省下大量重複程式碼。