iOS FMDB 数据库~详解

最新推荐文章于 2024-11-17 21:40:41 发布

原创最新推荐文章于 2024-11-17 21:40:41 发布 · 2.5k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#FMDB #sqlite3 #ios #数据库 #详解

iOS 数据库专栏收录该内容

19 篇文章

订阅专栏

//联系人:石虎 QQ: 1224614774昵称:嗡嘛呢叭咪哄

一、简单说明

1.什么是FMDB

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

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

2.FMDB的优点

使用起来更加面向对象，省去了很多麻烦、冗余的c语言代码

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

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

FMDB PK Sqlite

优点:
- 对多线程的并发操作进行处理，所以是线程安全的；
- 以OC的方式封装了SQLite的C语言API，使用起来更加的方便；
- FMDB是轻量级的框架，使用灵活。
缺点:
- 因为它是OC的语言封装的，只能在ios开发的时候使用，所以在实现跨平台操作的时候存在局限性。

3.FMDB的github地址

https://github.com/ccgus/fmdb

二、核心类

FMDB有三个主要的类

（1）FMDatabase

一个FMDatabase对象就代表一个单独的SQLite数据库

用来执行SQL语句

（2）FMResultSet

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

（3）FMDatabaseQueue

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

三、打开数据库

通过指定SQLite数据库文件路径来创建FMDatabase对象

FMDatabase *db = [FMDatabase databaseWithPath:path];

if (![db open]) {

NSLog(@"数据库打开失败！");

}

文件路径有三种情况

（1）具体文件路径

　　如果不存在会自动创建

（2）空字符串@""

　　会在临时目录创建一个空的数据库

　　当FMDatabase连接关闭时，数据库文件也被删除

（3）nil

　　会创建一个内存中临时数据库，当FMDatabase连接关闭时，数据库会被销毁

四、执行更新

在FMDB中，除查询以外的所有操作，都称为“更新”

create、drop、insert、update、delete等

使用executeUpdate:方法执行更新

- (BOOL)executeUpdate:(NSString*)sql, ...

- (BOOL)executeUpdateWithFormat:(NSString*)format, ...

- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments

示例

[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack"]

五、执行查询

查询方法

- (FMResultSet *)executeQuery:(NSString*)sql, ...

- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...

- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments

示例

// 查询数据

FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];

// 遍历结果集

while ([rs next]) {

NSString *name = [rs stringForColumn:@"name"];

int age = [rs intForColumn:@"age"];

double score = [rs doubleForColumn:@"score"];

}

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

谢谢!!!