iOS FMDB库详解

更新时间:2018-11-22 新增了插入/修改数据的注意事项(空值问题)
更新时间:2018-11-06 新增了修改(更新)数据时的多字段修改
更新时间:2018-07-13 修改了推荐的SQLite可视化工具
更新时间: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地址

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

libsqlite3的导入步骤.png

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

FMDB的导入.png

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

student对象.png

5.你已经跃跃欲试了吧,别急,本地的.sqlite你现在还无法查看,这里非常推荐火狐浏览器中的插件 SQLite Manager 现在推荐App Store里面自带的Datum Free(免费版)了,使用起来几乎和火狐插件一毛一样。

Mac官方的应用商店App Store中的Datum free

(现在已经不支持了)火狐浏览器插件.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表中添加了多条数据

添加的数据

PS:如果你需要插入空数据,比如插入一个student对象,name为小明,age为16,但是sex暂时不知道,那么你可以先不加sex,这样(要注意,对象与 ?号一定要对应,不然会报错的)

[_db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?)",name,@(age)];

同时,也可以在sex中插入一个空值,但是这里的空值不是nil,而是NSNull

[_db executeUpdate:@"INSERT INTO t_student (name, age, sex) VALUES (?,?,?)",name,@(age),[NSNull null]];

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姓名修改为了李浩宇

PS.上面的sql语句是只修改了对象的一个字段,如果我们需要更新对象的多个乃至全部字段呢?这种情况下,我们需要先写一个格式为NSString的sql语句,将我们需要更新的字段名都写入其中,然后再调用另一个executeUpdate方法进行更新。代码如下:

NSString *sql = [NSString stringWithFormat:@"update t_student set name = ?, age = ?, sex = ? where id = ?"];
[_db executeUpdate:sql withArgumentsInArray:@[newName, @(newAge),newSex, @(id)]];

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

PS:在对FMDB数据库对象的属性值判断是否为空时,不能用 nil 来判断,而应该用null来判断,正确的写法为

[[resultSet objectForColumnName:@"name"] isKindOfClass:[NSNull Class]];

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

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

8.表的删除

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

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

刷新SQLite
t_student表被删除

总结

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容