FMDB的使用

SQLite (http://www.sqlite.org/docs.html) 是一个轻量级的关系数据库。iOS SDK很早就支持了SQLite，在使用时，只需要加入 libsqlite3.dylib 依赖以及引入 sqlite3.h 头文件即可。但是，原生的SQLite API在使用上相当不友好，在使用时，非常不便。于是，开源社区中就出现了一系列将SQLite API进行封装的库，而FMDB (https://github.com/ccgus/fmdb) 则是开源社区中的优秀者。

另外，FMDB同时兼容ARC和非ARC工程，会自动根据工程配置来调整相关的内存管理代码。

ios数据存储中关于Sqlite 3使用第三方框架FMDB是本文要介绍的内容，主要讲述在iPhone上是采用sqlite进行数据存储是我一种比较习惯性的做法。一般在其他平台也比较习惯用sqlite，比如android。

而ios开发上有一些封装好的第三方框架提供使用，更节省了许多时间。如：Sqlitepersistentobjects ，FMDB 。今天查找了这个两个框架，感觉FMDB的风格更符合我的使用，其实两者是各有优点的，只是看个人喜好而已。以下是FMDB的一些基本使用，FMDB框架其实只是一层很薄的封装，主要的类也就两个：FMDatabase和FMResultSet ；

其中的FMResultSet对象让我想起了android中sqlite的cursor集合啊。

FMDB的github地址是，https://github.com/ccgus/fmdb。

1、首先得实例化一个FMDatabase对象，这跟 Sqlitepersistentobjects 派生一个子类进行操作是不同。

     接着打开一个数据库（如果没有会创建一个数据库）

//paths： ios下Document路径，Document为ios中可读写的文件夹
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDirectory = [paths objectAtIndex:0];
//dbPath： 数据库路径，在Document中。
NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"Test.db"];
//创建数据库实例 db  这里说明下:如果路径中不存在"Test.db"的文件,sqlite会自动创建"Test.db"
FMDatabase *db= [FMDatabase databaseWithPath:dbPath] ;
if (![db open]) {
NSLog(@"Could not open db.");
return ;
}
//paths： ios下Document路径，Document为ios中可读写的文件夹
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDirectory = [paths objectAtIndex:0];
//dbPath： 数据库路径，在Document中。
NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"Test.db"];
//创建数据库实例 db  这里说明下:如果路径中不存在"Test.db"的文件,sqlite会自动创建"Test.db"
FMDatabase *db= [FMDatabase databaseWithPath:dbPath] ;
if (![db open]) {
NSLog(@"Could not open db.");
return ;
}

接下来，我们可以通过这个数据库对象进行操作了。操作主要是update和queries。

1.首先是创建表。

//创建一个名为User的表，有两个字段分别为string类型的Name，integer类型的 Age
[db executeUpdate:@"CREATE TABLE User (Name text,Age integer)"];
//创建一个名为User的表，有两个字段分别为string类型的Name，integer类型的 Age
[db executeUpdate:@"CREATE TABLE User (Name text,Age integer)"];

这样我们就有了一张表了。

2.接下我们对表进行操作。插入数据！注意插入的数据使用了通配符，

这跟iphone直接使用sqlite借口的绑定变量是一样的，后面的通配符匹配的数据。

//插入数据使用OC中的类型 text对应为NSString integer对应为NSNumber的整形
[db executeUpdate:@"INSERT INTO User (Name,Age) VALUES (?,?)",@"老婆",[NSNumber numberWithInt:20]] ;
//插入数据使用OC中的类型 text对应为NSString integer对应为NSNumber的整形
[db executeUpdate:@"INSERT INTO User (Name,Age) VALUES (?,?)",@"老婆",[NSNumber numberWithInt:20]]  ;

3.接下来是更新数据。

//更新数据 将“老婆”更改为“宝贝”
[db executeUpdate:@"UPDATE User SET Name = ? WHERE Name = ? ",@"老婆",@"宝贝"];
//更新数据 将“老婆”更改为“宝贝”
[db executeUpdate:@"UPDATE User SET Name = ? WHERE Name = ? ",@"老婆",@"宝贝"];

