使用FMDB管理SQLite数据库

欢迎访问我的博客muhlenXi，该文章出自我的博客。

版权声明：本文为muhlenXi原创文章，转载请注明出处，未经允许不得转载.

导语：

FMDB是一个面向对象的管理数据库的轻量级框架，它用Obective-C语言对数据库SQLite的C语言API进行了封装，并且它对多线程的并发操作进行了处理，是线程安全的!

点击阅读全文来深入了解FMDB的如何使用。

本文，我会以一个小demo(同学录)的方式讲在项目中如何使用FMDB的。假如我们有一个老师，他要保存一个班级的所有同学的个人信息，他可以添加学生、删除学生、根据条件查找学生，比如性别、名字等和修改学生信息。

如图所示：

同学录

下载完整 https://github.com/muhlenXi/DatabaseDemo一起交流学习，记得给star支持博主的努力哦！

FMDB的安装

方式一：使用CocoaPods安装。
方式二：直接去Github下载，拖入到项目中使用。

FMDB GitHub链接: https://github.com/ccgus/fmdb

注意，如果使用第二种方式，需要导入系统依赖库sqlite3.0.tbd后，才能使用。

FMDB的使用(线程安全的)

在一个项目中，我们往往是通过单例的模式去管理数据库中的，也就是说整个项目中只有一个数据库管理员(DatabaseManager)。

首先我们要创建要管理的对象(Model)，本文中是人(Person)。

创建人的模型（XYJPerson）

新建一个继承自NSObject的XYJPerson的类，用来保存人的相关信息。

在XYJPerson.h中，声明我们所需要的信息

@property (nonatomic,copy)  NSString * name;  //!<  姓名
@property (nonatomic,assign) NSInteger  age;  //!<  年龄
@property (nonatomic,copy) NSString *  sex;  //!<  性别
@property (nonatomic,copy) NSString *  QQnumber;  //!<  qq号
@property (nonatomic,copy) NSString *  phoneNumber;  //!<  手机号
@property (nonatomic,copy) NSString *  weixinNumber;  //!<  微信号
@property (nonatomic,copy) NSString * headImagePath;  //!<  头像
@property (nonatomic,assign) NSTimeInterval updateDate; //!<  添加的时间

在``XYJPerson.m中覆写description`方法，可以方便我们查看Person的详细信息。

- (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];
    
}

其次，我们要新建一个XYJDatabaseManager用来管理数据库中Person数据的增、删、改、查。

创建（XYJDatabaseManager）

新建一个继承自NSObject的XYJDatabaseManager的类不是很难。

第一步：在XYJDatabaseManager.h文件中导入FMDB的头文件，声明相关属性和单例入口

#import <FMDB/FMDB.h>

@property (nonatomic,strong,readonly) FMDatabaseQueue * databaseQueue;  //!< 用户数据库操作的队列，线程安全的
/**
 *  单例入口
 */
+ (instancetype) shareManager;

第二步：在XYJDatabaseManager.m文件中创建数据库和实现单例。

单例方法的实现：

+ (instancetype)shareManager
{static XYJDatabaseManager * manager;
    
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        
        manager = [[XYJDatabaseManager alloc] init];
    });
    return manager;
}

覆写init方法，在init方法中创建数据库和表

- (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"文件。

/**
 *  添加或更新 一条数据到数据库中
 *
 *  @return 成功或失败
 */
- (BOOL) saveToDataBase;


/**
 *  插入一条数据到数据库中
 *
 *  @return 成功或失败
 */
- (BOOL) insertToDataBase;


/**
 *  根据名字修改数据库中的那条数据
 *
 *  @param lastName 修改之前的名字
 *
 *  @return 成功或失败
 */
- (BOOL) updateToDataBaseWithName:(NSString *) lastName;


/**
 *  从数据库中读出所有的人的信息
 *
 *  @return 所有的人数组
 */
+ (NSArray *) getAllPersonFromDataBase;


/**
 *  根据名字从数据库中查找人的信息
 *
 *  @param name 名字
 *
 *  @return 人的数组
 */
+ (NSArray *) getPersonFromDataBasewithName:(NSString *) name;


/**
 *  根据性别从数据库中查找人的信息
 *
 *  @param sex 性别
 *
 *  @return 人的数组
 */
+ (NSArray *) getPersonFromDataBasewithSex:(NSString *) sex;


/**
 *  根据名字从数据库中删除信息
 *
 *  @param name 要删除的名字
 *
 *  @return 成功或失败
 */
+ (BOOL) deleteFromDataBaseByName:(NSString *) name;

接着是去XYJPerson+database.m中文件中实现前面声明的方法：

增加记录

将对象保存到数据库的表中，每个对象都是表中的一条记录！注意执行语句的关键词REPLACE INTO

如果表中存在这条数据，就将这条数据替换掉，如果没有，则把这条数据加入到表中。

- (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

- (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

+ (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

- (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

+ (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;
}

根据性别查询数据

+ (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;

}

查询表中的所有数据；并根据添加的时间先后顺序排序

+ (NSArray *)getAllPersonFromDataBase
{
    //根据时间先后顺序排序
    //ASC 升序 DESC 降序
    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界面：

Input界面

添加数据的调用方法：

BOOL ret = [person insertToDataBase];
            
//这样也可以
//BOOL ret = [person saveToDataBase];
            
if (ret) {   
   NSLog(@"插入数据 到数据库成功");              
} else {
   NSLog(@"插入数据 到数据库失败");
}

搭建一个修改信息的界面：

修改信息

修改数据的调用方法：

if ([person updateToDataBaseWithName:self.lastName]) {
      NSLog(@"更新数据 到数据库成功");
}
else
{
      NSLog(@"更新数据 到数据库失败");
}

将TableViewCell向左滑可以删除信息：

删除信息

删除数据的调用方法：

//删除数据库数据
[XYJPerson deleteFromDataBaseByName:person.name];

查询所有数据的调用方法

//从数据库中取出所有的用户
NSArray * allPerson = [XYJPerson getAllPersonFromDataBase ];

一个根据性别查询信息的界面：

查询信息

根据性别查找数据库的调用方法

array = [XYJPerson getPersonFromDataBasewithSex:@"女"];

一个根据名字查询信息的界面：

查询信息

根据名字查找数据库的调用方法

array =  [XYJPerson getPersonFromDataBasewithName:@"要查询的名字"];

FMDB的使用(线程不是安全的)

这个暂未更新，后续会补上的...

后记

完整Demo下载地址在这里！