您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 使用 FMDB 操作 SQLite:學習筆記與完整範例

編輯:iOS 開發綜合

FMDB 是 iOS 平台上針對 SQLite 的 Objective-C 封裝框架,用物件導向的方式包裝了原本繁瑣的 C 語言 API。

為什麼要用 FMDB

直接使用 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 與執行緒的實務技巧。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved