iOS 基于FMDB简单封装

淳于禄
2023-12-01

准备工作

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

转载于:https://juejin.im/post/5c1a0dfa6fb9a049ff4e12b5

 类似资料: