FMDB与GCD

郝萌主倾心贡献。尊重作者的劳动成果，请勿转载。

假设文章对您有所帮助，欢迎给作者捐赠。支持郝萌主，捐赠数额任意，重在心意^_^

我要捐赠: 点击捐赠

Cocos2d-X源代码下载：点我传送

因为FMDB是建立在SQLite的之上的，所以你至少也该把这篇文章从头到尾读一遍。

与此同一时候，把SQLite的文档页
http://www.sqlite.org/docs.html 加到你的书签中。

自己主动引用计数（APC）还是手动内存管理呢？

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

用法



FMDB有三个基本的类



    FMDatabase – 表示一个单独的SQLite数据库。 用来运行SQLite的命令。

    FMResultSet – 表示FMDatabase运行查询后结果集

    FMDatabaseQueue – 假设你想在多线程中运行多个查询或更新。你应该使用该类。这是线程安全的。



数据库创建



创建FMDatabase对象时參数为SQLite数据库文件路径。该路径能够是下面三种之中的一个：

文件路径。该文件路径无需真实存，假设不存在会自己主动创建。

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

NULL. 将创建一个内在数据库。

相同的。当FMDatabase连接关闭时，数据会被销毁。

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





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



打开数据库



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





    if (![db open]) {  

        [db release];  

        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。非常easy实现。就像这样：

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];  

    while ([s next]) {  

        //retrieve values for each record  

    }  



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







    FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];  

    if ([s next]) {  

         int totalCount = [s intForColumnIndex:0];  

    }  



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



    intForColumn:

    longForColumn:

    longLongIntForColumn:

    boolForColumn:

    doubleForColumn:

    stringForColumn:

    dataForColumn:

    dataNoCopyForColumn:

    UTF8StringForColumnIndex:

    objectForColumn:



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



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

关闭数据库



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



    [db close];  



事务



FMDatabase是支持事务的。

数据净化（数据格式化）



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

INSERT INTO myTable VALUES (?, ?, ?)  



SQLite会识别 “?” 为一个输入的点位符。 这种运行会接受一个可变參数（或者表示为其它參数。如NSArray, NSDictionary,或va_list等）。会正确为您转义。

你也能够选择使用命名參数语法。



    INSERT INTO myTable VALUES (:id, :name, :value)  



參数名必须以冒名开头。

SQLite本身支持其它字符，当Dictionary key的内部实现是冒号开头。

注意你的NSDictionary key不要包括冒号。





    NSDictionary *argsDict = [NSDictionary dictionaryWithObjectsAndKeys:@"My Name", @"name", nil];  


    [db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)" withParameterDictionary:argsDict];  



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





[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has \" lots of ' bizarre \" quotes '"];



你应该：





    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has " lots of ' bizarre " quotes '"];  



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





    [db executeUpdate:@"INSERT INTO myTable VALUES (?

)", 42];  



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





    [db executeUpdate:@"INSERT INTO myTable VALUES (?

)", [NSNumber numberWithInt:42]];  



或者，你能够使用  -execute*WithFormat: 。这是NSString风格的參数





    [db executeUpdateWithFormat:@"INSERT INTO myTable VALUES (%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 = [FMDatabaseQueue databaseQueueWithPath:aPath];

这样使用。





    [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]) {  

                …  

             }  

    }];  



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





    [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]];  


    }];

FMDatabaseQueue  后台会建立系列化的GCD队列，并运行你传给GCD队列的块。

这意味着你从多线程同一时候调用调用方法，GCD也会按它接收的块的顺序来运行。

郝萌主倾心贡献，尊重作者的劳动成果，请勿转载。

假设文章对您有所帮助。欢迎给作者捐赠，支持郝萌主。捐赠数额任意，重在心意^_^

我要捐赠: 点击捐赠

Cocos2d-X源代码下载：点我传送

版权声明：本文博客原创文章，博客，未经同意，不得转载。