iOS - 数据库 第三方框架FMDB

初识FMDB

iOS中原生的SQLite API在进行数据存储的时候，须要使用C语言中的函数，操做比较麻烦。因而，就出现了一系列将SQLite API进行封装的库，例如FMDB、PlausibleDatabase、sqlitepersistentobjects等。

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

FMDB PK 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使用步骤类似，建立数据库路径，得到数据库路径，打开数据库，而后对数据库进行增、删、改、查操做，最后关闭数据库。

step.png

数据库建立

建立FMDatabase对象时参数为SQLite数据库文件路径，该路径能够是如下三种方式之一

• 文件路径。该文件路径无需真实存在，若是不存在会自动建立
• 空字符串(@“”)。表示会在临时目录建立一个空的数据库，当FMDatabase链接关闭时，文件也会被删除

• NULL。将建立一个内在数据库，一样的，当FMDatabase链接关闭时，数据将会被销毁

• 本文中使用的测试模型类.h

student.png

数据库使用FMDB框架代码操做

• 使用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表
  • 根据路径fileName在Finder中搜索.sqlite文件，并复制到桌面
  • 使用火狐浏览器工具下的SQLite Manager打开.sqlite文件
    

    2.png

  • 数据表结构

sql.png

使用FMDataBase类执行数据库命令SQL

一切不是SELECT命令的命令都视为更新。这包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。

简单来讲，只要不是以SELECT开头的命令都是更新命令。

执行更新返回一个BOOL值。YES表示 执行成功，不然表示有错误。你能够调用 -lastErrorMessage 和 -lastErrorCode方法来获得更多信息。

• 使用FMDataBase类执行数据库插入命令SQLinsert into

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

• 使用FMDataBase类执行数据库删除命令SQLdelete

  //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”];

• 使用FMDataBase类执行数据库修改命令SQLupdate

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

• 使用FMDataBase类执行数据库查询命令SQLselect ... from

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

• FMResultSet获取不一样数据格式的方法

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

• 使用FMResultSet获取查询语句结果

  //查询整个表
  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”];
    }

• 使用FMDataBase类执行数据库销毁命令SQLdrop ...

  //若是表格存在 则销毁
    [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;
    }
  }];

  好了，到此为止，相信你已经可以使用FMDB进行数据持久化了，它的好与坏 只有在不断地使用过程当中才能发现了解。因此，但愿你们学会了之后仍是要多 写多练多使用。另外，诚心但愿你们多提宝贵意见，或者沟通一些好的想法。^^