iOS數(shù)據(jù)持久化——FMDB（對(duì)SQLite的輕量級(jí)封裝）

一、FMDB簡(jiǎn)介

FMDB是一種第三方的開源庫(kù)（ccgus/fmdb · GitHub），F(xiàn)MDB就是對(duì)SQLite的API進(jìn)行了封裝，加上了面向?qū)ο蟮乃枷耄屛覀儾槐厥褂梅爆嵉腃語(yǔ)言API函數(shù)，比起直接操作SQLite更加方便。

FMDB優(yōu)點(diǎn)：

  • 使用起來(lái)更加面向?qū)ο?，省去了很多麻煩、冗余的C語(yǔ)言代碼
  • 對(duì)比蘋果自帶的CoreData框架，更加輕量級(jí)和靈活
  • 提供多線程安全，有效地防止數(shù)據(jù)混亂，原來(lái)的SQLite不是線程安全的

FMDB缺點(diǎn)：

  • 因?yàn)槭荗C語(yǔ)言封裝的，失去了SQLite原來(lái)的跨平臺(tái)性（相對(duì)于其他語(yǔ)言）

使用FMDB的步驟：

  • 項(xiàng)目中添加 libsqlite3 庫(kù)的依賴
  • 導(dǎo)入FMDB源碼：
    下載FMDB的源代碼，將代碼文件拖入工程
  • 導(dǎo)入FMDB的頭文件 #import "FMDatabase.h"

當(dāng)然也可以使用 CocoaPods：

pod 'FMDB'
# pod 'FMDB/FTS'   # FMDB with FTS
# pod 'FMDB/standalone'   # FMDB with latest SQLite amalgamation source
# pod 'FMDB/standalone/FTS'   # FMDB with latest SQLite amalgamation source and FTS
# pod 'FMDB/SQLCipher'   # FMDB with SQLCipher

二、FMDB使用

使用FMDB前，需要先了解下3個(gè)主要類：

  • FMDatabase：表示一個(gè)SQLite數(shù)據(jù)庫(kù)，用于執(zhí)行SQL語(yǔ)句。
  • FMResultSet：表示在FMDatabase執(zhí)行一個(gè)查詢的結(jié)果集。
  • FMDatabaseQueue：如果要在多個(gè)線程上執(zhí)行查詢和更新，則使用此類。它描述了下面的“線程安全”部分。
1、創(chuàng)建數(shù)據(jù)庫(kù)

創(chuàng)建數(shù)據(jù)庫(kù)使用到的是 FMDatabase 的類方法：

/*
 1. 如果該路徑下已經(jīng)存在該數(shù)據(jù)庫(kù)，直接獲取該數(shù)據(jù)庫(kù);
 2. 如果不存在就創(chuàng)建一個(gè)新的數(shù)據(jù)庫(kù);
 3. 如果傳@""，會(huì)在臨時(shí)目錄創(chuàng)建一個(gè)空的數(shù)據(jù)庫(kù)，當(dāng)數(shù)據(jù)庫(kù)關(guān)閉時(shí)，數(shù)據(jù)庫(kù)文件也被刪除;
 4. 如果傳nil，會(huì)在內(nèi)存中臨時(shí)創(chuàng)建一個(gè)空的數(shù)據(jù)庫(kù)，當(dāng)數(shù)據(jù)庫(kù)關(guān)閉時(shí)，數(shù)據(jù)庫(kù)文件也被刪除;
*/
+ (FMDatabase *)databaseWithPath:(NSString *)filePath;

使用實(shí)例：

NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask,YES).lastObject; 
NSString *filePath = [path stringByAppendingPathComponent:@"FMDB.db"];
FMDatabase *database = [FMDatabase databaseWithPath:filePath];

注意：這里創(chuàng)建數(shù)據(jù)庫(kù)，并不會(huì)打開數(shù)據(jù)庫(kù)，和SQLite有點(diǎn)區(qū)別

2、打開數(shù)據(jù)庫(kù)、關(guān)閉數(shù)據(jù)庫(kù)

打開和關(guān)閉數(shù)據(jù)庫(kù)很簡(jiǎn)單：

/* 打開數(shù)據(jù)庫(kù)，成功返回YES，失敗返回NO */
- (BOOL)open;
/* 關(guān)閉數(shù)據(jù)庫(kù)，成功返回YES，失敗返回NO */
- (BOOL)close;
3、執(zhí)行更新的SQL語(yǔ)句

在FMDB中，除查詢以外的所有操作，都稱為“更新”。例如 create、drop、insert、update、delete 等SQL語(yǔ)句命令都是更新操作。

執(zhí)行更新的SQL語(yǔ)句用到的常用方法：

