准备工作
#import "FMDatabase.h"//数据库的类 相当于sqlite3* 句柄(一个FMDatabase对象就代表一个单独的SQLite数据库,用来执行SQL语句)。
#import "FMResultSet.h"//伴随指针,使用FMDatabase执行查询后的结果集
#import "FMDatabaseAdditions.h"//FMDatabase类的一个类目,是给FMDatabase的一个扩展
#import "FMDatabaseQueue.h"//用与在多线程中执行多个查询或者更新,它能够保证线程是安全的。
#import "FMDatabasePool.h"
复制代码
- 在桌面新建一个工程,打开终端输入pod search FMDB,找到我们所需要的第三方类库pod 'FMDB', '~> 2.6.2'
- 输入cd然后空格,再将我们桌面上的工程拖进终端里,这是你会看到生成了一个路径,这就是你这个工程的根目录,然后回车。
- 在在终端输入vim Podfile 然后回车。
- 然后你进图了一个Podfile文件,这时候你需要输入一个i,进入编辑状态
- 然后把刚才我们找到的pod 'FMDB', '~> 2.6.2'输入。
- 然后在按下键盘左上角的ESC键再按“:”退出
- 然后再在终端中输入pod instrall,然后等待下载完成。
执行完以上7步,一个第三方的FMDB就配置好了。
封装一个FMDBhelp
打开工程,在工程中新建一个继承自NSObject的类,在这个类里我们简单封装一下一个通用的接口
h文件
首先我们来看.h文件中我们需要开放的方法。
#import <Foundation/Foundation.h>
@interface FMDBhelp : NSObject
- (void)createDBWithName:(NSString *)dbName;
//无返回结果集的操作
- (BOOL)notResustSetWithSql:(NSString*)sql;
//有返回结果集的操作
- (NSArray *)qureyWithSql:(NSString *)sql;
//单例
+ (FMDBhelp*)sharedFMDBhelp;
@end
复制代码
m文件
- 新建一个延展,在类目中声明两个属性
@interface FMDBhelp()
@property (strong, nonatomic)NSString *fileName;//数据库文件的路径
@property (strong, nonatomic)FMDatabase *dataBase;//数据库对象
@end
复制代码
- 给用户开放一个自动命名的方法。
-(void)createDBWithName:(NSString *)dbName{
if (dbName.length == 0) {
/**
* 是防止用户直接传值为nil或者NULL
*/
self.fileName = nil; **注意:当返回值为nil或者NULL的时候,表示会在临时目录下创建一个空的
数据库,当FMDatabase连接关闭的时候,文件也会被删除**
}else{
/**
* 判断用户是否为数据库文件添加后缀名
*/
if ([dbName hasSuffix:@".sqlite"]) {
self.fileName = dbName;
}else{
self.fileName = [dbName stringByAppendingString:@".sqlite"];
}
}
}
复制代码
- 根据名称创建沙盒路径,用来保存数据库文件。
-(NSString *)DBPath{
if (self.fileName) {//说明fileName有值
NSString *savePath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)
lastObject]stringByAppendingPathComponent:[NSString stringWithFormat:@"%@",self.fileName]];
return savePath;
}else{
return @"";
}
}
复制代码
- 利用懒加载的方式创建数据库对象
-(FMDatabase *)dataBase{
if (!_dataBase) {
_dataBase = [FMDatabase databaseWithPath:[self DBPath]];
}return _dataBase;
}
复制代码
- 打开或者创建一个数据库
-(BOOL)openOrCreateDB{
if ([self.dataBase open]) {
NSLog(@"数据库打开成功");
return YES;
}else{
NSLog(@"打开数据库失败");
return NO;
}
}
复制代码
- 关闭数据库的方法
-(void)closeDB{
BOOL isClose = [self.dataBase close];
if (isClose) {
NSLog(@"关闭成功");
}else{
NSLog(@"关闭失败");
}
}
复制代码
- 无返回结果集的操作
-(BOOL)notResustSetWithSql:(NSString*)sql{
BOOL isOpen = [self openOrCreateDB];
if (isOpen) {
BOOL isUpdate = [self.dataBase executeUpdate:sql];
[self closeDB];//关闭数据库
return isUpdate;
}else{
[self closeDB];//关闭数据库
return NO;
}
}
复制代码
- 有返回结果集的操作,查询方法
-(NSArray *)qureyWithSql:(NSString *)sql{
//打开数据库
BOOL isOpen = [self openOrCreateDB];
if (isOpen) {
NSLog(@"打开数据库成功");
//得到所有记录的结果集
FMResultSet *resuluSet = [self.dataBase executeQuery:sql];
//声明可变数组,用来存放所有的记录
NSMutableArray *resultArray = [NSMutableArray array];
// 遍历结果集,取出每一条记录,并且存储到可变数组中
while ([resuluSet next]) {
//直接将一条记录转换为字典类型
NSDictionary *dic =[resuluSet resultDictionary];
[resultArray addObject:dic];
}
//释放结果集
[resuluSet close];
//关闭数据库
[self closeDB];
return resultArray;
}else{
NSLog(@"打开数据库失败");
return nil;
}
}
复制代码
- FMDBhelp的单例
+(FMDBhelp*)sharedFMDBhelp{
static FMDBhelp *helper = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
helper = [[FMDBhelp alloc]init];
});
return helper;
}
复制代码
至此一个基于FMDB的简单封装就完成了。