FMDB— 简单介绍

Posted llguanli

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了FMDB— 简单介绍相关的知识,希望对你有一定的参考价值。

ios开发过程中常常会用到数据库方面的操作,但是iOS原生的SQLite API使用起来并不十分友好,对于C语言基础较薄弱的朋友来说。使用起来可能会认为比較不便。于是,一些第三方的对SQLite API进行封装的库就这么出现了。比如本文所要介绍给大家的FMDB。

1.FMDB简单介绍

  • 什么是FMDB

FMDB是iOS平台的SQLite数据库框架

FMDB以OC的方式封装了SQLite的C语言API

  • 为什么使用FMDB

使用起来更加面向对象,省去了非常多麻烦、冗余的C语言代码

对照苹果自带的Core Data框架,更加轻量级和灵活

提供了多线程安全的数据库操作方法,有效地防止数据混乱

  • FMDB在GitHub上的链接

GitHub

2.FMDB使用指南

  • 下载FMDB框架

技术分享图片

?

  • 在项目中导入第三方框架(导入前须要将sqlite3库文件导入项目)

技术分享图片

?

直接将fmdb目录拖入project。下图箭头指向内容须要勾选:

技术分享图片

?

最后,在使用过程中引入头文件就可以。

3.FMDB的三个主要类

  • FMDatabase – 一个FMDatabase对象就表示一个单独的SQLite数据库,用来运行SQLite的命令
  • FMResultSet – 表示FMDatabase运行查询后结果集
  • FMDatabaseQueue – 假设你想在多线程中运行多个查询或更新,你应该使用该类,这样能保证线程安全

?4.打开数据库

  • 创建FMDatabase对象,參数为SQLite数据库文件路径。

  1. //获取沙盒路径
  2. NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
  3. //设置数据库路径
  4. NSString *filePath = [path stringByAppendingPathComponent:@"student.sqlite"];
  5. FMDatabase *database = [FMDatabase databaseWithPath:filePath];
  • 数据库文件路径能够是下面三种之中的一个:
1.具体文件路径。该文件路径假设不存在会自己主动创建。
2.空字符串(@””)。

表示会在暂时目录创建一个空的数据库。当FMDatabase 链接关闭时,文件也会被删除。

3.NULL。 将创建一个内存中的暂时数据库。

相同的,当FMDatabase连接关闭时。数据文件会被销毁。

  • 打开数据库(不论什么与数据库的交互都必须先打开数据库)
  1. if ([database open]) {
  2. //这里写运行操作代码
  3. } else {
  4. //数据库打开失败
  5. return;
  6. }
?检验一下我们的数据库是否创建成功(在沙盒路径中观察数据库是否存在):
技术分享图片
通过我们获取到的数据库路径,在Finder中前往目录选项输入我们的路径就能够找到我们创建的数据库了。


上一章节我们做了对FMDB的基本介绍。今天我们介绍FMDB的具体用法,通过对数据库的增删改查来熟悉FMDB的使用。

1.创建数据表

使用FMDB建立数据表的方法十分简单。先创建sql语句,然后调用executeUpdate方法运行操作:

  1. //创建数据表person(id, name, sex, telephone)
  2. NSString *createSql = [NSString stringWithFormat:@"create table if not exists person (id integer primary key, name text, sex text, telephone text)"];
  3. //运行更新操作(创建表)
  4. if (![database executeUpdate:createSql]) {
  5. NSLog(@"create table failed!");
  6. }

?2.加入数据

在executeUpdate方法后直接加sql语句时要注意数据类型的使用,必须使用OC的对象类型

  1. //插入一条记录,(1,jack,male,12345678)
  2. NSString *insertSql = [NSString stringWithFormat:@"insert into person (id, name, sex, telephone) values (%d, ‘%@‘, ‘%@‘, ‘%@‘)", 1, @"jack", @"male", @"12345678"];
  3. //运行更新操作(插入记录)
  4. if (![database executeUpdate:insertSql]) {
  5. NSLog(@"insert failed!");
  6. }
  7. //在executeUpdate后面直接加sql语法时。使用?

    来表示OC中的对象,integer相应NSNumber。text相应NSString,blob相应NSData。数据内部转换FMDB已经完毕。仅仅要sql语法正确就没有问题

  8. if (![database executeUpdate:@"insert into person (id, name, sex, telephone) values (?

    , ?

    , ?, ?)", @4, @"gary", @"male", @"99996666"]) {

  9. NSLog(@"insert failed!");
  10. }

?3.改动数据

  1. //更新(改动)一条记录。将id = 1的记录姓名改动为mike
  2. NSString *updateSql = [NSString stringWithFormat:@"update person set name = ‘%@‘ where id = 1", @"mike"];
  3. //运行更新操作
  4. if (![database executeUpdate:updateSql]) {
  5. NSLog(@"update failed!");
  6. }

4.删除数据

  1. //删除一条记录,从person表中将id= 2的记录删除
  2. NSString *deleteSql = [NSString stringWithFormat:@"delete from person where id = 2"];
  3. //运行删除操作
  4. if (![database executeUpdate:deleteSql]) {
  5. NSLog(@"delete failed!");
  6. }

?5.查询数据