/* 執(zhí)行更新的SQL語(yǔ)句，字符串里面的"?"，依次用后面的參數(shù)替代，必須是對(duì)象，不能是int等基本類型 */
- (BOOL)executeUpdate:(NSString *)sql,... ;
/* 執(zhí)行更新的SQL語(yǔ)句，可以使用字符串的格式化進(jìn)行構(gòu)建SQL語(yǔ)句 */
- (BOOL)executeUpdateWithFormat:(NSString*)format,... ;
/* 執(zhí)行更新的SQL語(yǔ)句，字符串中有"?"，依次用arguments的元素替代 */
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;

下面的4種使用等價(jià)：

/* 1. 直接使用完整的SQL更新語(yǔ)句 */
[database executeUpdate:@"insert into mytable(num,name,sex) values(0,'liuting','m');"];

NSString *sql = @"insert into mytable(num,name,sex) values(?,?,?);";
/* 2. 使用不完整的SQL更新語(yǔ)句，里面含有待定字符串"?"，需要后面的參數(shù)進(jìn)行替代 */
[database executeUpdate:sql,@0,@"liuting",@"m"];
/* 3. 使用不完整的SQL更新語(yǔ)句，里面含有待定字符串"?"，需要數(shù)組參數(shù)里面的參數(shù)進(jìn)行替代 */
[database executeUpdate:sql 
   withArgumentsInArray:@[@0,@"liuting",@"m"]];

/* 4. SQL語(yǔ)句字符串可以使用字符串格式化，這種我們應(yīng)該比較熟悉 */
[database executeUpdateWithFormat:@"insert into mytable(num,name,sex) values(%d,%@,%@);",0,@"liuting","m"];

使用實(shí)例：

- (BOOL)createTable {
    NSString *sqlStr = @"create table mytable(num integer,name varchar(7),sex char(1),primary key(num));";
    BOOL res = [_database executeUpdate:sqlStr];
    if (!res) {
        NSLog(@"error when creating database table");
        [_database close];
    }
    return res;
}
4、執(zhí)行查詢的SQL語(yǔ)句

查詢SQL語(yǔ)句一般指 select 。

下面是常用實(shí)現(xiàn)方法：

/* 執(zhí)行查詢SQL語(yǔ)句，返回FMResultSet查詢結(jié)果 */
- (FMResultSet *)executeQuery:(NSString*)sql, ... ;
- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ... ;
- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;

處理結(jié)果FMResultSet的常用方法：

/* 獲取下一個(gè)記錄 */
- (BOOL)next;
/* 獲取記錄有多少列 */
- (int)columnCount;
/* 通過(guò)列名得到列序號(hào)，通過(guò)列序號(hào)得到列名 */
- (int)columnIndexForName:(NSString *)columnName;
- (NSString *)columnNameForIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的整形值 */
- (int)intForColumn:(NSString *)columnName;
- (int)intForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的長(zhǎng)整形值 */
- (long)longForColumn:(NSString *)columnName;
- (long)longForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的布爾值 */
- (BOOL)boolForColumn:(NSString *)columnName;
- (BOOL)boolForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的浮點(diǎn)值 */
- (double)doubleForColumn:(NSString *)columnName;
- (double)doubleForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的字符串 */
- (NSString *)stringForColumn:(NSString *)columnName;
- (NSString *)stringForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的日期數(shù)據(jù) */
- (NSDate *)dateForColumn:(NSString *)columnName;
- (NSDate *)dateForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的二進(jìn)制數(shù)據(jù) */
- (NSData *)dataForColumn:(NSString *)columnName;
- (NSData *)dataForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的UTF8格式的C語(yǔ)言字符串 */
- (const unsigned cahr *)UTF8StringForColumnName:(NSString *)columnName;
- (const unsigned cahr *)UTF8StringForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的對(duì)象，只能是NSNumber、NSString、NSData、NSNull */
- (id)objectForColumnName:(NSString *)columnName;
- (id)objectForColumnIndex:(int)columnIdx;

使用實(shí)例：

- (NSArray *)getResultFromDatabase{
    //執(zhí)行查詢SQL語(yǔ)句，返回查詢結(jié)果
    FMResultSet *result = [_database executeQuery:@"select * from mytable"];
    NSMutableArray *array = [NSMutableArray array];
    //獲取查詢結(jié)果的下一個(gè)記錄
    while ([result next]) {
        //根據(jù)字段名，獲取記錄的值，存儲(chǔ)到字典中
        NSMutableDictionary *dict = [NSMutableDictionary dictionary];
        int num  = [result intForColumn:@"num"];
        NSString *name = [result stringForColumn:@"name"];
        NSString *sex  = [result stringForColumn:@"sex"];
        dict[@"num"] = @(num);
        dict[@"name"] = name;
        dict[@"sex"] = sex;
        //把字典添加進(jìn)數(shù)組中
        [array addObject:dict];
    }
    return array;
}

三、多線程安全FMDatabaseQueue