4.再接下来，就是删除数据啦。

//删除数据
[db executeUpdate:@"DELETE FROM User WHERE Name = ?",@"老婆"];
//删除数据
[db executeUpdate:@"DELETE FROM User WHERE Name = ?",@"老婆"];

update的基本操作就这几个。

5.接下来是queries!

//返回数据库中第一条满足条件的结果
NSString *aa=[db stringForQuery:@"SELECT Name FROM User WHERE Age = ?",@"20"];
//返回数据库中第一条满足条件的结果
NSString *aa=[db stringForQuery:@"SELECT Name FROM User WHERE Age = ?",@"20"];

这样我们就查询返回了一条数据，那当我们想要查询放返回多条数据怎么办呢？不用愁，之前我就提到了FMDB中的另外一个主要的类，FMResultSet，这是一个结果集！返回多条数据时FMDB会将数据放在这个结果集中，然后我们在对这个结果集进行查询操作！很简单。

注意：即使操作结果只有一行，也需要先调用FMResultSet的next方法。

FMResultSet *rs=[db executeQuery:@"SELECT * FROM User"];
rs=[db executeQuery:@"SELECT * FROM User WHERE Age = ?",@"20"];
while ([rs next]){
NSLog(@"%@ %@",[rs stringForColumn:@"Name"],[rs stringForColumn:@"Age"]);
}
FMResultSet *rs=[db executeQuery:@"SELECT * FROM User"];
rs=[db executeQuery:@"SELECT * FROM User WHERE Age = ?",@"20"];
while ([rs next]){
NSLog(@"%@ %@",[rs stringForColumn:@"Name"],[rs stringForColumn:@"Age"]);
}

FMDB提供如下多个方法来获取不同类型的数据：

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

通常情况下，你并不需要关闭FMResultSet，因为相关的数据库关闭时，FMResultSet也会被自动关闭

数据参数

通常情况下，你可以按照标准的SQL语句，用?表示执行语句的参数，如：

INSERT INTO myTable VALUES (?, ?, ?)


然后，可以我们可以调用executeUpdate方法来将?所指代的具体参数传入，通常是用变长参数来传递进去的，如下：

NSString *sql = @"insert into User (name, password) values (?, ?)";

[db executeUpdate:sql, user.name, user.password];


这里需要注意的是，参数必须是NSObject的子类，所以象int,double,bool这种基本类型，需要封装成对应的包装类才行，如下所示：

// 错误，42不能作为参数

[db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];

// 正确，将42封装成 NSNumber 类

[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];

线程安全

如果我们的app需要多线程操作数据库，那么就需要使用FMDatabaseQueue来保证线程安全了。切记不能在多个线程中共同一个FMDatabase对象并且在多个线程中同时使用，这个类本身不是线程安全的，这样使用会造成数据混乱等问题。

使用FMDatabaseQueue很简单，首先用一个数据库文件地址来初使化FMDatabaseQueue，然后就可以将一个闭包(block)传入inDatabase方法中。在闭包中操作数据库，而不直接参与FMDatabase的管理。

// 创建，最好放在一个单例的类中
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]];
}];

工具

为了查看Sqlite中的数据，一个好的图形化界面的数据库管理程序是必不可少的。mysql有phpMyAdmin，那么sqlite呢？

我主要使用的是Firefox的一个名为SQLite Manager的插件，安装此插件后，可以直接打开后缀名为sqlite的数据库文件。SQLite Manager提供一个图形化的界面来执行数据查询或更改操作。如下图所示：

总结

FMDB将SQLite API进行了很友好的封装，使用上非常方便，对于那些使用纯Sqlite API来进行数据库操作的app，可以考虑将其迁移到基于FMDB上，这对于以后数据库相关功能的开发维护，可以提高不少效率。

我在学习fmdb的时候做了一个小工程用于练习，我把它放到github上了。感兴趣的可以自行下载：https://github.com/tangqiaoboy/FmdbSample

 

转截地址：http://www.mobiledevor.com/post/34.html

转截地址：http://blog.devtang.com/blog/2012/04/22/use-fmdb/