[iOS]数据库第三方框架FMDB详细讲解

4字数 1634阅读 55561

[iOS]数据库第三方框架FMDB详细讲解


初识FMDB


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

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 AUTOINCREMENT, 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 executeQuery:@“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进行数据持久化了,它的好与坏 只有在不断地使用过程中才能发现了解。所以,希望大家学会了以后还是要多  写多练多使用。另外,诚心希望大家多提宝贵意见,或者沟通一些好的想法。^^

推荐阅读更多精彩内容