FMDatabase這個(gè)類是線程不安全的，如果在多個(gè)線程同時(shí)使用一個(gè)FMDatabase實(shí)例，會(huì)造成數(shù)據(jù)混亂問(wèn)題。

為了保證線程安全，F(xiàn)MDB提供方便快捷的 FMDatabaseQueue類，要使用這個(gè)類，需要導(dǎo)入頭文件 #import"FMDatabaseQueue.h"，F(xiàn)MDatabaseQueue類的操作很多都和FMDatabase很相似。

1、創(chuàng)建
NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask,YES).lastObject; 
NSString *filePath = [path stringByAppendingPathComponent:@"FMDB.db"];
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:path];
2、操作數(shù)據(jù)庫(kù)
[queue inDatabase:^(FMDatabase*db) {
    //FMDatabase數(shù)據(jù)庫(kù)操作
}];

使用實(shí)例：

[queue inDatabase:^(FMDatabase*db) {
    //插入記錄到表中
    NSString *sqlStr = @"insert into mytable(num,name,sex) values(4,'xiaoming','m');";
    BOOL result = [db executeUpdate:sqlStr];
    if (!result) {
        NSLog(@"error when insert into database table");
        [db close];
    }
}];

四、事務(wù)

事務(wù)，是指作為單個(gè)邏輯工作單元執(zhí)行的一系列操作，要么完整地執(zhí)行，要么完全地不執(zhí)行。

想象一個(gè)場(chǎng)景，比如你要更新數(shù)據(jù)庫(kù)的大量數(shù)據(jù)，我們需要確保所有的數(shù)據(jù)更新成功，才采取這種更新方案，如果在更新期間出現(xiàn)錯(cuò)誤，就不能采取這種更新方案了。如果我們不使用事務(wù)，我們的更新操作直接對(duì)每個(gè)記錄生效，萬(wàn)一遇到更新錯(cuò)誤，已經(jīng)更新的數(shù)據(jù)怎么辦？難道我們要一個(gè)一個(gè)去找出來(lái)修改回來(lái)嗎？怎么知道原來(lái)的數(shù)據(jù)是怎么樣的呢？這個(gè)時(shí)候就需要使用事務(wù)實(shí)現(xiàn)。

之所以將事務(wù)放到FMDB中去說(shuō)并不是因?yàn)橹挥蠪MDB才支持事務(wù)，而是因?yàn)镕MDB將其封裝成了幾個(gè)方法來(lái)調(diào)用，不用自己寫對(duì)應(yīng)的SQL而已。

SQLite進(jìn)行事務(wù)的SQL語(yǔ)句：

只要在執(zhí)行SQL語(yǔ)句前加上以下的SQL語(yǔ)句，就可以使用事務(wù)功能了：
開啟事務(wù)的SQL語(yǔ)句，"begin transaction;"
進(jìn)行提交的SQL語(yǔ)句，"commit transaction;"
進(jìn)行回滾的SQL語(yǔ)句，"rollback transaction;"

只有事務(wù)提交了，開啟事務(wù)期間的操作才會(huì)生效

FMDatabase使用事務(wù)的方法：

//事務(wù) 
-(void)transaction {
    // 開啟事務(wù)
    [self.database beginTransaction]; 
    BOOL isRollBack = NO; 
    @try { 
        for (int i = 0; i<500; i++) { 
            NSNumber *num = @(i+1); 
            NSString *name = [[NSString alloc] initWithFormat:@"student_%d",i]; 
            NSString *sex = (i%2==0)?@"f":@"m";
            NSString *sql = @"insert into mytable(num,name,sex) values(?,?,?);"; 
            BOOL result = [database executeUpdate:sql,num,name,sex]; 
            if ( !result ) { 
                NSLog(@"插入失?。?);
                return; 
            } 
        } 
    } 
    @catch (NSException *exception) { 
        isRollBack = YES; 
        // 事務(wù)回退
        [self.database rollback]; 
    } 
    @finally { 
        if (!isRollBack) { 
            //事務(wù)提交
            [self.database commit]; 
        } 
    } 
}

FMDatabaseQueue使用事務(wù)的方法：

//多線程事務(wù) 
- (void)transactionByQueue { 
    //開啟事務(wù)
    [self.queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        for (int i = 0; i<500; i++) { 
            NSNumber *num = @(i+1); 
            NSString *name = [[NSString alloc] initWithFormat:@"student_%d",i]; 
            NSString *sex = (i%2==0)?@"f":@"m";
            NSString *sql = @"insert into mytable(num,name,sex) values(?,?,?);"; 
            BOOL result = [db executeUpdate:sql,num,name,sex]; 
            if ( !result ) { 
                //當(dāng)最后*rollback的值為YES的時(shí)候，事務(wù)回退，如果最后*rollback為NO，事務(wù)提交
                *rollback = YES;
                 return; 
            } 
        }
     }]; 
}

五、探索

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容