|
上一節(jié)我已經(jīng)介紹了SQLite的簡單使用,不了解的可以提前去看一下iOS學(xué)習(xí)筆記16-數(shù)據(jù)庫SQLite,這節(jié)我們來講下FMDB。
一、FMDB介紹
FMDB是一種第三方的開源庫,F(xiàn)MDB就是對SQLite的API進(jìn)行了封裝,加上了面向?qū)ο蟮乃枷耄屛覀儾槐厥褂梅爆嵉腃語言API函數(shù),比起直接操作SQLite更加方便。
FMDB優(yōu)點(diǎn):
- 使用起來更加面向?qū)ο?,省去了很多麻煩、冗余的C語言代碼
- 對比蘋果自帶的CoreData框架,更加輕量級和靈活
- 提供多線程安全,有效地防止數(shù)據(jù)混亂,原來的SQLite不是線程安全的
FMDB缺點(diǎn):
因?yàn)槭荗C語言封裝的,失去了SQLite原來的跨平臺(tái)性
我們要使用FMDB需要的步驟:
- 項(xiàng)目中添加
libsqlite3庫的依賴 - 導(dǎo)入FMDB源碼:
下載FMDB的源代碼,將代碼文件拖入工程 -
#import導(dǎo)入FMDB的頭文件"FMDatabase.h"
二、FMDB使用
使用FMDB前,需要先了解下3個(gè)主要類:
-
FMDatabase : 一個(gè)單一的SQLite數(shù)據(jù)庫,用于執(zhí)行SQL語句。 -
FMResultSet :執(zhí)行查詢一個(gè)FMDatabase結(jié)果集。 -
FMDatabaseQueue :在多個(gè)線程來執(zhí)行查詢和更新時(shí)會(huì)使用這個(gè)類。
一般的FMDB數(shù)據(jù)庫操作有:
- 創(chuàng)建數(shù)據(jù)庫
- 打開數(shù)據(jù)庫、關(guān)閉數(shù)據(jù)庫
- 執(zhí)行更新的SQL語句
- 執(zhí)行查詢的SQL語句
1.創(chuàng)建數(shù)據(jù)庫
創(chuàng)建數(shù)據(jù)庫使用到的是FMDatabase的類方法:
/*
1. 如果該路徑下已經(jīng)存在該數(shù)據(jù)庫,直接獲取該數(shù)據(jù)庫;
2. 如果不存在就創(chuàng)建一個(gè)新的數(shù)據(jù)庫;
3. 如果傳@"",會(huì)在臨時(shí)目錄創(chuàng)建一個(gè)空的數(shù)據(jù)庫,當(dāng)數(shù)據(jù)庫關(guān)閉時(shí),數(shù)據(jù)庫文件也被刪除;
4. 如果傳nil,會(huì)在內(nèi)存中臨時(shí)創(chuàng)建一個(gè)空的數(shù)據(jù)庫,當(dāng)數(shù)據(jù)庫關(guān)閉時(shí),數(shù)據(jù)庫文件也被刪除;
*/
+ (FMDatabase *)databaseWithPath:(NSString *)filePath;
下面是實(shí)例:
NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask,YES).firstObject;
NSString *filePath = [path stringByAppendingPathComponent:@"FMDB.db"];
FMDatabase *database = [FMDatabase databaseWithPath:filePath];
注意:這里創(chuàng)建數(shù)據(jù)庫,并不會(huì)打開數(shù)據(jù)庫,和SQLite有點(diǎn)區(qū)別
2. 打開數(shù)據(jù)庫、關(guān)閉數(shù)據(jù)庫
打開和關(guān)閉數(shù)據(jù)庫很簡單:
/* 打開數(shù)據(jù)庫,成功返回YES,失敗返回NO */
- (BOOL)open;
/* 關(guān)閉數(shù)據(jù)庫,成功返回YES,失敗返回NO */
- (BOOL)close;
3. 執(zhí)行更新的SQL語句
在FMDB中,除查詢以外的所有操作,都稱為“更新”。 例如create、drop、insert、update、delete等SQL語句命令都是更新操作。
執(zhí)行更新的SQL語句用到的常用方法:
/* 執(zhí)行更新的SQL語句,字符串里面的"?",依次用后面的參數(shù)替代,必須是對象,不能是int等基本類型 */
- (BOOL)executeUpdate:(NSString *)sql,... ;
/* 執(zhí)行更新的SQL語句,可以使用字符串的格式化進(jìn)行構(gòu)建SQL語句 */
- (BOOL)executeUpdateWithFormat:(NSString*)format,... ;
/* 執(zhí)行更新的SQL語句,字符串中有"?",依次用arguments的元素替代 */
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;
下面的4種使用等價(jià):
/* 1. 直接使用完整的SQL更新語句 */
[database executeUpdate:@"insert into mytable(num,name,sex) values(0,'liuting','m');"];
NSString *sql = @"insert into mytable(num,name,sex) values(?,?,?);";
/* 2. 使用不完整的SQL更新語句,里面含有待定字符串"?",需要后面的參數(shù)進(jìn)行替代 */
[database executeUpdate:sql,@0,@"liuting",@"m"];
/* 3. 使用不完整的SQL更新語句,里面含有待定字符串"?",需要數(shù)組參數(shù)里面的參數(shù)進(jìn)行替代 */
[database executeUpdate:sql
withArgumentsInArray:@[@0,@"liuting",@"m"]];
/* 4. SQL語句字符串可以使用字符串格式化,這種我們應(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語句
查詢SQL語句一般指select
下面是常用實(shí)現(xiàn)方法:
/* 執(zhí)行查詢SQL語句,返回FMResultSet查詢結(jié)果 */
- (FMResultSet *)executeQuery:(NSString*)sql, ... ;
- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ... ;
- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;
處理結(jié)果FMResultSet的常用方法:
/* 獲取下一個(gè)記錄 */
- (BOOL)next;
/* 獲取記錄有多少列 */
- (int)columnCount;
/* 通過列名得到列序號,通過列序號得到列名 */
- (int)columnIndexForName:(NSString *)columnName;
- (NSString *)columnNameForIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的整形值 */
- (int)intForColumn:(NSString *)columnName;
- (int)intForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的長整形值 */
- (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語言字符串 */
- (const unsigned cahr *)UTF8StringForColumnName:(NSString *)columnName;
- (const unsigned cahr *)UTF8StringForColumnIndex:(int)columnIdx;
/* 獲取存儲(chǔ)的對象,只能是NSNumber、NSString、NSData、NSNull */
- (id)objectForColumnName:(NSString *)columnName;
- (id)objectForColumnIndex:(int)columnIdx;
使用實(shí)例:
- (NSArray *)getResultFromDatabase{
//執(zhí)行查詢SQL語句,返回查詢結(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ù)混亂問題。 為了保證線程安全,F(xiàn)MDB提供方便快捷的FMDatabaseQueue類,要使用這個(gè)類,需要#import導(dǎo)入頭文件"FMDatabaseQueue.h",FMDatabaseQueue類的操作很多都和FMDatabase很相似
1. 創(chuàng)建
NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask,YES).firstObject;
NSString *filePath = [path stringByAppendingPathComponent:@"FMDB.db"];
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:path];
2. 操作數(shù)據(jù)庫
[queue inDatabase:^(FMDatabase*db) {
//FMDatabase數(shù)據(jù)庫操作
}];
使用實(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è)場景,比如你要更新數(shù)據(jù)庫的大量數(shù)據(jù),我們需要確保所有的數(shù)據(jù)更新成功,才采取這種更新方案,如果在更新期間出現(xiàn)錯(cuò)誤,就不能采取這種更新方案了,如果我們不使用事務(wù),我們的更新操作直接對每個(gè)記錄生效,萬一遇到更新錯(cuò)誤,已經(jīng)更新的數(shù)據(jù)怎么辦?難道我們要一個(gè)一個(gè)去找出來修改回來嗎?怎么知道原來的數(shù)據(jù)是怎么樣的呢?這個(gè)時(shí)候就需要使用事務(wù)實(shí)現(xiàn)。
之所以將事務(wù)放到FMDB中去說并不是因?yàn)橹挥?code>FMDB才支持事務(wù),而是因?yàn)?code>FMDB將其封裝成了幾個(gè)方法來調(diào)用,不用自己寫對應(yīng)的SQL而已。
SQLite進(jìn)行事務(wù)的SQL語句:
只要在執(zhí)行SQL語句前加上以下的SQL語句,就可以使用事務(wù)功能了:
開啟事務(wù)的SQL語句,"begin transaction;"
進(jìn)行提交的SQL語句,"commit transaction;"
進(jìn)行回滾的SQL語句,"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;
}
}
}];
}
發(fā)現(xiàn)一個(gè)很好的關(guān)于FMDB文檔《FMDB類的說明文檔》,里面雖然是英文的,但是列出了所有的FMDB類的方法,很棒!下面是截圖:
 FMDB類說明文檔
有什么問題可以在下方評論區(qū)中提出,一起學(xué)習(xí),O(∩_∩)O哈!
|