FMDB-sqlite第三方类库

大家好我是你们的颜大人
由于FMDB是建立在SQLite的之上的，所以你至少也该把这篇文章从头到尾读一遍。与此同时，把SQLite的文档页加到你的书签中。自动引用计数（APC）还是手动内存管理呢？
两种都行，FMDB会在编译的时候知道你是用的哪一种，然后进行相应处理。
<h4>使用方法</h4>

<h5>FMDB有三个主要的类</h5>
1.FMDatabase – 表示一个单独的SQLite数据库。用来执行SQLite的命令。
2.FMResultSet – 表示FMDatabase执行查询后结果集
3.FMDatabaseQueue – 如果你想在多线程中执行多个查询或更新，你应该使用该类。这是线程安全的。

<h5>数据库创建</h5>
创建FMDatabase对象时参数为SQLite数据库文件路径。该路径可以是以下三种之一：
1..文件路径。该文件路径无需真实存，如果不存在会自动创建。
2..空字符串(@””)。表示会在临时目录创建一个空的数据库，当FMDatabase 链接关闭时，文件也被删除。
3.NULL. 将创建一个内在数据库。同样的，当FMDatabase连接关闭时，数据会被销毁。

(如需对临时数据库或内在数据库进行一步了解，请继续阅读：<a href="http://www.sqlite.org/inmemorydb.html" target="_blank" rel="external">http://www.sqlite.org/inmemorydb.html</a>)

<figure class="highlight gherkin"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>FMDatabase db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
</pre></td></tr></table></figure>

<h5>打开数据库</h5>
在和数据库交互之前，数据库必须是打开的。如果资源或权限不足无法打开或创建数据库，都会导致打开失败。

<figure class="highlight stata"><table><tr><td class="gutter"><pre>1
2
3
4
</pre></td><td class="code"><pre>if (![db open]) { 
 [db release]; 
 return; 
 }
</pre></td></tr></table></figure>

<h5>执行更新</h5>
一切不是SELECT命令的命令都视为更新。这包括 CREATE, UPDATE, INSERT,ALTER,COMMIT, BEGIN, DETACH, DELETE, DROP, END, EXPLAIN, VACUUM, and REPLACE （等）。
简单来说，只要不是以SELECT开头的命令都是UPDATE命令。

执行更新返回一个BOOL值。YES表示执行成功，否则表示有那些错误。你可以调用 -lastErrorMessage 和 -lastErrorCode方法来得到更多信息。

<h5>执行查询</h5>
SELECT命令就是查询，执行查询的方法是以 -excuteQuery开头的。

执行查询时，如果成功返回FMResultSet对象，错误返回nil. 与执行更新相当，支持使用 NSError参数。同时，你也可以使用 -lastErrorCode和-lastErrorMessage获知错误信息。

为了遍历查询结果，你可以使用while循环。你还需要知道怎么跳到下一个记录。使用FMDB，很简单实现，就像这样：

<figure class="highlight elixir"><table><tr><td class="gutter"><pre>1
2
3
4
</pre></td><td class="code"><pre>FMResultSet s = [db executeQuery:@"SELECT * FROM myTable"]; 
while ([s next]) { 
 //retrieve values for each record 
}
</pre></td></tr></table></figure>

你必须一直调用 -[FMResultSet next] 在你访问查询返回值之前，甚至你只想要一个记录：

<figure class="highlight groovy"><table><tr><td class="gutter"><pre>1
2
3
4
</pre></td><td class="code"><pre>FMResultSet s = [db executeQuery:@"SELECT COUNT() FROM myTable"]; 
 if ([s next]) { 
 int totalCount = [s intForColumnIndex:0]; 
 }
</pre></td></tr></table></figure>

FMResultSet 提供了很多方法来获得所需的格式的值：

intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumnIndex:
objectForColumn:

这些方法也都包括 {type}ForColumnIndex 的这样子的方法，参数是查询结果集的列的索引位置。

你无需调用 [FMResultSet close]来关闭结果集, 当新的结果集产生，或者其数据库关闭时，会自动关闭。

关闭数据库
当使用完数据库，你应该 -close 来关闭数据库连接来释放SQLite使用的资源。

<figure class="highlight ini"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>[db close];
</pre></td></tr></table></figure>

<h4>事务</h4>
FMDatabase是支持事务的。
<h5>数据净化（数据格式化）</h5>

使用FMDB，插入数据前，你不要花时间审查你的数据。你可以使用标准的SQLite数据绑定语法。
INSERT INTO myTable VALUES (?, ?, ?) 
SQLite会识别 “?” 为一个输入的点位符，这样的执行会接受一个可变参数（或者表示为其他参数，如NSArray, NSDictionary,或va_list等），会正确为您转义。
你也可以选择使用命名参数语法。
INSERT INTO myTable VALUES (:id, :name, :value) 
参数名必须以冒名开头。SQLite本身支持其他字符，当Dictionary key的内部实现是冒号开头。注意你的NSDictionary key不要包含冒号。
<figure class="highlight groovy"><table><tr><td class="gutter"><pre>1
2
</pre></td><td class="code"><pre>NSDictionary argsDict = [NSDictionary dictionaryWithObjectsAndKeys:@"My Name", @"name", nil]; 
 [db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)" withParameterDictionary:argsDict];
</pre></td></tr></table></figure>
而且，代码不能这么写（为什么？想想吧。）
<figure class="highlight sql"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has " lots of ' bizarre " quotes '"];
</pre></td></tr></table></figure>
你应该：
<figure class="highlight sql"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has " lots of ' bizarre " quotes '"];
</pre></td></tr></table></figure>
提供给 -executeUpdate: 方法的参数都必须是对象。就像以下的代码就无法工作，且会产生崩溃。
<figure class="highlight sql"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>[db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];
</pre></td></tr></table></figure>
 正确有做法是把数字打包成 NSNumber对象
<figure class="highlight clojure"><table><tr><td class="gutter"><pre>1
2
</pre></td><td class="code"><pre>[db executeUpdate:@"INSERT INTO myTable VALUES (?)", 
[NSNumber numberWithInt:42]];
</pre></td></tr></table></figure>
或者，你可以使用 -executeWithFormat: ，这是NSString风格的参数
<figure class="highlight sql"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>[db executeUpdateWithFormat:@"INSERT INTO myTable VALUES (%d)", 42];
</pre></td></tr></table></figure>
 -executeWithFormat: 的方法的内部实现会帮你封装数据，以下这些修饰符都可以使用： %@, %c, %s, %d, %D,%i, %u, %U, %hi, %hu, %qi, %qu, %f, %g, %ld, %lu, %lld, and %llu. 除此之外的修饰符可能导致无法预知的结果。一些情况下，你需要在SQL语句中使用 % 字符，你应该使用 %%。
使用FMDatabaseQueue 及线程安全
在多个线程中同时使用一个FMDatabase实例是不明智的。现在你可以为每个线程创建一个FMDatabase对象。不要让多个线程分享同一个实例，它无法在多个线程中同时使用。若此，坏事会经常发生，程序会时不时崩溃，或者报告异常，或者陨石会从天空中掉下来砸到你Mac Pro. 总之很崩溃。所以，不要初始化FMDatabase对象，然后在多个线程中使用。请使用 FMDatabaseQueue，它是你的朋友而且会帮助你。以下是使用方法：
首先创建队列。
<figure class="highlight accesslog"><table><tr><td class="gutter"><pre>1
</pre></td><td class="code"><pre>FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];
</pre></td></tr></table></figure>
这样使用。
<figure class="highlight clojure"><table><tr><td class="gutter"><pre>1
2
3
4
5
6
7
8
9
</pre></td><td class="code"><pre>[queue inDatabase:^(FMDatabase *db) { 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]]; 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]]; 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]]; 
 FMResultSet *rs = [db executeQuery:@"select * from foo"]; 
 while([rs next]) { 
 … 
 } 
}];
</pre></td></tr></table></figure>
像这样，轻松地把简单任务包装到事务里：
<figure class="highlight clojure"><table><tr><td class="gutter"><pre>1
2
3
4
5
6
7
8
9
10
</pre></td><td class="code"><pre>[queue inTransaction:^(FMDatabase *db, BOOL *rollback) { 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]]; 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]]; 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]]; 
 if (whoopsSomethingWrongHappened) { 
 *rollback = YES; return; 
 } 
 // etc… 
 [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]]; 
 }];
</pre></td></tr></table></figure>
 FMDatabaseQueue 后台会建立系列化的G-C-D队列，并执行你传给G-C-D队列的块。这意味着你从多线程同时调用调用方法，GDC也会按它接收的块的顺序来执行。谁也不会吵到谁的脚，每个人都幸福。

最后编辑于：2017.12.03 03:56:53

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 198,932评论 5赞 466
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 83,554评论 2赞 375
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 145,894评论 0赞 328
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 53,442评论 1赞 268
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 62,347评论 5赞 359
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 47,899评论 1赞 275
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,325评论 3赞 390
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 35,980评论 0赞 254
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,196评论 1赞 294
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,163评论 2赞 317
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,085评论 1赞 328
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 32,826评论 3赞 316
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,389评论 3赞 302
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,501评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 30,753评论 1赞 255
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,171评论 2赞 344
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 41,616评论 2赞 339

FMDB-sqlite第三方类库

推荐阅读更多精彩内容