FMDB中一切不是SELECT命令的数据库操作都视为更新。使用executeUpdate方法。SELECT命令的数据库操作使用executeQuery方法。

  1. //查询数据库中记录
  2. NSString *selectSql = [NSString stringWithFormat:@"select * from person"];
  3. //使用executeQuery方法来运行查询语句,使用FMResultSet *来接收查询到的数据
  4. FMResultSet *rs = [database executeQuery:selectSql];
  5. //[rs next]相当于sqlite3_step语句,用来逐行检索数据表中记录
  6. while ([rs next]) {
  7. //使用字段位置查询
  8. NSLog(@"id = %d", [rs intForColumnIndex:0]);
  9. //使用字段名称查询[rs stringForColumn:@"name"]
  10. NSLog(@"name = %@", [rs stringForColumn:@"name"]);
  11. NSLog(@"sex = %@", [rs stringForColumnIndex:2]);
  12. NSLog(@"telephone = %@", [rs stringForColumnIndex:3]);
  13. }


1.多线程下FMDB使用须知

在多线程的环境下。不能多个线程共享一个FMDatabase对象,也不能在多个线程同一时候创建多个FMDatabaseQueue实例来操作同一个数据库。这样可能会造成数据的操作丢失,甚至引起程序的崩溃。由于FMDB是对sqlite的封装,而文件数据库sqlite在同一时刻同意多个进程/线程读。但同一时刻仅仅同意一个线程写。在进行写操作时。数据库文件会被琐定。此时不论什么其它读/写操作都被堵塞,假设堵塞超过5秒钟(默认是5秒,又一次编译sqlite能够改动超时时间)。就报”database is locked”错误。假设线程使用单独的FMDatabase 实例是同意的。但是相同有可能发生database is locked的问题,这是由于多线程对sqlite的竞争引起的。

2.FMDatabaseQueue的使用

使用FMDatabaseQueue能够比較有效的解决多线程下对数据库的訪问。FMDatabaseQueue解决多线程问题的思路大致是:创建一个队列。然后将须要运行的数据库操作放入block中,队列中的block依照加入进队列的顺序依次运行,实际上还是同步的操作,避免了多个线程同一时候对数据库的訪问。

创建一个全局FMDatabaseQueue 对象,这样做的目的是为了避免发生并发訪问数据库的操作。项目开发过程中能够创建一个单例来共享这个FMDatabaseQueue 对象。

  1. //创建一个FMDatabaseQueue队列
  2. static FMDatabaseQueue *queue;
  1. //初始化队列
  2. queue = [FMDatabaseQueue databaseQueueWithPath:filePath];
  3. //调用inDatabase方法来将须要运行的操作加入到队列queue中去
  4. [queue inDatabase:^(FMDatabase *db) {
  5. //加入须要运行的操作
  6. [db executeUpdate:@"insert into person (id, name, sex, telephone) values (?

    , ?, ?, ?)", @100, @"test1", @"male", @"11114321"];

  7. [db executeUpdate:@"insert into person (id, name, sex, telephone) values (?

    , ?, ?

    , ?)", @101, @"test2", @"male", @"22224321"];

  8. //继续加入想要运行的操作...
  9. }];

使用类似的方法,我们就能够在FMDB中把一些任务包装进事务(在FMDatabaseQueue使用过程中尽量避免嵌套使用,以免造成死锁):

  1. //调用inTransaction方法将须要运行的操作加入到队列中去
  2. [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
  3. //在事务中加入须要运行的操作,出现异常时及时回滚
  4. if (![db executeUpdate:@"insert into person (id, name, sex, telephone) values (?, ?, ?, ?)", @104, @"test3", @"male", @"11114321"]) {
  5. *rollback = YES;
  6. return ;
  7. }
  8. if (![db executeUpdate:@"insert into person (id, name, sex, telephone) values (?, ?, ?, ?)", @105, @"test4", @"male", @"11114321"]) {
  9. *rollback = YES;
  10. return ;
  11. }
  12. }];

3.总结

FMDatabaseQueue尽管看似一个队列,实际上它本身并非。它通过内部创建一个Serial的dispatch_queue_t来处理通过inDatabase和inTransaction传入的Blocks,所以当我们在主线程(或者后台)调用inDatabase或者inTransaction时,代码实际上是同步的,这样就避免了多个线程同一时候訪问数据库的问题。假设在后台运行大量的更新操作时。主线程又须要运行少量的数据库操作,那么在后台操作运行完之前,它还是须要等待。这时就会堵塞主线程。

  • 假设在后台使用inDatabase来更新大批量的数据时,能够考虑使用inTransaction。由于后者的更新效率高非常多,特别是更新大量操作(如1000条以上)
  • 假设非必须一次性的、完整性的大批量数据,能够考虑使用数据拆解。将大量数据分成较多批少量的数据。再进行更新操作,这样能有效地避免长时间的堵塞
  • 假设UI上不须要在更新数据时产生交互,能够将FMDatabaseQueue放入一个子线程中异步运行,这是一个不错的选择

以上是关于FMDB— 简单介绍的主要内容,如果未能解决你的问题,请参考以下文章

iOS 数据库第三方FMDB的简单使用

FMDB— 简单介绍

ios 关于FMDB的基本使用

FMDB 如何让 sqlite 更简单 iOS?

FMDB的使用

FMDB浅析