歡迎訪問我的博客muhlenXi截汪，該文章出自我的博客廊遍。
版權(quán)聲明：本文為muhlenXi原創(chuàng)文章，轉(zhuǎn)載請注明出處乍丈，未經(jīng)允許不得轉(zhuǎn)載.
導(dǎo)語：
FMDB是一個面向?qū)ο蟮墓芾頂?shù)據(jù)庫的輕量級框架剂碴，它用Obective-C語言對數(shù)據(jù)庫SQLite的C語言API進行了封裝，并且它對多線程的并發(fā)操作進行了處理轻专，是線程安全的!
點擊閱讀全文來深入了解FMDB的如何使用忆矛。
本文，我會以一個小demo(同學(xué)錄)的方式講在項目中如何使用FMDB的请垛。假如我們有一個老師催训，他要保存一個班級的所有同學(xué)的個人信息，他可以添加學(xué)生宗收、刪除學(xué)生漫拭、根據(jù)條件查找學(xué)生，比如性別混稽、名字等 和 修改學(xué)生信息采驻。
如圖所示：
下載完整 https://github.com/muhlenXi/DatabaseDemo一起交流學(xué)習(xí)，記得給star支持博主的努力哦匈勋！
FMDB的安裝
- 方式一：使用
CocoaPods安裝礼旅。 - 方式二：直接去Github下載，拖入到項目中使用洽洁。
FMDB GitHub鏈接: https://github.com/ccgus/fmdb
注意痘系，如果使用第二種方式，需要導(dǎo)入系統(tǒng)依賴庫sqlite3.0.tbd后饿自，才能使用汰翠。
FMDB的使用(線程安全的)
在一個項目中临谱，我們往往是通過單例的模式去管理數(shù)據(jù)庫中的，也就是說整個項目中只有一個數(shù)據(jù)庫管理員(DatabaseManager)奴璃。
首先我們要創(chuàng)建要管理的對象(Model)悉默，本文中是人(Person)。
創(chuàng)建人的模型 （XYJPerson）
新建一個繼承自NSObject的XYJPerson的類苟穆，用來保存人的相關(guān)信息抄课。
在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的詳細(xì)信息跟磨。
- (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用來管理數(shù)據(jù)庫中Person數(shù)據(jù)的增躬贡、刪、改寝杖、查型豁。
創(chuàng)建 （XYJDatabaseManager）
新建一個繼承自NSObject的XYJDatabaseManager的類不是很難僵蛛。
第一步：在XYJDatabaseManager.h文件中導(dǎo)入FMDB的頭文件，聲明相關(guān)屬性和單例入口
#import <FMDB/FMDB.h>
@property (nonatomic,strong,readonly) FMDatabaseQueue * databaseQueue; //!< 用戶數(shù)據(jù)庫操作的隊列迎变，線程安全的
/**
* 單例入口
*/
+ (instancetype) shareManager;
第二步：在XYJDatabaseManager.m文件中創(chuàng)建數(shù)據(jù)庫和實現(xiàn)單例充尉。
單例方法的實現(xiàn)：
+ (instancetype)shareManager
{static XYJDatabaseManager * manager;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
manager = [[XYJDatabaseManager alloc] init];
});
return manager;
}
覆寫init方法，在init方法中創(chuàng)建數(shù)據(jù)庫和表
- (instancetype)init
{
if (self = [super init]) {
//數(shù)據(jù)庫存放路徑
NSString * libDirPath = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) firstObject];
NSString * dbPath = [libDirPath stringByAppendingPathComponent:@"databaseDemo.sqlite"];
NSLog(@"dbpath == %@",dbPath);
//創(chuàng)建數(shù)據(jù)庫
_databaseQueue = [FMDatabaseQueue databaseQueueWithPath:dbPath];
if (_databaseQueue == nil) {
NSLog(@"數(shù)據(jù)庫創(chuàng)建失敗");
[NSException raise:NSInternalInconsistencyException format:@"數(shù)據(jù)庫創(chuàng)建異常"];
}
else
{
//創(chuàng)建一個表
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(@"創(chuàng)建T_PersonList 表成功");
}
else
{
NSLog(@"創(chuàng)建T_PersonList 表失敗");
}
}];
}
}
return self;
}
在XYJDatabaseManager.m中也可以寫對Model（Person）數(shù)據(jù)的增衣形、刪驼侠、改、查方法谆吴，但是為了更加方便一些倒源，我們創(chuàng)建一個Person的類別，在這個類別中一次實現(xiàn)上述方法句狼。
創(chuàng)建的XYJPerson類別 （XYJPerson+database）
創(chuàng)建方法：Xcode -> File -> New -> File...
選擇iOS Source Objective-C File -> Next
然后Next下去就好了笋熬。
在XYJPerson+database.h中聲明常用對象的操作方法。
首先得導(dǎo)入#import "XYJDatabaseManager.h"文件鲜锚。
/**
* 添加或更新 一條數(shù)據(jù)到數(shù)據(jù)庫中
*
* @return 成功或失敗
*/
- (BOOL) saveToDataBase;
/**
* 插入一條數(shù)據(jù)到數(shù)據(jù)庫中
*
* @return 成功或失敗
*/
- (BOOL) insertToDataBase;
/**
* 根據(jù)名字修改數(shù)據(jù)庫中的那條數(shù)據(jù)
*
* @param lastName 修改之前的名字
*
* @return 成功或失敗
*/
- (BOOL) updateToDataBaseWithName:(NSString *) lastName;
/**
* 從數(shù)據(jù)庫中讀出所有的人的信息
*
* @return 所有的人數(shù)組
*/
+ (NSArray *) getAllPersonFromDataBase;
/**
* 根據(jù)名字從數(shù)據(jù)庫中查找人的信息
*
* @param name 名字
*
* @return 人的數(shù)組
*/
+ (NSArray *) getPersonFromDataBasewithName:(NSString *) name;
/**
* 根據(jù)性別從數(shù)據(jù)庫中查找人的信息
*
* @param sex 性別
*
* @return 人的數(shù)組
*/
+ (NSArray *) getPersonFromDataBasewithSex:(NSString *) sex;
/**
* 根據(jù)名字從數(shù)據(jù)庫中刪除信息
*
* @param name 要刪除的名字
*
* @return 成功或失敗
*/
+ (BOOL) deleteFromDataBaseByName:(NSString *) name;
接著是去XYJPerson+database.m中文件中實現(xiàn)前面聲明的方法：
增加記錄
將對象保存到數(shù)據(jù)庫的表中突诬，每個對象都是表中的一條記錄！注意執(zhí)行語句的關(guān)鍵詞REPLACE INTO
如果表中存在這條數(shù)據(jù)芜繁，就將這條數(shù)據(jù)替換掉，如果沒有绒极，則把這條數(shù)據(jù)加入到表中骏令。
- (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;
}
插入一條數(shù)據(jù)到數(shù)據(jù)庫的表中;注意執(zhí)行語句的關(guān)鍵詞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;
}
刪除記錄
刪除根據(jù)名字查找到的那條數(shù)據(jù);注意執(zhí)行語句的關(guān)鍵詞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;
}
修改記錄
修改根據(jù)名字查找到的那條數(shù)據(jù);注意執(zhí)行語句的關(guān)鍵詞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;
}
查詢記錄
查詢到的結(jié)果是放在一個FMResultSet（結(jié)果集）中的，遍歷這個結(jié)果集垄提，將相關(guān)數(shù)據(jù)添加到Person對象中榔袋，最后以數(shù)組的方式返回周拐。
根據(jù)名字查詢數(shù)據(jù);注意執(zhí)行語句的關(guān)鍵詞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;
}
根據(jù)性別查詢數(shù)據(jù)
+ (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;
}
查詢表中的所有數(shù)據(jù)；并根據(jù)添加的時間先后順序排序
+ (NSArray *)getAllPersonFromDataBase
{
//根據(jù)時間先后順序排序
//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;
}
到這里凰兑，我們基本的方法都已經(jīng)寫完了妥粟，接下來就剩下來調(diào)用了。搭建個簡易的UI界面測試一個下
FMDB的測試
搭建一個Input界面：
添加數(shù)據(jù)的調(diào)用方法：
BOOL ret = [person insertToDataBase];
//這樣也可以
//BOOL ret = [person saveToDataBase];
if (ret) {
NSLog(@"插入數(shù)據(jù) 到數(shù)據(jù)庫成功");
} else {
NSLog(@"插入數(shù)據(jù) 到數(shù)據(jù)庫失敗");
}
搭建一個修改信息的界面：
修改數(shù)據(jù)的調(diào)用方法：
if ([person updateToDataBaseWithName:self.lastName]) {
NSLog(@"更新數(shù)據(jù) 到數(shù)據(jù)庫成功");
}
else
{
NSLog(@"更新數(shù)據(jù) 到數(shù)據(jù)庫失敗");
}
將TableViewCell向左滑可以刪除信息：
刪除數(shù)據(jù)的調(diào)用方法：
//刪除數(shù)據(jù)庫數(shù)據(jù)
[XYJPerson deleteFromDataBaseByName:person.name];
查詢所有數(shù)據(jù)的調(diào)用方法
//從數(shù)據(jù)庫中取出所有的用戶
NSArray * allPerson = [XYJPerson getAllPersonFromDataBase ];
一個根據(jù)性別查詢信息的界面：
根據(jù)性別查找數(shù)據(jù)庫的調(diào)用方法
array = [XYJPerson getPersonFromDataBasewithSex:@"女"];
一個根據(jù)名字查詢信息的界面：
根據(jù)名字查找數(shù)據(jù)庫的調(diào)用方法
array = [XYJPerson getPersonFromDataBasewithName:@"要查詢的名字"];
FMDB的使用(線程不是安全的)
這個暫未更新吏够，后續(xù)會補上的...
后記
完整Demo下載地址在這里勾给！
下載完整 https://github.com/muhlenXi/DatabaseDemo一起交流學(xué)習(xí)，記得給star支持博主的努力哦锅知！
