FMDB 简化 SQLite

由于FMDB是建立在sqlite的之上的，所以你至少也该把这篇文章从头到尾读一遍。与此同时，把sqlite的文档页 http://www.sqlite.org/docs.html 加到你的书签中。自动引用计数（APC）还是手动内存管理呢？

“ ”

阅读器

来自会员 pengtao的分享：(原文： https://github.com/ccgus/fmdb）

由于FMDB是建立在sqlite的之上的，所以你至少也该把这篇文章从头到尾读一遍。与此同时，把sqlite的文档页加到你的书签中。自动引用计数（APC）还是手动内存管理呢？

两种都行，FMDB会在编译的时候知道你是用的哪一种，然后进行相应处理。

使用方法

FMDB有三个主要的类

1.FMDatabase – 表示一个单独的sqlite数据库。用来执行sqlite的命令。

2.FMResultSet – 表示FMDatabase执行查询后结果集

3.FMDatabaseQueue – 如果你想在多线程中执行多个查询或更新，你应该使用该类。这是线程安全的。

数据库创建

创建FMDatabase对象时参数为sqlite数据库文件路径。该路径可以是以下三种之一：

1..文件路径。该文件路径无需真实存，如果不存在会自动创建。

2..空字符串(@”")。表示会在临时目录创建一个空的数据库，当FMDatabase 链接关闭时，文件也被删除。

3.NULL. 将创建一个内在数据库。同样的，当FMDatabase连接关闭时，数据会被销毁。

(如需对临时数据库或内在数据库进行一步了解，请继续阅读：http://www.sqlite.org/inmemorydb.html)

      
      
       
       FMDatabase*db=[FMDatabasedatabaseWithPath:@"/tmp/tmp.db"];

打开数据库

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

       
       if(![dbopen]){
       
       [dbrelease];
       
       return;
       
       }

执行更新

一切不是SELECT命令的命令都视为更新。这包括 CREATE,UPDATE,INSERT,ALTER,COMMIT,BEGIN,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,and REPLACE （等）。

简单来说，只要不是以SELECT开头的命令都是UPDATE命令。

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

执行查询

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

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

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

       
       FMResultSet*s=[dbexecuteQuery:@"SELECT*FROMmyTable"];
       
       while([snext]){
       
       //retrievevaluesforeachrecord
       
       }

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

       
       FMResultSet*s=[dbexecuteQuery:@"SELECTCOUNT(*)FROMmyTable"];
       
       if([snext]){
       
       inttotalCount=[sintForColumnIndex:0];
       
       }

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

intForColumn:

longForColumn:

longLongIntForColumn:

boolForColumn:

doubleForColumn:

stringForColumn:

dataForColumn:

datanoCopyForColumn:

UTF8StringForColumnIndex:

objectForColumn:

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

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

关闭数据库

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

[db close];

事务

FMDatabase是支持事务的。

数据净化（数据格式化）

使用FMDB，插入数据前，你不要花时间审查你的数据。你可以使用标准的sqlite数据绑定语法。

       
       INSERTINTOmyTableVALUES(?,?,?)

sqlite会识别 “?” 为一个输入的点位符，这样的执行会接受一个可变参数（或者表示为其他参数，如NSArray,NSDictionary,或va_list等），会正确为您转义。

你也可以选择使用命名参数语法。

       
       INSERTINTOmyTableVALUES(:id,:name,:value)

参数名必须以冒名开头。sqlite本身支持其他字符，当Dictionary key的内部实现是冒号开头。注意你的NSDictionary key不要包含冒号。

       
       NSDictionary*argsDict=[NSDictionarydictionaryWithObjectsAndKeys:@"MyName",@"name",nil];
       
       [dbexecuteUpdate:@"INSERTINTOmyTable(name)VALUES(:name)"withParameterDictionary:argsDict];

而且，代码不能这么写（为什么？想想吧。）

       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",@"thishas\"lotsof'bizarre\"quotes'"];

你应该：

"thishas"lotsof'bizarre"quotes'"];

提供给 -executeUpdate: 方法的参数都必须是对象。就像以下的代码就无法工作，且会产生崩溃。

        
      正确有做法是把数字打包成 NSNumber对象

 
      或者，你可以使用 -execute*WithFormat: ，这是NSString风格的参数

       
       [dbexecuteUpdateWithFormat:@"INSERTINTOmyTableVALUES(%d)",42];

-execute*WithFormat: 的方法的内部实现会帮你封装数据，以下这些修饰符都可以使用： %@,%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，它是你的朋友而且会帮助你。以下是使用方法：

首先创建队列。

       
       FMDatabaseQueue*queue=[FMDatabaseQueuedatabaseQueueWithPath:aPath];

这样使用。

       
       [queueinDatabase:^(FMDatabase*db){
       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",[NSNumbernumberWithInt:1]];
       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",[NSNumbernumberWithInt:2]];
       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",[NSNumbernumberWithInt:3]];
       
       FMResultSet*rs=[dbexecuteQuery:@"select*fromfoo"];
       
       while([rsnext]){
       
       …
       
       }
       
       }];

像这样，轻松地把简单任务包装到事务里：

       
       [queueinTransaction:^(FMDatabase*db,BOOL*rollback){
       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",[NSNumbernumberWithInt:3]];
       
       if(whoopsSomethingWrongHappened){
       
       *rollback=YES;return;
       
       }
       
       //etc…
       
       [dbexecuteUpdate:@"INSERTINTOmyTableVALUES(?)",[NSNumbernumberWithInt:4]];
       
       }];

FMDatabaseQueue 后台会建立系列化的G-C-D队列，并执行你传给G-C-D队列的块。这意味着你从多线程同时调用调用方法，GDC也会按它接收的块的顺序来执行。谁也不会吵到谁的脚，每个人都幸福。

猜你在找的Sqlite相关文章