iOS FMDB库详解

2017-01-16 本文已影响6232人宇宙无敌大强子

更新时间：2017-04-17 修改了代码的排版

前言（唠叨）

在网上搜FMDB的资料，要么是很精简的介绍（针对比较有经验的开发者，新手无从下手），要么是排版乱七八糟、代码有不少错误的（直接拷贝过去使用不了，新手还是很难玩转）。FMDB作为这么棒的第三方库，竟然没有一篇文章是专门系统的、详细的介绍它的，简直不能忍。鄙人寻思着给大家写一篇，于是就有了这篇“FMDB库详解”，有错误或者不对的地方请大家及时的指正，鄙人将第一时间火速修改，力争做到文章的代码拷贝就能用，插上就能用（方便新手和大家的开发），另外文章中的代码也力争做到简洁高效通俗大师化。本文将持续更新

什么是FMDB

很简单，一个iOS中SQLite API的封装库。

其他的巴拉巴拉一大堆总结下来就是：
1.是对libsqlite3库的封装，使用起来简洁、高效，没有原来的一大堆晦涩难懂、影响开发效率的C语句，更加面向对象
2.非常的轻量化、灵活
3.对于多线程的并发操作进行了处理，是线程安全的（重要特性之一）
4.因为它是OC语言封装的，只能在ios开发的时候使用，所以在实现跨平台操作的时候存在局限性

FMDB重要（常用）类

FMDatabase：一个FMDatabase对象就代表一个单独的SQLite数据库（注意并不是表），用来执行SQL语句
FMResultSet：使用FMDatabase执行查询后的结果集
FMDatabaseQueue：用于在多线程中执行多个查询或更新,它是线程安全的

FMDB的使用步骤详解

1.准备步骤（基础操作）

1.项目中导入FMDB Github地址

Cocoapods导入（推荐），什么你还没有使用Cocoapods，那么就太out了，为了不被社会所淘汰，赶紧学起来吧唐巧-用CocoaPods做iOS程序的依赖管理 / CocoaPods使用详解
手动下载工程，并导入

2.导入libsqlite3框架（一般情况下默认是导入的，所以一般都不用做这一步）,细心的朋友可能会发现我们的库中还有一个libsqlite3.0框架，那么它们俩有什么区别呢

libsqlite3的导入步骤.png

3.在需要用到FMDB的控制器（或模型）地方import FMDatabase.h

FMDB的导入.png

4.新建一个继承自NSObject的对象，这里我们使用student，接下来数据库中增删改查的对象就用stduent进行操作示例

student对象.png

5.你已经跃跃欲试了吧，别急，本地的.sqlite你现在还无法查看，这里非常推荐火狐浏览器中的插件 SQLite Manager

火狐浏览器插件.png

这里教大家一个快速打开sqlite文件的小技巧，在Finder中将.sqlite文件直接拖动到SQLite Manager的打开文件夹中，可以自动寻址快速打开

SQLite Manager界面.png

Finder中的.sqlite文件.png

sqlite文件打开后的样子.png

2.数据库的创建

需要用到的全局变量（防止新手不理解代码）

//1.获取数据库文件的路径
_docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSLog(@"%@",_docPath);
mark_student = 1;
//设置数据库名称
NSString *fileName = [_docPath stringByAppendingPathComponent:@"student.sqlite"];
//2.获取数据库
 _db = [FMDatabase databaseWithPath:fileName];
if ([_db open]) {
    NSLog(@"打开数据库成功");
} else {
    NSLog(@"打开数据库失败");
}

这里我们可以打开_docPath的路径，可以看到名为“student.sqlite”的数据库已经创建了

student.sqlite

3.表的创建

//3.创建表
BOOL result = [_db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL, sex text NOT NULL);"];
if (result) {  
  NSLog(@"创建表成功");
} else {
  NSLog(@"创建表失败");
}

使用火狐浏览器的SQLite Manager插件打开student.sqlite可以看到t_student表已经被创建

t_student表

4.添加数据

//插入数据
NSString *name = [NSString stringWithFormat:@"王子涵%@",@(mark_student)];
int age = mark_student;
NSString *sex = @"男";
mark_student ++;
//1.executeUpdate:不确定的参数用？来占位（后面参数必须是oc对象，；代表语句结束）
BOOL result = [_db executeUpdate:@"INSERT INTO t_student (name, age, sex) VALUES (?,?,?)",name,@(age),sex];
//2.executeUpdateWithForamat：不确定的参数用%@，%d等来占位 （参数为原始数据类型，执行语句不区分大小写）
//    BOOL result = [_db executeUpdateWithFormat:@"insert into t_student (name,age, sex) values (%@,%i,%@)",name,age,sex];
//3.参数是数组的使用方式
//    BOOL result = [_db executeUpdate:@"INSERT INTO t_student(name,age,sex) VALUES  (?,?,?);" withArgumentsInArray:@[name,@(age),sex]];
if (result) {
    NSLog(@"插入成功");
} else {
    NSLog(@"插入失败");
}

多插入几次后，我们可以看到t_student表中添加了多条数据

添加的数据

5.删除数据

//1.不确定的参数用？来占位 （后面参数必须是oc对象,需要将int包装成OC对象）
int idNum = 11;
BOOL result = [_db executeUpdate:@"delete from t_student where id = ?",@(idNum)];
//2.不确定的参数用%@，%d等来占位
//BOOL result = [_db executeUpdateWithFormat:@"delete from t_student where name = %@",@"王子涵"];
if (result) {
    NSLog(@"删除成功");
} else {
    NSLog(@"删除失败");
}

6.修改数据

//修改学生的名字
NSString *newName = @"李浩宇";
NSString *oldName = @"王子涵2";
BOOL result = [_db executeUpdate:@"update t_student set name = ? where name = ?",newName,oldName];
if (result) {
  NSLog(@"修改成功");
} else {
  NSLog(@"修改失败");
}

查看sqlite，可以看到王子涵2的姓名已经被修改了

王子涵2姓名修改为了李浩宇

7.查询数据

//查询整个表
FMResultSet * resultSet = [_db executeQuery:@"select * from t_student"];
//根据条件查询
//FMResultSet * resultSet = [_db executeQuery:@"select * from t_student where id < ?", @(4)];
//遍历结果集合
while ([resultSet next]) {
     int idNum = [resultSet intForColumn:@"id"];
     NSString *name = [resultSet objectForColumnName:@"name"];
     int age = [resultSet intForColumn:@"age"];
     NSString *sex = [resultSet objectForColumnName:@"sex"];
     NSLog(@"学号：%@ 姓名：%@ 年龄：%@ 性别：%@",@(idNum),name,@(age),sex);
}

执行查询之后控制台的打印，可以看到打印出了目前的所有数据

执行查询数据后控制台的打印结果

8.表的删除

//如果表格存在 则销毁
BOOL result = [_db executeUpdate:@"drop table if exists t_student"];
if (result) {
  NSLog(@"删除表成功");
} else {
  NSLog(@"删除表失败");
}

执行之后，刷新SQLite，可以看到t_student表已经被删除了

刷新SQLite

t_student表被删除

总结

以上就是基本的使用方法，希望新手也可以看明白。此篇文章会不断更新完善，争取做到FMDB最最详细的介绍，我不嫌啰嗦，希望大家也不要嫌啰嗦（毕竟闻道有先后，很多时候你写得太简单明了笼统了，新手们就比较难理解）。对应的项目也上传到Github了，大家可以下载下来查看，传送门：点我