iOS FMDB库详解

作者: 宇宙无敌大强子 | 来源:发表于2017-01-16 16:12 被阅读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地址

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了,大家可以下载下来查看,传送门:点我

相关文章

网友评论

  • 木头Lee:怎么保证数据库数据最新?如果服务端更新了数据,怎么更新本地数据库?请求下来再更新数据库吗?
    宇宙无敌大强子:@木头Lee 这个就看你自己的需求了啊,不一定每次都要请求数据的
    木头Lee:@眼镜科技 那这样每次都需要请求数据,要数据库还有什么意义呢?
    宇宙无敌大强子:是的,请求后再更新,类似于缓存
  • SYSYSY:管理数据库,是不是得写那些 open和close?
    宇宙无敌大强子:@SYSYSY 是的
  • Janine_:怎么得出这个数据库的大小啊?有的app需要清除缓存
  • 服了梨:新手的我 也看得明白,十分赞👍!
  • 卓敦:楼主,能不能判断有没有这个数据库,有才创建呢,还有表,能不能先判断表存不存在然后才操作呢
    darkengine:[FMDatabase databaseWithPath:fileName]这个api会根据路径查找,已有的话会执行open操作没有会执行create;CREATE TABLE IF NOT EXISTS 这句的意思就是没有表的时候才新建表。
  • wokenshin:丰富一下 多线程 和 事务 等内容 就更好啦:smiley:
  • 明天就去:有个问题,创建表的时候怎么给字段添加注释呢?在MySQL语句中是: `id` varchar(32) NOT NULL COMMENT '注释' 但是这样放到OC中会报错,查了好久还是没找到
  • jooooker:找了一上午的教程。还是你这个对我们这种数据库纯新手帮助最大。非常感谢。还有一处非常小的问题,就是你的查询数据哪里声明对象的时候少了个*。
    刘超_a594:作者只是把最基础的放上去了吧 可以写一些提升的,比如如何实际有效的运用到工程中,工作上遇到的难点,一些极端的情况怎么处理的,
    宇宙无敌大强子:谢谢,已经更改了,本来是加了的,不知怎么显示不出来,加了个空格

本文标题:iOS FMDB库详解

本文链接:https://www.haomeiwen.com/subject/mpysbttx.html