ios数据库 iOS数据库三方

SQLite是一种小型的轻量级的关系型数据库，在移动设备上使用是非常好的选择，无论是Android还是IOS，都内置了SQLite数据库，现在的版本都是SQLite3。在IOS中使用SQLite如果使用SDK提供的方法，特别麻烦也不利于理解和使用，在之前的文章中就是使用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. "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. "error when creating db table");  
6. else {  
7. "success to creating db table");  
8.         }  
9.         [db close];  
10.   
11.     }

添加数据：

[cpp] view plaincopyprint?

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

修改数据：

[cpp] view plaincopyprint?

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

删除数据：

[cpp] view plaincopyprint?

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

数据库查询操作：

查询操作使用了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. "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. "queue1", NULL);  
3. "queue2", NULL);  
4.      
5.    dispatch_async(q1, ^{  
6. for (int i = 0; i < 50; ++i) {  
7.            [queue inDatabase:^(FMDatabase *db2) {  
8.                  
9.                NSString *insertSql1= [NSString stringWithFormat:  
10. "INSERT INTO '%@' ('%@', '%@', '%@') VALUES (?, ?, ?)",  
11.                                       TABLENAME, NAME, AGE, ADDRESS];  
12.                  
13. "jack %d", i];  
14. "%d", 10+i];  
15.                  
16.                  
17. BOOL res = [db2 executeUpdate:insertSql1, name, age,@"济南"];  
18. if (!res) {  
19. "error to inster data: %@", name);  
20. else {  
21. "succ to inster data: %@", name);  
22.                }  
23.            }];  
24.        }  
25.    });  
26.      
27.    dispatch_async(q2, ^{  
28. for (int i = 0; i < 50; ++i) {  
29.            [queue inDatabase:^(FMDatabase *db2) {  
30.                NSString *insertSql2= [NSString stringWithFormat:  
31. "INSERT INTO '%@' ('%@', '%@', '%@') VALUES (?, ?, ?)",  
32.                                       TABLENAME, NAME, AGE, ADDRESS];  
33.                  
34. "lilei %d", i];  
35. "%d", 10+i];  
36.                  
37. BOOL res = [db2 executeUpdate:insertSql2, name, age,@"北京"];  
38. if (!res) {  
39. "error to inster data: %@", name);  
40. else {  
41. "succ to inster data: %@", name);  
42.                }  
43.            }];  
44.        }  
45.    });

例子二：

下载完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. "user.db"];  
6.       
7. //获取数据库并打开  
8.     FMDatabase *database  = [FMDatabase databaseWithPath:dbPath];  
9. if (![database open]) {  
10. "Open database failed");  
11. return;  
12.     }  
13.       
14. //创建表（FMDB中只有update和query操作，出了查询其他都是update操作）
15.     //2014.3.6 sfx 修改：创建表时应该先查看表是否已经存在，如果不存在再创建  
16. 
 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)"];
    }      17. //插入数据  
18. BOOL insert = [database executeUpdate:@"insert into user values (?,?,?)",nameTextField.text,genderTextField.text,ageTextField.text];  
19.       
20. if (insert) {  
21. "提示" message:@"保存成功" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];  
22.         [alert show];  
23.         [alert release];  
24.     }  
25.       
26.     [database close];  
27. }

操作成功后弹出提示框：

                                             

[cpp] view plaincopy

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

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. "user.db"];  
6.       
7.     FMDatabase *database = [FMDatabase databaseWithPath:dbPath];  
8. if (![database open]) {  
9. return;  
10.     }  
11.       
12. "select * from user where name = ?",@"Ryan"];  
13. while ([resultSet next]) {  
14. "name"];  
15. "gender"];  
16. int age = [resultSet intForColumn:@"age"];  
17. "Name:%@,Gender:%@,Age:%d",name,gender,age);  
18.     }  
19.       
20.     [database close];  
21. }

[cpp] view plaincopy

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

                                       

[cpp] view plaincopy

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

                                       

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. "user.db"];  
6.       
7.     FMDatabaseQueue *databaseQueue = [FMDatabaseQueue databaseQueueWithPath:dbPath];  
8.     [databaseQueue inDatabase:^(FMDatabase *db){  
9. "insert into user values (?,?,?)",@"Ren",@"Male",[NSNumber numberWithInt:20]];  
10.     }];  
11.     [databaseQueue close];  
12. }

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