IOS数据持久化存储之SQLite3第三方库FMDB的使用

SQLite是一种小型的轻量级的关系型数据库，在移动设备上使用是非常好的选择，无论是Android还是IOS，都内置了SQLite数据库，现在的版本都是SQLite3。在IOS中使用SQLite如果使用SDK提供的方法，特别麻烦也不利于理解和使用，在之前的http://blog.csdn.net/tangren03/article/details/7781930文章中就是使用IOS的SDK自带的SQLite
API来使用数据库，感觉使用很不方便，今天就讲讲一个针对IOS的SQlite API封装的第三方库FMDB，FMDB对SDK中的API做了一层封装，使之使用OC来访问，使用方便而且更熟悉。FMDB的下载地址https://github.com/ccgus/fmdb。

FMDB主要涉及两个类，FMDatabase和FMResultSet，前者类似于Android中的SQLiteOpenHelper或SQLiteDatabase，FMResultSet类似于Android中的Cursor，用来存储结果集。

FMDB常用类：

FMDatabase ： 一个单一的SQLite数据库，用于执行SQL语句。

FMResultSet ：执行查询一个FMDatabase结果集，这个和android的Cursor类似。

FMDatabaseQueue ：在多个线程来执行查询和更新时会使用这个类。

创建数据库：

[cpp] view
plaincopyprint?

1. db = [FMDatabase databaseWithPath:database_path];

1、当数据库文件不存在时，fmdb会自己创建一个。

2、 如果你传入的参数是空串：@"" ，则fmdb会在临时文件目录下创建这个数据库，数据库断开连接时，数据库文件被删除。

3、如果你传入的参数是 NULL，则它会建立一个在内存中的数据库，数据库断开连接时，数据库文件被删除。

打开数据库：

[cpp] view
plaincopyprint?

1. [db open]

返回BOOL型。

关闭数据库：

[cpp] view
plaincopyprint?

1. [db close]

数据库增删改等操作：

除了查询操作，FMDB数据库操作都执行executeUpdate方法，这个方法返回BOOL型。

看一下例子：

例子一

创建表：

[cpp] view
plaincopyprint?

