iOS 基于FMDB简单封装

准备工作

#import "FMDatabase.h"//数据库的类 相当于sqlite3* 句柄（一个FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句）。
#import "FMResultSet.h"//伴随指针，使用FMDatabase执行查询后的结果集
#import "FMDatabaseAdditions.h"//FMDatabase类的一个类目,是给FMDatabase的一个扩展
#import "FMDatabaseQueue.h"//用与在多线程中执行多个查询或者更新，它能够保证线程是安全的。
#import "FMDatabasePool.h"

1. 在桌面新建一个工程，打开终端输入pod search FMDB，找到我们所需要的第三方类库pod 'FMDB', '~> 2.6.2'
2. 输入cd然后空格，再将我们桌面上的工程拖进终端里，这是你会看到生成了一个路径，这就是你这个工程的根目录，然后回车。
3. 在在终端输入vim Podfile 然后回车。
4. 然后你进图了一个Podfile文件，这时候你需要输入一个i，进入编辑状态
5. 然后把刚才我们找到的pod 'FMDB', '~> 2.6.2'输入。
6. 然后在按下键盘左上角的ESC键再按“：”退出
7. 然后再在终端中输入pod instrall，然后等待下载完成。

执行完以上7步，一个第三方的FMDB就配置好了。

封装一个FMDBhelp

打开工程，在工程中新建一个继承自NSObject的类，在这个类里我们简单封装一下一个通用的接口

h文件

首先我们来看.h文件中我们需要开放的方法。

#import 

@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的简单封装就完成了。