第三方库FMDB的使用

2022-01-20 17:16:26

1.FMDB简介

什么是FMDB

FMDB是iOS平台的SQLite数据库框架,FMDB以OC的方式封装了SQLite的C语言API.

为什么使用FMDB

使用起来更加面向对象，省去了很多麻烦、冗余的C语言代码,对比苹果自带的Core Data框架，更加轻量级和灵活,它是对libsqlite3框架的封装，用起来的步骤与SQLite使用类似,提供了多线程安全的数据库操作方法，有效地防止数据混乱.所以是线程安全的.

2.FMDB优缺点

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

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

FMDB中重要的类:

FMDatabase：一个FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句,对数据库进行增、删、改、查操作,是重要事件的执行者。
FMResultSet：使用FMDatabase执行查询后的结果集。
FMDatabaseQueue：用于在多线程中执行多个查询或更新，它是线程安全的。

3.FMDB的使用:

①.下载FMDB文件（gitHub链接：https://github.com/ccgus/fmdb），并将FMDB文件夹添加到项目中（也可使用CocoaPods导入,CocoaPods怎么导入第三方库我就不多说了,之前的博客已经详细描述过了）.

②.导入libsqlite3.0框架，导入头文件FMDatabase.h.
③.代码实现，与SQLite使用步骤相似，创建数据库路径，获得数据库路径，打开数据库，然后对数据库进行增、删、改、查操作，最后关闭数据库。

创建FMDatabase对象，参数为SQLite数据库文件路径.

 //第一步:创建sql语句(创建学生表)

     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)";

     //第二步:找到存储路径

     NSString *document = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:];

     NSLog(@"%@", document);

     self.filePath = [document stringByAppendingPathComponent:@"student.sqlite"];

     NSLog(@"%@", self.filePath);

     //第三步:使用路径初始化FMDB对象(其实到这步,数据库的创建就算是完成了)

     self.dataBase = [FMDatabase databaseWithPath:self.filePath];

     //第四步:数据库执行相关操作

     //需要判断数据库打开的时候才进行执行语句,才开始创建表.

     if ([self.dataBase open]) {

         BOOL result = [self.dataBase executeUpdate:createSql];

         if (result) {

             NSLog(@"建表成功");

         } else {

             NSLog(@"建表失败");

         }

     }

     //上面的步骤是在数据库中创建了学生表

     //第五步:关闭数据库(为了节约资源,随即使用完了就关闭)

     [self.dataBase close];

创建完学生表之后,就可以进行下一步的操作了,增删改查:

每次对数据库进行操作的时候,我们都要重新打开数据库,操作完了,记得关闭数据库,这样可以更加节省资源.
一切不是SELECT命令的命令都视为更新。这包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。
简单来说，只要不是以SELECT(查询)开头的命令都是更新命令,更新操作统一使用语句executeUpdate:
执行更新返回一个BOOL值。YES表示执行成功，否则表示有错误。你可以调用 -lastErrorMessage 和 -lastErrorCode方法来得到更多信息。
这里简单说一下executeUpdate的几个需要注意的地方:

//1.executeUpdate: 不确定的参数用？来占位（后面参数必须是oc对象）推荐使用该语句
[self.dataBase executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?)",name,@(age)];
//2.executeUpdateWithFormat：不确定的参数用%@，%d等来占位（参数为原始数据类型，执行语句不区分大小写）
[self.dataBase executeUpdateWithFormat:@"insert into t_student (name,age) values (%@,%i)", name,age];

//3.数组执行语句不区分大小写
[self.db executeUpdate:@"INSERT INTO t_student(name,age) VALUES (?,?)" withArgumentsInArray:@[name, @(age)]];

代码示例:

 #pragma mark - 添加

 - (IBAction)insertAction:(id)sender {

     //第一步:打开数据库

     [self.dataBase open];

     //第二步:spl语句

     NSArray *nameArray = [NSArray arrayWithObjects:@"MBBoy", @"炸天", @"小明", nil];

     for (int i = ; i < nameArray.count; i++) {

         NSString *name = [nameArray objectAtIndex:i];

         //插入语句

         //NSString *insertSql = @"insert into t_student(name, age, sex) values (?,?,?)";

         //executeUpdate返回的第一个参数是insertSql语句,逗号后面的是需要符的值.

     BOOL result = [self.dataBase executeUpdate:@"insert into t_student(name, age, sex) values (?,?,?)", name, @, @"男"];

         if (result) {

             NSLog(@"插入成功");

         } else {

             NSLog(@"插入失败%d", result);

         }

     }

     //用完就关闭

     [self.dataBase close];

 }

