FMDB

优秀的第三方库,README 也是很优秀的,理解了 README,会对使用带来很多便利。

ARC 和 MRC

项目中使用 ARC 还是 MRC,对使用 FMDB 都没有任何影响,FMDB 会在编译项目时自动匹配。

使用

在 FMDB 中有三个重要的类:

FMDatabase:是一个提供 SQLite 数据库的类,用于执行 SQL 语句。

FMResultSet:用在FMDatabase中执行查询的结果的类。

FMDatabaseQueue:在多线程下查询和更新数据库用到的类。



数据库创建

FMDatabase是通过一个 SQLite 数据库文件路径创建的,此路径可以是以下三者之一:

一个文件的系统路径。磁盘中可以不存在此文件,因为如果不存在会自动为你创建。

一个空的字符串@""。会在临时位置创建一个空的数据库,当FMDatabase连接关闭时,该数据库会被删除。

NULL。会在内存中创建一个数据库,当FMDatabase连接关闭时,该数据库会被销毁。


// 创建数据库示例FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];

打开数据库

数据库必须是打开状态,才能与之交互。如果没有足够的资源和权限来打开\创建数据库,数据库会打开失败。

数据库更新

SQL 语句中除过SELECT语句都可以称之为更新操作。包括CREATE,UPDATE,INSERT,ALTER,COMMIT,BEGIN,DETACH,DROP,END,EXPLAIN,VACUUM,REPLACE等。一般只要不是以SELECT开头的 SQL 语句,都是更新语句。

执行更新语句后会返回一个BOOL值,返回YES表示执行更新语句成功,返回NO表示出现错误,可以通过调用-lastErrorMessage和-lastErrorCode方法获取更多错误信息。

数据库查询

通过调用-executeQuery...方法之一执行SELECT语句进行数据库查询操作。

执行查询操作后,如果成功会返回一个FMResultSet对象,反之会返回nil。通过-lastErrorMessage和-lastErrorCode方法可以确定为什么会查询失败。

为了遍历查询结果,需要while()循环,然后逐条记录查看。在 FMDB 中,可以通过下面的简单方式实现:

FMResultSet*s = [dbexecuteQuery:@"SELECT * FROM myTable"];while([snext]) {//每条记录的检索值}

即使只需要获取一个数据,也还是必须在访问查询结果前调用-[FMResultSet next]。

// 示例FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];if([s next]) {inttotalCount = [s intForColumnIndex:0];}

FMResultSet提供了很多方便的方法来查询数据:

intForColumn:

longForColumn:

longLongIntForColumn:

boolForColumn:

doubleForColumn:

stringForColumn:

dateForColumn:

dataForColumn:

dataNoCopyForColumn:

UTF8StringForColumn:

objectForColumn:

这些方法都有一个{type}ForColumnIndex:变体,是基于列的位置来查询数据。

通常情况下,一个FMResultSet没有必要手动-close,因为结果集合 (result set) 被释放或者源数据库关闭会自动关闭。

关闭数据库

当对数据库进行查询和更新操作完成后,需要调用-close关闭数据库FMDatabase的连接。

// 示例[db close];

事务

FMDatabase可以通过调用方法来开始和提交事务,也可以通过执行开始\结束事务  (begin\end transaction) 语句。

多语句和批处理

FMDatabase可以通过-executeStatements:withResultBlock:方法在一个字符串中执行多语句。

// 示例NSString *sql = @"createtablebulktest1 (idintegerprimarykeyautoincrement, xtext);"                "createtablebulktest2 (idintegerprimarykeyautoincrement, ytext);"                "createtablebulktest3 (idintegerprimarykeyautoincrement, ztext);"                "insertintobulktest1 (x)values('XXX');"                "insertintobulktest2 (y)values('YYY');"                "insertintobulktest3 (z)values('ZZZ');";success = [db executeStatements:sql];sql = @"selectcount(*)ascountfrombulktest1;"      "selectcount(*)ascountfrombulktest2;"      "selectcount(*)ascountfrombulktest3;";success = [self.db executeStatements:sql withResultBlock:^int(NSDictionary *dictionary) {    NSInteger count = [dictionary[@"count"] integerValue];    XCTAssertEqual(count, 1, @"expected one record for dictionary %@", dictionary);    return0;}];

数据处理

当给 FMDB 提供 SQL 语句时,在插入前不应该处理任何数据,而应该使用标准的 SQLite 的绑定语法。

// 示例INSERTINTOmyTableVALUES(?, ?, ?)

?问号在 SQLite 中意为即将插入的值的占位符,FMDB 执行语句的方法都接受多个参数 (或者参数集合,比如NSArray,NSDictionary,va_list),它们都会正确转义。

也可以使用命名参数语法:

// 示例INSERTINTOmyTableVALUES(:id, :name, :value)

这些参数必须以冒号开头,SQLite 自身支持其他字符,但是命名时字典的键内部以冒号开头,就不能在你的字典的键中包含冒号。

// 示例NSDictionary*argsDict = [NSDictionarydictionaryWithObjectsAndKeys:@"My Name",@"name",nil];[db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)"withParameterDictionary:argsDict];

因此,不应该写类似下面这行一样的错误代码:

// 错误示例[db executeUpdate:[NSString stringWithFormat:@"INSERTINTOmyTableVALUES(%@)", @"this has \" lots of ' bizarre \" quotes '"]];

而应该这样写:

// 正确示例[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", @"this has \" lots of ' bizarre \" quotes '"];

所有传递给-executeUpdate:方法的参数都必须是对象。下面写法执行不会起作用而且会引发崩溃:

// 错误示例[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", 42];

插入一个数的正确方法是把这个数字包装成NSNumber对象:

// 正确示例[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:42]];

也可以使用-execute*WithFormat:这个方法将数字转换成字符串:

// 转换成字符串示例[db executeUpdateWithFormat:@"INSERTINTOmyTableVALUES(@d)", 42];

-execute*WithFormat:这些方法后面都可以接格式字符串参数,以下 % 百分号格式符都是可以识别的:%@,%c,%s,%d,%D,%i,%u,%U,%hi,%hu,%qi,%qu,%f,%g,%ld,%lu,%lld,%llu。使用其他格式符可能会出现不可预知的问题。出于某种原因,可能需要在你的 SQL 语句中使用%字符,应该使用百分号转义一下%%。

FMDatabaseQueue 队列和线程安全

在多线程中同时使用 FMDatabase 单例是极其错误的想法,会导致每个线程创建一个 FMDatabase 对象。不要跨线程使用单例,也不要同时跨多线程,不然会奔溃或者异常。

因此不要实例化一个 FMDatabase 单例来跨线程使用。

相反,使用 FMDatabaseQueue,下面就是它的使用方法:

第一,创建队列。

// 创建 FMdatabaseQueue 示例FMDatabaseQueue *queue= [FMDatabaseQueue databaseQueueWithPath:aPath];

然后这样使用:

// 示例[queue inDatabase:^(FMDatabase *db) {    [db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:1]];

[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:2]];

