FMDB

一、FMDB简介

1、FMDB简介

      iOS中原生的SQLite API在进行数据存储的时候,需要使用C语言中的函数,操作比较繁琐。于是,就出现了一系列将SQLite API进行封装的库,例如FMDB、PlausibleDatabase、SQLitePersistentObjects等。  
     FMDB是一款简洁、易用的封装库。因此,在这里推荐使用第三方框架FMDB,它是对libsqlite3框架的封装,用起来的步骤与SQLite使用类似,并且它对于多线程的并发操作进行了处理,所以是线程安全的。

2、FMDB优缺点

优点:
1.对多线程的并发操作进行处理,所以是线程安全的;
2.以OC的方式封装了SQLite的C语言API,使用起来更加的方便;
3.FMDB是轻量级的框架,使用灵活。

缺点:
1.因为它是OC的语言封装的,只能在iOS开发的时候使用,所以在实现跨平台操作的时候存在局限性。

3、FMDB中重要的类

1、FMDatabase:一个FMDatabase对象就代表一个单独的SQLite数据库,用来执行SQL语句。
2、FMResultSet:使用FMDatabase执行查询后的结果集。
3、FMDatabaseQueue:用于在多线程中执行多个查询或更新,它是线程安全的。

4、FMDB使用步骤

1.下载FMDB文件(gitHub链接:https://github.com/ccgus/fmdb),并将FMDB文件夹添加到项目中(也可使用CocoaPods导入)
2.导入libsqlite3.0框架,导入头文件FMDatabase.h
3.代码实现,与SQLite使用步骤相似,创建数据库路径,获得数据库路径,打开数据库,然后对数据库进行增、删、改、查操作,最后关闭数据库。

二、FMDB创建数据库和数据表

1、FMDB—数据库创建

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

创建数据库和表

// 引入框架(FMDB.h),引入支持类库(libsqlite3.0.tbd)

1 /// 声明数据库对象
2 @property (nonatomic, strong)FMDatabase *dataBase;
3 /// 数据库存储路径
4 @property (nonatomic, copy)NSString *filePath;
复制代码
 1 #pragma mark - 创建数据库、创建表
 2 - (void)creatTable {
 3     // 创建数据库
 4     // 1、找到数据库存储路径
 5     NSString *document = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
 6     NSLog(@"document %@", document);
 7     self.filePath = [document stringByAppendingPathComponent:@"student.sqlite"];
 8     // 2、使用路径初始化FMDB对象
 9     self.dataBase = [FMDatabase databaseWithPath:self.filePath];
10     // 3、判断数据库是否打开,打开时才执行sql语句
11     if ([self.dataBase open]) {
12         // 1、创建建表sql语句
13         NSString *createSql = @"create table if not exists t_student(id integer primary key autoincrement not null, name text not null, age integer not null, sex text not null)";
14         BOOL result = [self.dataBase executeUpdate:createSql];
15         if (result) {
16             NSLog(@"建表成功");
17         } else {
18             NSLog(@"建表失败 %d", result);
19         }
20     }
21     // 关闭数据库
22     [self.dataBase close];
23 }
复制代码

三、FMDB实现增、删、改、查

1、FMDB—执行更新

  一切不是SELECT命令的命令都视为更新。这包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。
     简单来说,只要不是以SELECT开头的命令都是更新命令。
     执行更新返回一个BOOL值。YES表示 执行成功,否则表示有错误。你可以调用 -lastErrorMessage 和 -lastErrorCode方法来得到更多信息。

更新方法有一下几种:

复制代码
1 //1.executeUpdate:  不确定的参数用?来占位(后面参数必须是oc对象,;代表语句结束)
2    [self.db executeUpdate:@“INSERT INTO t_student (name, age) VALUES (?,?);”,name,@(age)];
3 
4  //2.executeUpdateWithFormat:不确定的参数用%@,%d等来占位 (参数为原始数据类型,执行语句不区分大小写)
5    [self.db executeUpdateWithFormat:@“insert into t_student (name,age) values (%@,%i);”, name,age];  
6 
7   //3.数组
8    [self.db executeUpdate:@“INSERT INTO t_student(name,age) VALUES  (?,?);”  withArgumentsInArray:@[name, @(age)]];
复制代码

增:

复制代码
 1 #pragma mark - 添加学生
 2 - (IBAction)insertIntoAction:(id)sender {
 3     // 1、打开数据库
 4     [self.dataBase open];
 5     // 2、进行相关操作
 6     NSArray *nameArray = @[@"MBBoy", @"Boom Sky", @"小明"];
 7     for (int i = 0; i < nameArray.count; i++) {
 8         NSString *name = nameArray[i];
 9         // 创建插入语句
10         NSString *insertSql = @"insert into t_student(name, age, sex) values (?, ?, ?)";
11         BOOL result = [self.dataBase executeUpdate:insertSql, name, @69, @""];
12         if (result) {
13             NSLog(@"学生%@添加成功", name);
14         } else {
15             NSLog(@"学生%@添加失败, %d", name, result);
16         }
17     }
18     // 关闭数据库
19     [self.dataBase close];
20 }
复制代码

修改学生信息:

复制代码
 1 #pragma mark - 更改学生信息
 2 - (IBAction)updateAction:(id)sender {
 3     // 打开数据库
 4     [self.dataBase open];
 5     BOOL result = [self.dataBase executeUpdate:@"update t_student set name = ? where name = ?", @"mlx", @"MBBoy"];
 6     if (result) {
 7         NSLog(@"更新成功");
 8     } else {
 9         NSLog(@"更新失败 %d", result);
10     }
11     // 关闭数据库
12     [self.dataBase close];
13 }
复制代码

删除学生:

复制代码
 1 #pragma mark - 更改学生信息
 2 - (IBAction)updateAction:(id)sender {
 3     // 打开数据库
 4     [self.dataBase open];
 5     BOOL result = [self.dataBase executeUpdate:@"update t_student set name = ? where name = ?", @"mlx", @"MBBoy"];
 6     if (result) {
 7         NSLog(@"更新成功");
 8     } else {
 9         NSLog(@"更新失败 %d", result);
10     }
11     // 关闭数据库
12     [self.dataBase close];
13 }
复制代码

查询一个学生:

1.  SELECT命令就是查询,执行查询的方法是以-excuteQuery开头的。
2.  执行查询时,如果成功返回FMResultSet对象,错误返回nil。与执行更新相同,支持使用NSError参数。
3.  同时,你也可以使用-lastErrorCode和-lastErrorMessage获知错误信息。

FMResultSet提供了很多方法,来获取对应字段的信息:
    intForColumn:
    longForColumn:
    longLongIntForColumn:
    boolForColumn:
    doubleForColumn:
    stringForColumn:
    dataForColumn:
    dataNoCopyForColumn:
    UTF8StringForColumnIndex:
    objectForColumn:

复制代码
 1 #pragma mark - 查询一个学生
 2 - (IBAction)searchStudentAction:(id)sender {
 3     // 打开数据库
 4     [self.dataBase open];
 5     // 接收查询结果的类 -- FMResultSet
 6     FMResultSet *resultSet = [self.dataBase executeQuery:@"select * from t_student where name = ?", @"小明"];
 7     if (resultSet) {
 8         // 遍历出需要的结果内容
 9         while ([resultSet next]) {
10             NSString *name = [resultSet objectForColumnName:@"name"];
11             NSInteger age = [resultSet intForColumn:@"age"];
12             NSString *sex = [resultSet objectForColumnIndex:3];
13             NSLog(@"name = %@, age = %ld, sex = %@", name, age, sex);
14         }
15     } else {
16         NSLog(@"查询失败");
17     }
18     // 关闭数据库
19     [self.dataBase close];
20 }
复制代码

 

查询所有学生:

复制代码
 1 #pragma mark - 查询所有学生
 2 - (IBAction)searchAllStudentsAction:(id)sender {
 3     // 打开数据库
 4     [self.dataBase open];
 5     // 接收查询结果的类 -- FMResultSet
 6     FMResultSet *resultSet = [self.dataBase executeQuery:@"select * from t_student"];
 7     if (resultSet) {
 8         // 遍历出需要的结果内容
 9         while ([resultSet next]) {
10             NSString *name = [resultSet objectForColumnName:@"name"];
11             NSInteger age = [resultSet intForColumn:@"age"];
12             NSString *sex = [resultSet objectForColumnIndex:3];
13             NSLog(@"name = %@, age = %ld, sex = %@", name, age, sex);
14         }
15     } else {
16         NSLog(@"查询失败");
17     }
18     // 关闭数据库
19     [self.dataBase close];
20 }
复制代码

删除表:

1 //如果表格存在 则销毁
2 [self.db executeUpadate:@“drop table if exists t_student;”]; 

四、FMDB实现多线程操作

FMDatabase实例能否在多线程中使用?

如 果应用中使用了多线程操作数据库,那么就需要使用FMDatabaseQueue来保证线程安全了。 应用中不可在多个线程中共同使用一个FMDatabase对象操作数据库,这样会引起数据库数据混乱(例如使用两个线程同时对数据库进行更新和查找)。 为了多线程操作数据库安全,FMDB使用了FMDatabaseQueue。
多个线程更新相同的资源导致数据竞争时使用等待队列(等待现在执行的处理结束) 

复制代码
 1 #pragma mark - 以队列形式插入多个学生,这种方式添加数据是FMDB比较常用的添加方式,
 2 // FMDB不支持多个线程同时操作,所以一般以串行的方式实现相关操作
 3 - (IBAction)insertStudnetWithQueue:(id)sender {
 4     // 打开数据库
 5     [self.dataBase open];
 6     // 创建操作队列
 7     FMDatabaseQueue * queue = [FMDatabaseQueue databaseQueueWithPath:self.filePath];
 8     // 记录插入操作是否成功
 9     __block BOOL isSuccess = YES;
10     // 把任务包装到事务里
11     [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
12         
13         // 串行队列
14         isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"隔壁老王", @38, @""] && isSuccess;
15         isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"-1", @438, @""] && isSuccess;
16         isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"Rose", @18, @""] && isSuccess;
17         
18         if (!isSuccess) {
19             // 如果插入不成功,对rollback(bool类型的指针)进行处理
20             // 如果有一条语句不成功,就回滚,撤销所有插入语句执行的结果都取消
21             *rollback = YES;
22             return;
23         }
24     }];
25     [self.dataBase close];
26 }
复制代码
posted @ 2016-06-02 16:33  董小火  阅读(675)  评论(0编辑  收藏  举报