首页 > 代码库 > FMDB
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 }FMDB