FMDB介绍
FMDB
是一款简洁、易用的封装库。因此,在这里推荐使用第三方框架FMDB
,它是对libsqlite3
框架的封装,用起来的步骤与SQLite
使用类似,并且它对于多线程的并发操作进行了处理,所以是线程安全的。
- 对多线程的并发操作进行处理,所以是线程安全的。
- 以
OC
的方式封装了SQLite
的C语言API
,使用起来更加的方便。 -
FMDB
是轻量级的框架,使用灵活。
FMDB导入
- 用
cocoapods
导入 - 导入
libsqlite3.0.tbd
库 - 导入头文件
#import <FMDB/FMDB.h>
platform :ios, '8.0'
target 'FMDBDemo' do
use_frameworks!
pod 'FMDB'
end
FMDB框架中重要的框架类
-
FMDatabase
FMDatabase
对象就代表一个单独的SQLite
数据库,用来执行SQL
语句。 -
FMResultSet
使用FMDatabase
执行查询后的结果集。 -
FMDatabaseQueue
用于在多线程中执行多个查询或更新,它是线程安全的。
数据库路径
创建FMDatabase
对象时参数为SQLite
数据库文件路径。
- 文件路径。该文件路径无需真实存在,如果不存在会自动创建。
- 空字符串
@""
。表示会在临时目录创建一个空的数据库,当FMDatabase
连接关闭时,文件也会被删除。 -
NULL
。将创建一个内在数据库,同样的,当FMDatabase
连接关闭时,数据将会被销毁
NSString *lidDirPath = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];
NSString *databasePath = [lidDirPath stringByAppendingPathComponent:@"DatabaseDemo.sqlite"];
使用FMDataBase类执行数据库命令SQL
executeUpdate:
一切不是SELECT命令的命令都视为更新。这包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。
executeQuery:
SELECT开头的命令
执行更新返回一个BOOL
值。YES
表示执行成功,No
则表示有错误。你可以调用-lastErrorMessage
和-lastErrorCode
方法来得到更多信息。
注意:
执行语句不区分大小写。
创建数据库
// 根据指定的沙盒路径来创建数据对象,如果路径下的数据库不存在,就创建,如果存在就不创建
self.database = [FMDatabase databaseWithPath:databasePath];
if (self.database != nil) {
NSLog(@"数据库创建成功!");
} else {
NSLog(@"数据库创建失败!");
}
创建表
// 所有的数据库SQL语句,都需要数据库打开之后才能操作
if ([self.database open]) {
NSString *createTableSql = @"create table if not exists User(id integer primary key autoincrement, username text not null, phone text not null, age integer)";
BOOL result = [self.database executeUpdate:createTableSql];
if (result) {
NSLog(@"创建表成功");
} else {
NSLog(@"创建表失败");
}
// 每次执行完对应SQL之后,要关闭数据库
[self.database close];
}
创建成功后能在沙盒路径文件夹下看到.sqlite
文件
插入指令insert
if ([self.database open]) {
NSString *insertSql = @"insert into User(username, phone, age) values(?, ?, ?)";
BOOL result = [self.database executeUpdate:insertSql, @"user01", @"110", @(18)];
if (result) {
NSLog(@"插入数据成功");
} else {
NSLog(@"插入数据失败");
}
[self.database close];
}
可以看到数据库插入了一条数据
删除指令delete
if ([self.database open]) {
NSString *deleteSql = @"delete from User where username = ?";
BOOL result = [self.database executeUpdate:deleteSql, @"user01"];
if (result) {
NSLog(@"删除数据成功");
} else {
NSLog(@"删除数据失败");
}
[self.database close];
}
可以看到数据库对应数据被删除了
更新指令update
if ([self.database open]) {
NSString *updateSql = @"update User set phone = ? where username = ?";
BOOL result = [self.database executeUpdate:updateSql, @"15823456789", @"user01"];
if (result) {
NSLog(@"更新数据成功");
} else {
NSLog(@"更新数据失败");
}
[self.database close];
}
可以看到数据库对应数据更新了数据
查询指令select
if ([self.database open]) {
NSString *selectSql = @"select * from User";
FMResultSet *resultSet = [self.database executeQuery:selectSql];
while ([resultSet next]) {
NSString *username = [resultSet stringForColumn:@"username"];
NSString *phone = [resultSet stringForColumn:@"phone"];
NSInteger age = [resultSet intForColumn:@"age"];
NSLog(@"username=%@, phone=%@, age=%ld \n", username, phone, age);
}
[self.database close];
}
打印结果
2018-02-05 01:22:50.519489+0800 FMDBDemo[2960:227862] username=user01, phone=15823456789, age=18
2018-02-05 01:22:50.519661+0800 FMDBDemo[2960:227862] username=user02, phone=10086, age=20
使用FMDatabaseQueue
类实现多线程操作
在多个线程中同时使用一个FMDatabase
实例是不明智的。现在你可以为每 个线程创建一个FMDatabase
对象,不要让多个线程分享同一个实例,他无法在多个线程中同时使用。否则程序会时不时崩溃或者报告异常。所以,不要初始化FMDatabase
对象,然后在多个线程中使用。这时候,我们就需要使 用FMDatabaseQueue
来创建队列执行事务。
self.databaseQueue = [FMDatabaseQueue databaseQueueWithPath:databasePath];
// // 要执行的SQL语句,要放在Block里执行,用inDatabase不用手动打开和关闭数据库
[self.databaseQueue inDatabase:^(FMDatabase * _Nonnull db) {
// 创建表,增加,删除,更新,查询 操作
}];
注意block
捕捉变量,使用__block BOOL result = NO;