FMDB

Posted 2020-08-03 潜意识

ios中原生的SQLite API在进行数据存储的时候，需要使用C语言中的函数，操作比较麻烦。于是，就出现了一系列将SQLite API进行封装的库，例如FMDB

FMDB是一款简洁、易用的封装库。因此，在这里推荐使用第三方框架FMDB，它是对libsqlite3框架的封装，用起来的步骤与SQLite使用类似，并且它对于多线程的并发操作进行了处理，所以是线程安全的。

---

 

优点:

对多线程的并发操作进行处理，所以是线程安全的；

以OC的方式封装了SQLite的C语言API，使用起来更加的方便；

FMDB是轻量级的框架，使用灵活。

缺点:

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

---

 

FMDB框架中重要的框架类

FMDatabase

FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句

FMResultSet

使用FMDatabase执行查询后的结果集

FMDatabaseQueue

用于在多线程中执行多个查询或更新，它是线程安全的

---

 

FMDB使用步骤

下载FMDB文件GitHub,并将FMDB文件夹添加到项目中（也可使用CocoaPods导入）

导入libsqlite3.0框架，导入头文件FMDatabase.h

代码实现，与SQLite使用步骤相似，创建数据库路径，获得数据库路径，打开数据库，然后对数据库进行增、删、改、查操作，最后关闭数据库。

---

 

使用FMDataBase类建立数据库

 //1.获得数据库文件的路径
  NSString *doc =[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES)  lastObject];                  

  NSString *fileName = [doc stringByAppendingPathComponent:@“student.sqlite”];

   //2.获得数据库
   FMDatabase *db = [FMDatabase databaseWithPath:fileName];

 //3.使用如下语句，如果打开失败，可能是权限不足或者资源不足。通常打开完操作操作后，需要调用 close 方法来关闭数据库。在和数据库交互 之前，数据库必须是打开的。如果资源或权限不足无法打开或创建数据库，都会导致打开失败。
 if ([db open])
  {
        //4.创表
      BOOL result = [db executeUpdate:@“CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREM ENT, name text NOT NULL, age integer NOT NULL);”];
       if (result)
        {
          NSLog(@"创建表成功");
        }
  }

插入命令SQL:

int age = 42;

 //1.executeUpdate:不确定的参数用？来占位（后面参数必须是oc对象，；代表语句结束）
 [self.db executeUpdate:@“INSERT INTO t_student (name, age) VALUES (?,?);”,name,@(age)];

    //2.executeUpdateWithForamat：不确定的参数用%@，%d等来占位 （参数为原始数据类型，执行语句不区分大小写）
 [self.db executeUpdateWithForamat:@“insert into t_student (name,age) values (%@,%i);”,name,age];

    //3.参数是数组的使用方式
 [self.db executeUpdate:@“INSERT INTO t_student(name,age) VALUES(?,?);”withArgumentsInArray:@[name,@(age)]];

删除命令SQL:

//1.不确定的参数用？来占位 （后面参数必须是oc对象,需要将int包装成OC对象）
  int idNum = 101;
    [self.db executeUpdate:@“delete from t_student where id = ?;”,@(idNum)];

   //2.不确定的参数用%@，%d等来占位
    [self.db executeUpdateWithFormat:@“delete from t_student where name = %@;”,@“apple_name”];

修改命令SQL:

//修改学生的名字
  [self.db executeUpdate:@“update t_student set name = ? where name = ?”,newName,oldName];

---

 

查询:

FMResultSet获取不同数据格式的方法

• intForColumn:
• longForColumn:
• longLongIntForColumn:
• boolForColumn:
• doubleForColumn:
• stringForColumn:
• dataForColumn:
• dataNoCopyForColumn:
• UTF8StringForColumnIndex:
• objectForColumn:

//查询整个表
FMResultSet *resultSet = [self.db execute Query:@“select * from t_student;”];

 //根据条件查询
FMResultSet *resultSet = [self.db executeQuery:@“select * from t_student where id<?;”@(14)];

 //遍历结果集合   

while ([resultSet  next])

   {
    int idNum = [resultSet intForColumn:@“id”]；

    NSString *name = [resultSet    
    objectForColumn:@“name”];

    int age = [resultSet intForColumn:@“age”];
  }

销毁命令SQL

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

---

 

使用FMDatabaseQueue类实现多线程操作:

在多个线程中同时使用一个FMDatabase实例是不明智的。现在你可以为每 个线程创建一个FMDatabase对象，不要让多个线程分享同一个实例，他无 法在多个线程中同事使用。否则程序会时不时崩溃或者报告异常。所以，不要 初始化FMDatabase对象，然后在多个线程中使用。这时候，我们就需要使 用FMDatabaseQueue来创建队列执行事务。

//1.创建队列
 FMDatabaseQueue *queue = [FMDatabaseQueue   
 databaseQueueWithPath:aPath];
  __block BOOL whoopsSomethingWrongHappened = true;

 //2.把任务包装到事务里
 [queue inTransaction:^(FMDatabase *db, BOOL *rollback) 
   {  
 whoopsSomethingWrongHappened &=  [db     executeUpdate:@“INSERT INTO myTable VALUES (?)”,     [NSNumber numberWith:1]];
whoopsSomethingWrongHappened &= [db
executeUpdata:@“INSERT INTO myTable VALUES (?)”, 
[NSNumber numberWithInt:2]];

whoopsSomethingWrongHappened &= [db  
executeUpdata:@“INSERT INTO myTable VALUES (?)”[NSNumber  
numberWithInt:3]];
//如果有错误 返回
if (!whoopsSomethingWrongHappened)
  { 
    *rollback = YES;
      return;
  }
}];