更新时间: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地址
- Cocoapods导入(推荐),什么你还没有使用Cocoapods,那么就太out了,为了不被社会所淘汰,赶紧学起来吧 唐巧-用CocoaPods做iOS程序的依赖管理 / CocoaPods使用详解
- 手动下载工程,并导入
2.导入libsqlite3框架(一般情况下默认是导入的,所以一般都不用做这一步),细心的朋友可能会发现我们的库中还有一个libsqlite3.0框架,那么它们俩有什么区别呢
3.在需要用到FMDB的控制器(或模型)地方import FMDatabase.h
4.新建一个继承自NSObject的对象,这里我们使用student,接下来数据库中增删改查的对象就用stduent进行操作示例
5.你已经跃跃欲试了吧,别急,本地的.sqlite你现在还无法查看,这里非常推荐火狐浏览器中的插件 SQLite Manager 现在推荐App Store里面自带的Datum Free(免费版)了,使用起来几乎和火狐插件一毛一样。
这里教大家一个快速打开sqlite文件的小技巧,在Finder中将.sqlite文件直接拖动到SQLite Manager的打开文件夹中,可以自动寻址快速打开
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”的数据库已经创建了
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表已经被创建
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的姓名已经被修改了
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表已经被删除了
总结
以上就是基本的使用方法,希望新手也可以看明白。此篇文章会不断更新完善,争取做到FMDB最最详细的介绍,我不嫌啰嗦,希望大家也不要嫌啰嗦(毕竟闻道有先后,很多时候你写得太简单明了笼统了,新手们就比较难理解)。对应的项目也上传到Github了,大家可以下载下来查看,传送门:点我