FMDB 是一个面向对象的管理数据库的轻量级框架，它用 Obective-C 语言对数据库 SQLite 的 C 语言API 进行了封装，并且它对多线程的并发操作进行了处理，是线程安全的!
本文，我会以一个小 demo (同学录)的方式讲在项目中如何使用FMDB的。假如我们有一个老师，他要保存一个班级的所有同学的个人信息，他可以添加学生、删除学生、根据条件查找学生，比如性别、名字等 和 修改学生信息。
如图所示：
选项列表图
下载完整 Demo 一起交流学习，记得给 star 支持博主的努力哦！
FMDB的安装
- 方式一：使用
CocoaPods 安装。
- 方式二：直接去 GitHub 下载，拖入到项目中使用。
FMDB 传送梦
注意，如果使用第二种方式，需要导入系统依赖库 sqlite3.0.tbd 后，才能使用。
FMDB 的使用(线程安全的)
在一个项目中，我们往往是通过单例的模式去管理数据库中的，也就是说整个项目中只有一个数据库管理员(DatabaseManager)。
首先我们要创建要管理的对象 (Model)，本文中是人 (Person)。
创建人的模型 （XYJPerson）
新建一个继承自 NSObject 的 XYJPerson 的类，用来保存人的相关信息。
在XYJPerson.h中，声明我们所需要的信息。
1
2
3
4
5
6
7
8
| @property (nonatomic,copy) NSString * name;
@property (nonatomic,assign) NSInteger age;
@property (nonatomic,copy) NSString * sex;
@property (nonatomic,copy) NSString * QQnumber;
@property (nonatomic,copy) NSString * phoneNumber;
@property (nonatomic,copy) NSString * weixinNumber;
@property (nonatomic,copy) NSString * headImagePath;
@property (nonatomic,assign) NSTimeInterval updateDate;
|
在 XYJPerson.m 中覆写 description 方法，可以方便我们查看 Person 的详细信息。
1
2
3
4
5
| - (NSString *)description
{
return [NSString stringWithFormat:@"name == %@ \n age == %ld \n sex == %@ \n QQnumber == %@ \n phoneNumber == %@ \n weixinNumber == %@ \n headImagePath == %@ \n updateDate == %f",self.name,self.age,self.sex,self.QQnumber,self.phoneNumber,self.weixinNumber,self.headImagePath,self.updateDate];
}
|
其次，我们要新建一个 XYJDatabaseManage r用来管理数据库中 Perso n数据的 增、删、改、查。
创建 （XYJDatabaseManager）
新建一个继承自 NSObject 的 XYJDatabaseManager 的类不是很难。
第一步：在 XYJDatabaseManager.h 文件中导入FMDB的头文件，声明相关属性和单例入口
1
2
3
4
5
| @property (nonatomic,strong,readonly) FMDatabaseQueue * databaseQueue;
+ (instancetype) shareManager;
|
第二步：在 XYJDatabaseManager.m 文件中创建数据库和实现单例。
单例方法的实现：
1
2
3
4
5
6
7
8
9
10
| + (instancetype)shareManager
{static XYJDatabaseManager * manager;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
manager = [[XYJDatabaseManager alloc] init];
});
return manager;
}
|
覆写 init 方法，在 init 方法中创建数据库和表
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
| - (instancetype)init
{
if (self = [super init]) {
NSString * libDirPath = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) firstObject];
NSString * dbPath = [libDirPath stringByAppendingPathComponent:@"databaseDemo.sqlite"];
NSLog(@"dbpath == %@",dbPath);
_databaseQueue = [FMDatabaseQueue databaseQueueWithPath:dbPath];
if (_databaseQueue == nil) {
NSLog(@"数据库创建失败");
[NSException raise:NSInternalInconsistencyException format:@"数据库创建异常"];
}
else
{
NSString *createTablSQL = @"CREATE TABLE IF NOT EXISTS T_PersonList (name text PRIMARY KEY NOT NULL, age integer NOT NULL,sex text,qqNumber text,phoneNumber text,weixinNumber text,headImagePath text,updateDate double)";
[_databaseQueue inDatabase:^(FMDatabase *db) {
BOOL ret = [db executeUpdate:createTablSQL];
if (ret)
{
NSLog(@"创建T_PersonList 表成功");
}
else
{
NSLog(@"创建T_PersonList 表失败");
}
}];
}
}
return self;
}
|
在 XYJDatabaseManager.m 中也可以写对 Model（Person）数据的增、删、改、查方法，但是为了更加方便一些，我们创建一个 Person 的类别，在这个类别中一次实现上述方法。
创建的XYJPerson类别 （XYJPerson+database）
创建方法：Xcode -> File -> New -> File…
选择iOS Source Objective-C File -> Next
然后Next下去就好了。
在 XYJPerson+database.h 中声明常用对象的操作方法。
首先得导入#import "XYJDatabaseManager.h"文件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
- (BOOL) saveToDataBase;
- (BOOL) insertToDataBase;
- (BOOL) updateToDataBaseWithName:(NSString *) lastName;
+ (NSArray *) getAllPersonFromDataBase;
+ (NSArray *) getPersonFromDataBasewithName:(NSString *) name;
+ (NSArray *) getPersonFromDataBasewithSex:(NSString *) sex;
+ (BOOL) deleteFromDataBaseByName:(NSString *) name;
|
接着是去 XYJPerson+database.m 中文件中实现前面声明的方法：
增加记录
*将对象保存到数据库的表中，每个对象都是表中的一条记录！注意执行语句的关键词 REPLACE INTO *
如果表中存在这条数据，就将这条数据替换掉，如果没有，则把这条数据加入到表中。
1
2
3
4
5
6
7
8
9
10
11
12
13
| - (BOOL)saveToDataBase
{
NSString * replaceSQl = @"REPLACE INTO T_PersonList(name, age, sex, qqNumber, phoneNumber, weixinNumber, headImagePath ,updateDate) VALUES(?, ?, ?, ?, ?, ?, ?, ?)";
__block BOOL ret = NO;
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
ret = [db executeUpdate:replaceSQl,self.name,@(self.age),self.sex,self.QQnumber,self.phoneNumber,self.weixinNumber,self.headImagePath,@(self.updateDate)];
}];
return ret;
}
|
插入一条数据到数据库的表中;注意执行语句的关键词 INSERT INTO
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| - (BOOL)insertToDataBase
{
NSString * replaceSQl = @"INSERT INTO T_PersonList(name, age, sex, qqNumber, phoneNumber, weixinNumber, headImagePath ,updateDate) VALUES(?, ?, ?, ?, ?, ?, ?, ?)";
__block BOOL ret = NO;
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
ret = [db executeUpdate:replaceSQl,self.name,@(self.age),self.sex,self.QQnumber,self.phoneNumber,self.weixinNumber,self.headImagePath,@(self.updateDate)];
}];
return ret;
}
|
删除记录
删除根据名字查找到的那条数据;注意执行语句的关键词 DELETE FROM...WHERE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| + (BOOL)deleteFromDataBaseByName:(NSString *) name
{
NSString * deleteSQl = @"DELETE FROM T_PersonList WHERE name = ?";
__block BOOL ret = NO;
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
ret = [db executeUpdate:deleteSQl,name];
}];
return ret;
}
|
修改记录
修改根据名字查找到的那条数据;注意执行语句的关键词 UPDATE...SET...WHERE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| - (BOOL)updateToDataBaseWithName:(NSString *)lastName
{
NSString * replaceSQl = @"UPDATE T_PersonList SET name = ?, age = ?, sex = ?, qqNumber = ?, phoneNumber = ?, weixinNumber = ?, headImagePath = ? ,updateDate= ? WHERE name = ?";
__block BOOL ret = NO;
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
ret = [db executeUpdate:replaceSQl,self.name,@(self.age),self.sex,self.QQnumber,self.phoneNumber,self.weixinNumber,self.headImagePath,@(self.updateDate),lastName];
}];
return ret;
}
|
查询记录
查询到的结果是放在一个 FMResultSet（结果集）中的，遍历这个结果集，将相关数据添加到 Person 对象中，最后以数组的方式返回。
根据名字查询数据;注意执行语句的关键词 SELECT * FROM...WHERE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
| + (NSArray *)getPersonFromDataBasewithName:(NSString *)name
{
NSString * querrySQL = @"SELECT * FROM T_PersonList WHERE name = ?";
NSMutableArray * result = [NSMutableArray array];
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
FMResultSet * rs = [db executeQuery:querrySQL,name];
while ([rs next]) {
XYJPerson * person = [[XYJPerson alloc] init];
person.name = [rs stringForColumn:@"name"];
person.age = [rs intForColumn:@"age"];
person.sex = [rs stringForColumn:@"sex"];
person.QQnumber = [rs stringForColumn:@"qqNumber"];
person.phoneNumber = [rs stringForColumn:@"phoneNumber"];
person.weixinNumber = [rs stringForColumn:@"weixinNumber"];
person.updateDate = [rs doubleForColumn:@"updateDate"];
person.headImagePath = [rs stringForColumn:@"headImagePath"];
[result addObject:person];
}
}];
return result;
}
|
根据性别查询数据
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
| + (NSArray *)getPersonFromDataBasewithSex:(NSString *)sex
{
NSString * querrySQL = @"SELECT * FROM T_PersonList WHERE sex = ?";
NSMutableArray * result = [NSMutableArray array];
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
FMResultSet * rs = [db executeQuery:querrySQL,sex];
while ([rs next]) {
XYJPerson * person = [[XYJPerson alloc] init];
person.name = [rs stringForColumn:@"name"];
person.age = [rs intForColumn:@"age"];
person.sex = [rs stringForColumn:@"sex"];
person.QQnumber = [rs stringForColumn:@"qqNumber"];
person.phoneNumber = [rs stringForColumn:@"phoneNumber"];
person.weixinNumber = [rs stringForColumn:@"weixinNumber"];
person.updateDate = [rs doubleForColumn:@"updateDate"];
person.headImagePath = [rs stringForColumn:@"headImagePath"];
[result addObject:person];
}
}];
return result;
}
|
查询表中的所有数据；并根据添加的时间先后顺序排序
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
| + (NSArray *)getAllPersonFromDataBase
{
NSString * querrySQL = @"SELECT * FROM T_PersonList ORDER BY updateDate ASC";
NSMutableArray * result = [NSMutableArray array];
[[XYJDatabaseManager shareManager].databaseQueue inDatabase:^(FMDatabase *db) {
FMResultSet * rs = [db executeQuery:querrySQL];
while ([rs next]) {
XYJPerson * person = [[XYJPerson alloc] init];
person.name = [rs stringForColumn:@"name"];
person.age = [rs intForColumn:@"age"];
person.sex = [rs stringForColumn:@"sex"];
person.QQnumber = [rs stringForColumn:@"qqNumber"];
person.phoneNumber = [rs stringForColumn:@"phoneNumber"];
person.weixinNumber = [rs stringForColumn:@"weixinNumber"];
person.updateDate = [rs doubleForColumn:@"updateDate"];
person.headImagePath = [rs stringForColumn:@"headImagePath"];
[result addObject:person];
}
}];
return result;
}
|
到这里，我们基本的方法都已经写完了，接下来就剩下来调用了。搭建个简易的 UI 界面测试一下
FMDB 的测试
搭建一个 Input 界面：
选项列表图
添加数据的调用方法：
1
2
3
4
5
6
7
8
9
10
| BOOL ret = [person insertToDataBase];
if (ret) {
NSLog(@"插入数据 到数据库成功");
} else {
NSLog(@"插入数据 到数据库失败");
}
|
搭建一个修改信息的界面：
选项列表图
修改数据的调用方法：
1
2
3
4
5
6
7
| if ([person updateToDataBaseWithName:self.lastName]) {
NSLog(@"更新数据 到数据库成功");
}
else
{
NSLog(@"更新数据 到数据库失败");
}
|
将TableViewCell向左滑可以删除信息：
选项列表图
删除数据的调用方法：
1
2
|
[XYJPerson deleteFromDataBaseByName:person.name];
|
查询所有数据的调用方法
1
2
|
NSArray * allPerson = [XYJPerson getAllPersonFromDataBase ];
|
一个根据性别查询信息的界面：
选项列表图
根据性别查找数据库的调用方法
1
| array = [XYJPerson getPersonFromDataBasewithSex:@"女"];
|
一个根据名字查询信息的界面：
选项列表图
根据名字查找数据库的调用方法
1
| array = [XYJPerson getPersonFromDataBasewithName:@"要查询的名字"];
|
FMDB 的使用(线程不是安全的)
这个暂未更新，后续会补上的…