删除和修改也是一样的,只要不是查询(SELECT),都是可以用更新executeUpdate来处理数据:

 #pragma mark - 修改

 - (IBAction)updateAction:(id)sender {

  //第一步:打开数据库

     [self.dataBase open];

    BOOL result = [self.dataBase executeUpdate:@"update t_student set name = ? where name = ?", @"孟玲旭", @"MBBoy"];

     if (result) {

         NSLog(@"更改成功");

     } else {

         NSLog(@"更改失败%d", result);

     }

     [self.dataBase close];

 }

 #pragma mark - 删除

 - (IBAction)deleteAction:(id)sender {

     [self.dataBase open];

     //执行sql语句

     BOOL result = [self.dataBase executeUpdate:@"delete from t_student where name = ?", @"孟玲旭"];

     if (result) {

         NSLog(@"删除成功");

     } else {

         NSLog(@"删除失败%d", result);

     }

     [self.dataBase close];

 }

这里我们来看看查找与之前的增,删,改有哪些不同的地方:

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

 #pragma mark - 查找

 - (IBAction)searchAction:(id)sender {

     //查询表中的所有数据

     [self.dataBase open];

     //查询结果引入的类FMResultSet,而之前的增删改返回的类型是BOOL值类型.

     //使用的方法也不一样,这里我们使用的是查询Query,查询整个表格数据.

     FMResultSet *resuletSet = [self.dataBase executeQuery:@"select * from t_student"];
//此处额外补充一下:根据条件查找
//根据条件查询(id<14的元素)
 FMResultSet *resultSet = [self.dataBase executeQuery:@"select * from t_student where id<?", @(14)];

     //遍历出需要的结果内容(内部自带的next方法逐步循环set,打印结果)

     while ([resuletSet next]) {

         NSString *name = [resuletSet objectForColumnName:@"name"];

         NSInteger age = [resuletSet intForColumn:@"age"];

         NSString *sex = [resuletSet objectForColumnName:@"sex"];

         NSLog(@"name = %@, age = %ld, sex = %@", name, age, sex);

     }

     [self.dataBase close];

 }

FMResultSet提供了很多方法，来获取对应字段的信息：(红色为常用查找类)
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumnIndex:
objectForColumnName:

还有一些,我没有列举出来,大家可以自己试试,上面的这些就已经大大满足了我们需要查找的类型需求.

如果我们想要销毁该student表格,可以执行下面语句:

//如果表格存在则销毁,同样使用的是更新,只要不是select,都可以用更新操作来处理数据.
[self.dataBase executeUpadate:@"drop table if exists t_student"];

4.FMDB在多线程中的使用:

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

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

示例代码:

 #pragma mark - 以队列的形式添加数据,是FMDB比较常用的形式

 - (IBAction)insertStudentByLineAtion:(id)sender {

     //以队列的形式添加数据是FMDB比较常用的添加方式

     [self.dataBase open];

     //FMDB不支持多个线程同时操作,所以一般以串行的方式实现相关操作

     //第一步:创建操作队列

     FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:self.filePath];

     //标识:记录是否操作成功

     __block BOOL isSucceed = YES;  //第一个队列语句的isSucceed根据

     //第二步:把所需要的事件打包放在操作队列中

     [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {

         //串行队列 && isSucceed 是依据上一条语句是否成功插入,否则不执行本条语句.一个执行完,下一个才执行.

         isSucceed = [db executeUpdate:@"insert into t_student(name, age, sex) values (?,?,?)", @"隔壁老王", @"", @"男"] && isSucceed;

         isSucceed = [db executeUpdate:@"insert into t_student(name, age, sex) values (?,?,?)", @"赵符壹", @"", @"未知"] && isSucceed;

         isSucceed = [db executeUpdate:@"insert into t_student(name, age, sex) values (?,?,?)", @"AJAR", @"", @"男"] && isSucceed;

         //如果有错误,就会将它返回

         if (!isSucceed) {

             //block返回的参数rollback进行处理(bool类型的指针)

 //有错误,直接返回,不再继续往下执行

             *rollback = YES;

             return ;

         }

     }];

     [self.dataBase close];

 }

码农公寓

1.FMDB简介

2.FMDB优缺点

3.FMDB的使用:

4.FMDB在多线程中的使用:

相关文章