[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:3]];

FMResultSet *rs = [db executeQuery:@"select *fromfoo"];

while ([rs next]) {

...

}

}];

把操作放在事务中也很简单,比如:

// 示例[queue inTransaction:^(FMDatabase *db,BOOL*rollback) {    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:1]];    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:2]];    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:3]];if(whoopsSomethingWrongHappened) {        *rollback =YES;return;    }// ...[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:4]];}];

FMDatabase 将块代码 block 运行在一个串行队列上,即使在多线程同时调用 FMDatabaseQueue 的方法,它们仍然还是顺序执行。这种查询和更新方式不会影响其它,是线程安全的。

基于 block 自定义 SQLite 函数

这是可以的,例子可以在 main.m 中的makeFunctionNamed:方法查看。

Swift

在 Swift 项目中也可以使用 FMDB,需要做以下步骤:

将 FMDB 的.m和.h全部文件拖进你的项目。

如果 Xcode 提示创建桥接文件,需要点击创建。如果没有提示,且项目中也没有桥接文件,需要手动添加。点此查看桥接文件更多信息

在桥接文件中,添加这行代码:#import "FMDB.h"

可以从 "src/extra/Swift Extension" 文件夹中拷贝FMDatabaseVariadic.swift文件到项目中,就可以使用executeUpdate和executeQuery多参数了。

做完上述几步,就可以使用 FMDatabase 写 Swift 代码了。

// 示例letdocumentsFolder =NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask,true)[0]asStringletpath = documentsFolder.stringByAppendingPathComponent("test.sqlite")letdatabase =FMDatabase(path: path)if!database.open() {println("Unable to open database")return}if!database.executeUpdate("create table test(x text, y text, z text)", withArgumentsInArray:nil) {println("create table failed:\(database.lastErrorMessage())")}if!database.executeUpdate("insert into test (x, y, z) values (?, ?, ?)", withArgumentsInArray: ["a","b","c"]) {println("insert 1 table failed:\(database.lastErrorMessage())")}if!database.executeUpdate("insert into test (x, y, z) values (?, ?, ?)", withArgumentsInArray: ["e","f","g"]) {println("insert 2 table failed:\(database.lastErrorMessage())")}ifletrs = database.executeQuery("select x, y, z from test", withArgumentsInArray:nil) {whilers.next() {letx = rs.stringForColumn("x")lety = rs.stringForColumn("y")letz = rs.stringForColumn("z")println("x =\(x); y =\(y); z =\(z)")    }}else{println("select failed:\(database.lastErrorMessage())")}database.close()

本文实际是对FMDB的 README 简单翻译,以方便使用 FMDB。


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容