FMDB

简介

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

使用

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

 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，很简单，就像这样：

 FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
 while ([s next]) {
 //retrieve values for each record
 }
 

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

(int)intForColumn:(NSString*)columnName;
(int)intForColumnIndex:(int)columnIdx;
(long)longForColumn:(NSString*)columnName;
(long)longForColumnIndex:(int)columnIdx;
(long long int)longLongIntForColumn:(NSString*)columnName;
(long long int)longLongIntForColumnIndex:(int)columnIdx;
(unsigned long long int)unsignedLongLongIntForColumn:(NSString*)columnName;
(unsigned long long int)unsignedLongLongIntForColumnIndex:(int)columnIdx;
(BOOL)boolForColumn:(NSString*)columnName;
(BOOL)boolForColumnIndex:(int)columnIdx;
(double)doubleForColumn:(NSString*)columnName;
(double)doubleForColumnIndex:(int)columnIdx;
(NSString)stringForColumn:(NSString)columnName;
(NSString*)stringForColumnIndex:(int)columnIdx;
(NSDate)dateForColumn:(NSString)columnName;
(NSDate*)dateForColumnIndex:(int)columnIdx;
(NSData)dataForColumn:(NSString)columnName;
(NSData*)dataForColumnIndex:(int)columnIdx;
(const unsigned char *)UTF8StringForColumnIndex:(int)columnIdx;
(const unsigned char )UTF8StringForColumnName:(NSString)columnName;

// returns one of NSNumber, NSString, NSData, or NSNull

(id)objectForColumnName:(NSString*)columnName;
(id)objectForColumnIndex:(int)columnIdx;
 

通常，你不需要调用[FMResultSet close]来关闭结果集，它会在自身deallocate或者父数据库关闭的时候自动关闭

使用FMDatabaseQueue 及线程安全
在多个线程中同时使用一个FMDatabase实例是不明智的。最好为每个线程创建一个FMDatabase对象。 不要让多个线程分享同一个实例，它无法在多个线程中同时使用。 如果你这么干了，会有不好的事发生，程序会时经常崩溃，或者发生异常，或者陨石会从天上掉下来砸到你Mac Pro（官方说法...）. 总之很崩溃。所以，不要初始化FMDatabase对象，然后在多个线程中使用。请使用 FMDatabaseQueue，它是你的朋友而且会帮助你。以下是使用方法

 FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];
 [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队列（依据类名），并执行你传给G-C-D队列的块。这意味着 你从多线程同时调用调用方法，GCD也会按它接收的块的顺序来执行