1. if ([db open]) {
2. NSString *sqlCreateTable =  [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS '%@' ('%@' INTEGER PRIMARY KEY AUTOINCREMENT, '%@' TEXT, '%@' INTEGER, '%@' TEXT)",TABLENAME,ID,NAME,AGE,ADDRESS];
3. BOOL res = [db executeUpdate:sqlCreateTable];
4. if (!res) {
5. NSLog(@"error when creating db table");
6. } else {
7. NSLog(@"success to creating db table");
8. }
9. [db close];
10. }

添加数据：

[cpp] view
plaincopyprint?

1. if ([db open]) {
2. NSString *insertSql1= [NSString stringWithFormat:
3. @"INSERT INTO '%@' ('%@', '%@', '%@') VALUES ('%@', '%@', '%@')",
4. TABLENAME, NAME, AGE, ADDRESS, @"张三", @"13", @"济南"];
5. BOOL res = [db executeUpdate:insertSql1];
6. NSString *insertSql2 = [NSString stringWithFormat:
7. @"INSERT INTO '%@' ('%@', '%@', '%@') VALUES ('%@', '%@', '%@')",
8. TABLENAME, NAME, AGE, ADDRESS, @"李四", @"12", @"济南"];
9. BOOL res2 = [db executeUpdate:insertSql2];
10. if (!res) {
11. NSLog(@"error when insert db table");
12. } else {
13. NSLog(@"success to insert db table");
14. }
15. [db close];
16. }

修改数据：

[cpp] view
plaincopyprint?

1. if ([db open]) {
2. NSString *updateSql = [NSString stringWithFormat:
3. @"UPDATE '%@' SET '%@' = '%@' WHERE '%@' = '%@'",
4. TABLENAME,   AGE,  @"15" ,AGE,  @"13"];
5. BOOL res = [db executeUpdate:updateSql];
6. if (!res) {
7. NSLog(@"error when update db table");
8. } else {
9. NSLog(@"success to update db table");
10. }
11. [db close];
12. }

删除数据：

[cpp] view
plaincopyprint?

1. if ([db open]) {
2. NSString *deleteSql = [NSString stringWithFormat:
3. @"delete from %@ where %@ = '%@'",
4. TABLENAME, NAME, @"张三"];
5. BOOL res = [db executeUpdate:deleteSql];
6. if (!res) {
7. NSLog(@"error when delete db table");
8. } else {
9. NSLog(@"success to delete db table");
10. }
11. [db close];
12. }

数据库查询操作：

查询操作使用了executeQuery，并涉及到FMResultSet。

[cpp] view
plaincopyprint?

1. if ([db open]) {
2. NSString * sql = [NSString stringWithFormat:
3. @"SELECT * FROM %@",TABLENAME];
4. FMResultSet * rs = [db executeQuery:sql];
5. while ([rs next]) {
6. int Id = [rs intForColumn:ID];
7. NSString * name = [rs stringForColumn:NAME];
8. NSString * age = [rs stringForColumn:AGE];
9. NSString * address = [rs stringForColumn:ADDRESS];
10. NSLog(@"id = %d, name = %@, age = %@  address = %@", Id, name, age, address);
11. }
12. [db close];
13. }

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

数据库多线程操作：

如果应用中使用了多线程操作数据库，那么就需要使用FMDatabaseQueue来保证线程安全了。 应用中不可在多个线程中共同使用一个FMDatabase对象操作数据库，这样会引起数据库数据混乱。 为了多线程操作数据库安全，FMDB使用了FMDatabaseQueue，使用FMDatabaseQueue很简单，首先用一个数据库文件地址来初使化FMDatabaseQueue，然后就可以将一个闭包(block)传入inDatabase方法中。 在闭包中操作数据库，而不直接参与FMDatabase的管理。

[cpp] view
plaincopyprint?

1. FMDatabaseQueue * queue = [FMDatabaseQueue databaseQueueWithPath:database_path];
2. dispatch_queue_t q1 = dispatch_queue_create("queue1", NULL);
3. dispatch_queue_t q2 = dispatch_queue_create("queue2", NULL);
4. dispatch_async(q1, ^{
5. for (int i = 0; i < 50; ++i) {
6. [queue inDatabase:^(FMDatabase *db2) {
7. NSString *insertSql1= [NSString stringWithFormat:
8. @"INSERT INTO '%@' ('%@', '%@', '%@') VALUES (?, ?, ?)",
9. TABLENAME, NAME, AGE, ADDRESS];
10. NSString * name = [NSString stringWithFormat:@"jack %d", i];
11. NSString * age = [NSString stringWithFormat:@"%d", 10+i];
12. BOOL res = [db2 executeUpdate:insertSql1, name, age,@"济南"];
13. if (!res) {
14. NSLog(@"error to inster data: %@", name);
15. } else {
16. NSLog(@"succ to inster data: %@", name);
17. }
18. }];
19. }
20. });
21. dispatch_async(q2, ^{
22. for (int i = 0; i < 50; ++i) {
23. [queue inDatabase:^(FMDatabase *db2) {
24. NSString *insertSql2= [NSString stringWithFormat:
25. @"INSERT INTO '%@' ('%@', '%@', '%@') VALUES (?, ?, ?)",
26. TABLENAME, NAME, AGE, ADDRESS];
27. NSString * name = [NSString stringWithFormat:@"lilei %d", i];
28. NSString * age = [NSString stringWithFormat:@"%d", 10+i];
29. BOOL res = [db2 executeUpdate:insertSql2, name, age,@"北京"];
30. if (!res) {
31. NSLog(@"error to inster data: %@", name);
32. } else {
33. NSLog(@"succ to inster data: %@", name);
34. }
35. }];
36. }
37. });

例子二：

下载完FMDB源码后把文件拖到工程中，并导入SQLite支持库，工程目录如下：

然后就是这个Demo的完整截图：

然后就来看看如何操作FMDB:

[cpp] view
plaincopy

1. //点击按钮后执行保存到数据库的操作
2. - (IBAction)saveButtonClicked:(id)sender {
3. //获取Document文件夹下的数据库文件，没有则创建
4. NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
5. NSString *dbPath = [docPath stringByAppendingPathComponent:@"user.db"];
6. //获取数据库并打开
7. FMDatabase *database  = [FMDatabase databaseWithPath:dbPath];
8. if (![database open]) {
9. NSLog(@"Open database failed");
10. return;
11. }
12. //创建表（FMDB中只有update和query操作，出了查询其他都是update操作）
13. //2014.3.6 sfx 修改：创建表时应该先查看表是否已经存在，如果不存在再创建

14. FMResultSet *rs = [database
    executeQuery:@"select count(*) as 'count' from sqlite_master where type = 'table' and name = ?",@"user"];

    if ([rs next])

    {

    NSInteger count = [rs intForColumn:@"count"];

    NSLog(@"The table count: %d",count);

    if (count == 1) {

    NSLog(@"user table is existed.");

    return;

    }

    NSLog(@"user table is not existed.");

    [database
    executeUpdate:@"create table user (name text,gender text,age integer)"];

    }

15. //插入数据
16. BOOL insert = [database executeUpdate:@"insert into user values (?,?,?)",nameTextField.text,genderTextField.text,ageTextField.text];
17. if (insert) {
18. UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"提示" message:@"保存成功" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
19. [alert show];
20. [alert release];
21. }
22. [database close];
23. }

操作成功后弹出提示框：

[cpp] view
plaincopy

1. //点击按钮后执行查询操作
2. - (IBAction)queryButtonTapped:(id)sender {
3. NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
4. NSString *documentPath = [paths objectAtIndex:0];
5. NSString *dbPath = [documentPath stringByAppendingPathComponent:@"user.db"];
6. FMDatabase *database = [FMDatabase databaseWithPath:dbPath];
7. if (![database open]) {
8. return;
9. }
10. //不需要像Android中那样关闭Cursor关闭FMResultSet，因为相关的数据库关闭时，FMResultSet也会被自动关闭
11. FMResultSet *resultSet = [database executeQuery:@"select * from user"];
12. while ([resultSet next]) {
13. NSString *name = [resultSet stringForColumn:@"name"];
14. NSString *gender = [resultSet stringForColumn:@"gender"];
15. int age = [resultSet intForColumn:@"age"];
16. NSLog(@"Name:%@,Gender:%@,Age:%d",name,gender,age);
17. }
18. [database close];
19. //这里也不需要release
20. //    [database release];
21. }

FMResultSet还支持以下方式获取值：

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

[cpp] view
plaincopy

1. //执行条件查询操作
2. - (IBAction)queryByConditionBtnTapped:(id)sender {
3. NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
4. NSString *docPath = [paths objectAtIndex:0];
5. NSString *dbPath = [docPath stringByAppendingPathComponent:@"user.db"];
6. FMDatabase *database = [FMDatabase databaseWithPath:dbPath];
7. if (![database open]) {
8. return;
9. }
10. FMResultSet *resultSet = [database executeQuery:@"select * from user where name = ?",@"Ryan"];
11. while ([resultSet next]) {
12. NSString *name = [resultSet stringForColumn:@"name"];
13. NSString *gender = [resultSet stringForColumn:@"gender"];
14. int age = [resultSet intForColumn:@"age"];
15. NSLog(@"Name:%@,Gender:%@,Age:%d",name,gender,age);
16. }
17. [database close];
18. }

[cpp] view
plaincopy

1. //执行更新操作
2. - (IBAction)updateBtnTapped:(id)sender {
3. NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
4. NSString *docPath = [paths objectAtIndex:0];
5. NSString *dbPath = [docPath stringByAppendingPathComponent:@"user.db"];
6. FMDatabase *database = [FMDatabase databaseWithPath:dbPath];
7. if (![database open]) {
8. return;
9. }
10. //参数必须是NSObject的子类，int,double,bool这种基本类型，需要封装成对应的包装类才可以
11. BOOL update = [database executeUpdate:@"update user set name = ? where age = ?",@"RyanTang",[NSNumber numberWithInt:24]];
12. if(update){
13. UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"提示" message:@"更新成功" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
14. [alert show];
15. [alert release];
16. }
17. [database close];
18. }

[cpp] view
plaincopy

1. //执行删除操作
2. - (IBAction)deleteBtnTapped:(id)sender {
3. NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
4. NSString *docPath = [paths objectAtIndex:0];
5. NSString *dbPath = [docPath stringByAppendingPathComponent:@"user.db"];
6. FMDatabase *database = [FMDatabase databaseWithPath:dbPath];
7. if (![database open]) {
8. return;
9. }
10. BOOL delete = [database executeUpdate:@"delete from user where name = ?",@"Tang"];
11. if (delete) {
12. UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"提示" message:@"删除成功" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
13. [alert show];
14. [alert release];
15. }
16. [database close];
17. }

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

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

[cpp] view
plaincopy

1. -(void)executeDBOperation
2. {
3. //获取Document文件夹下的数据库文件，没有则创建
4. NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
5. NSString *dbPath = [docPath stringByAppendingPathComponent:@"user.db"];
6. FMDatabaseQueue *databaseQueue = [FMDatabaseQueue databaseQueueWithPath:dbPath];
7. [databaseQueue inDatabase:^(FMDatabase *db){
8. [db executeUpdate:@"insert into user values (?,?,?)",@"Ren",@"Male",[NSNumber numberWithInt:20]];
9. }];
10. [databaseQueue close];
11. }

经过修改后的工程源码:传送门在此