最新針對(duì) FMDatabaseQueue封裝 如果你需要多線(xiàn)程處理數(shù)據(jù)庫(kù)铃岔,用這個(gè)就輕松處理
一、FMDB簡(jiǎn)單介紹
FMDB是OC的方式封裝了SQLite的C語(yǔ)言API门岔,并且它對(duì)于多線(xiàn)程的并發(fā)操作進(jìn)行了處理爱致,所以是線(xiàn)程安全的;相對(duì)系統(tǒng)提供的CoreData寒随,輕量好多糠悯,使用起來(lái)也很方便帮坚,除查詢(xún)以外的所有操作,都稱(chēng)為“更新”互艾,這里就不詳細(xì)介紹了试和,不是本文的主題
二、為什么要再封裝纫普?
1阅悍、隔離網(wǎng)絡(luò)第三方框架,方便修改維護(hù)
2昨稼、雖然FMDB已經(jīng)封裝了SQLite节视,但依然需要寫(xiě)SQL語(yǔ)句,對(duì)于模型中屬性比較多的話(huà)假栓,拼接SQL語(yǔ)句將變得十分繁瑣寻行;而且對(duì)于字符串、字典匾荆、數(shù)組數(shù)據(jù)是沒(méi)辦法直接存入數(shù)據(jù)庫(kù)拌蜘,需要特殊處理。
因此封裝面向模型牙丽,只需要傳入對(duì)應(yīng)的模型信息就能進(jìn)行數(shù)據(jù)庫(kù)操作简卧,不需要寫(xiě)任何SQL語(yǔ)句,屏蔽內(nèi)部所有操作剩岳,插入什么模型贞滨,就取出什么模型,簡(jiǎn)單易用拍棕!同時(shí)為了保證傳入的都是模型數(shù)據(jù)晓铆,添加了異常提示,對(duì)傳入的模型做了限制绰播,必須是NSObject或者NSObject的子類(lèi),同時(shí)不響應(yīng)事件
- 3骄噪、FMDB中操作執(zhí)行異常只會(huì)打印出來(lái)(例如沒(méi)有對(duì)應(yīng)表的時(shí)候的操作),如果項(xiàng)目中打印信息比較多的話(huà)蠢箩,不容易察覺(jué)链蕊。
因此操作異常時(shí)添加斷言,準(zhǔn)確定位操作異常位置以及異常情況
- 4谬泌、對(duì)數(shù)據(jù)庫(kù)操作后需要關(guān)閉數(shù)據(jù)庫(kù)滔韵,此時(shí)增加了代碼量,而且容易忘記掌实,內(nèi)存沒(méi)辦法及時(shí)釋放陪蜻。
因此將關(guān)閉數(shù)據(jù)庫(kù)操作封裝在框架中,此時(shí)調(diào)用不需要關(guān)心數(shù)據(jù)庫(kù)的關(guān)閉
- 5贱鼻、面向模型開(kāi)發(fā)宴卖,操作模型滋将,更加面向?qū)ο螅郧耙话阌脭?shù)據(jù)庫(kù)的時(shí)候一般都是直接保存后臺(tái)返回的數(shù)據(jù)症昏,此時(shí)每次取出來(lái)都要轉(zhuǎn)一次模型随闽,麻煩
三、API介紹(增刪改查)
單例模式肝谭,項(xiàng)目中唯一掘宪,方便管理,傳入數(shù)據(jù)庫(kù)名稱(chēng)分苇,后續(xù)操作不同的數(shù)據(jù)庫(kù)
/**
* @author Clarence
*
* 單例創(chuàng)建添诉,項(xiàng)目唯一
*/
+ (instancetype)shareManager:(NSString *)fl_dbName;
創(chuàng)表,外界傳入指定的類(lèi)医寿,工具會(huì)根據(jù)類(lèi)來(lái)創(chuàng)建表,如果此時(shí)表已經(jīng)存在蘑斧,則跳過(guò)靖秩,沒(méi)有才去創(chuàng)建,執(zhí)行完這個(gè)操作后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)竖瘾,釋放內(nèi)存
#pragma mark -- 創(chuàng)表
/**
* @author Clarence
*
* 根據(jù)類(lèi)名創(chuàng)建表沟突,如果有則跳過(guò),沒(méi)有才創(chuàng)建捕传,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示創(chuàng)建表格操作執(zhí)行成功 或者 表格已經(jīng)存在惠拭,NO則失敗
*/
- (BOOL)fl_createTable:(Class)modelClass;
插入數(shù)據(jù),可以傳入單個(gè)模型庸论,或者傳入模型數(shù)組职辅,此時(shí)內(nèi)部處理了,遍歷數(shù)組插入的期間數(shù)據(jù)庫(kù)不會(huì)關(guān)閉聂示,直到所有插入完畢后才關(guān)閉數(shù)據(jù)庫(kù)域携;同時(shí),如果傳入的模型的FLDBID在對(duì)應(yīng)表中已經(jīng)存在鱼喉,則執(zhí)行更新操作秀鞭,保證FLDBID對(duì)應(yīng)數(shù)據(jù)的唯一性
#pragma mark -- 插入
/**
* @author Clarence
*
* @param model 插入單個(gè)模型或者模型數(shù)組,如果此時(shí)傳入的模型對(duì)應(yīng)的FLDBID在表中已經(jīng)存在,則替換更新舊的
* 如果沒(méi)創(chuàng)建表就自動(dòng)先創(chuàng)建扛禽,表名為模型類(lèi)名
* 此時(shí)執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示創(chuàng)建表格操作執(zhí)行成功 或者 表格已經(jīng)存在锋边,NO則失敗
*/
- (BOOL)fl_insertModel:(id)model;
查詢(xún) 提供三個(gè)方法
- 查詢(xún)表是否存在,執(zhí)行完畢就會(huì)自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)编曼,由于此方法存在豆巨,框架工具中會(huì)出現(xiàn)錯(cuò)誤提示信息,因?yàn)槿绻麤](méi)有對(duì)應(yīng)表灵巧,執(zhí)行操作語(yǔ)句FMDB就會(huì)打印出錯(cuò)誤信息
- 查找指定表中指定FLDBID的單個(gè)模型數(shù)據(jù)搀矫,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)抹沪,如果沒(méi)有對(duì)應(yīng)表,會(huì)有斷言
- 查找指定表中模型數(shù)組(所有的)瓤球,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)融欧,如果沒(méi)有對(duì)應(yīng)表,會(huì)有斷言
#pragma mark -- 查詢(xún)
/**
* @author Clarence
*
* 查詢(xún)指定表是否存在卦羡,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示操作執(zhí)行成功并且 modelClass 表格存在噪馏,NO則操作失敗或者 modelClass 表格不存在
*/
- (BOOL)fl_isExitTable:(Class)modelClass;
/**
* @author Clarence
*
* 查找指定表中指定DBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return 不等于nil绿饵,表示查詢(xún)數(shù)據(jù)操作執(zhí)行成功并有數(shù)據(jù)欠肾,返回查詢(xún)成功的模型數(shù)據(jù),nil則表示查詢(xún)操作失敗 或者 查詢(xún)成功但數(shù)據(jù)為空 或者 對(duì)應(yīng)的表格不存在
*/
- (id)fl_searchModel:(Class)modelClass byID:(NSString *)FLDBID;
/**
* @author Clarence
*
* 查找指定表中模型數(shù)組(所有的)拟赊,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return 不等于nil刺桃,表示查詢(xún)數(shù)據(jù)操作執(zhí)行成功并有數(shù)據(jù),返回查詢(xún)成功的模型數(shù)據(jù)吸祟,nil則表示查詢(xún)操作失敗 或者 查詢(xún)成功但數(shù)據(jù)為空 或者 對(duì)應(yīng)的表格不存在
*/
- (NSArray *)fl_searchModelArr:(Class)modelClass;
修改 根據(jù)指定FLDBID瑟慈,將新傳入的模型替換舊的模型數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)屋匕,如果沒(méi)有對(duì)應(yīng)表葛碧,會(huì)有斷言
#pragma mark -- 修改
/**
* @author Clarence
*
* 修改指定DBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示更新操作執(zhí)行成功过吻,NO則操作失敗 或者 對(duì)應(yīng)的表格不存在
*/
- (BOOL)fl_modifyModel:(id)model byID:(NSString *)FLDBID;
刪除进泼,此時(shí)也提供了三個(gè)方法
- 刪除指定表,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)纤虽,如果沒(méi)有對(duì)應(yīng)表乳绕,會(huì)有斷言
- 刪除指定表格的所有數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)廓推,如果沒(méi)有對(duì)應(yīng)表刷袍,會(huì)有斷言
- 刪除指定表中指定FLDBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)樊展,如果沒(méi)有對(duì)應(yīng)表呻纹,會(huì)有斷言
- 刪除數(shù)據(jù)庫(kù)
#pragma mark -- 刪除
/**
* @author Clarence
*
* 刪除指定表,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示刪除操作執(zhí)行成功专缠,NO則操作失敗 或者 對(duì)應(yīng)的表格不存在
*/
- (BOOL)fl_dropTable:(Class)modelClass;
/**
* @author Clarence
*
* 刪除指定表格的所有數(shù)據(jù)雷酪,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示刪除操作執(zhí)行成功,NO則操作失敗 或者 對(duì)應(yīng)的表格不存在 或者 沒(méi)有對(duì)應(yīng)數(shù)據(jù)可以刪除
*/
- (BOOL)fl_deleteAllModel:(Class)modelClass;
/**
* @author Clarence
*
* 刪除指定表中指定DBID的模型涝婉,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫(kù)
* @return YES表示刪除操作執(zhí)行成功哥力,NO則操作失敗 或者 對(duì)應(yīng)的表格不存在 或者 沒(méi)有對(duì)應(yīng)數(shù)據(jù)可以刪除
*/
- (BOOL)fl_deleteModel:(Class)modelClass byId:(NSString *)FLDBID;
/**
* @author gitKong
*
* 刪除數(shù)據(jù)庫(kù)
* @return 操作不涉及到數(shù)據(jù)庫(kù)操作 YES 表示刪除成功,NO則刪除失敗
*/
- (BOOL)fl_dropDB;
四、調(diào)用以及效果圖(只舉部分例子吩跋,詳細(xì)請(qǐng)移步gitHub笆焰,有完整的Demo介紹)
-
增
[FLFMDBMANAGER fl_insertModel:arrM];
-
刪
[FLFMDBMANAGER fl_deleteModel:[FLStudentModel class] byId:model.FLDBID]
-
改
[[FLFMDBManager shareManager] fl_modifyModel:model byID:model.FLDBID]
-
查
[FLFMDBMANAGER fl_searchModel:[FLStudentModel class] byID:textField.text]
五咒精、使用注意點(diǎn)
單例模式八堡,因此只能創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)扑浸,對(duì)于聊天賬號(hào)的數(shù)據(jù)存儲(chǔ)就可能不適用;最新已支持多數(shù)據(jù),前往更新
內(nèi)部暫時(shí)使用FMDatabase這個(gè)類(lèi)梁丘,線(xiàn)程不安全的侵浸,如果在多個(gè)線(xiàn)程中同時(shí)使用一個(gè)FMDatabase實(shí)例,會(huì)造成數(shù)據(jù)混亂等問(wèn)題氛谜,后續(xù)會(huì)新增FMDatabaseQueue處理掏觉,線(xiàn)程安全;已新增針對(duì) FMDatabaseQueue封裝
-
需要在模型中添加一個(gè)屬性FLDBID,NSString類(lèi)型值漫,為了綁定對(duì)應(yīng)的數(shù)據(jù)澳腹,從而進(jìn)行增刪改查操作
需要插入數(shù)據(jù)庫(kù)的模型不支持繼承,因?yàn)楦鶕?jù)類(lèi)名來(lái)創(chuàng)建表惭嚣,框架內(nèi)部只能讀取當(dāng)前類(lèi)的屬性遵湖,其父類(lèi)的屬性沒(méi)辦法獲取
修改數(shù)據(jù)庫(kù)中的模型數(shù)據(jù)只能通過(guò)指定的FLDBID作為條件修改
暫時(shí)不支持模型屬性動(dòng)態(tài)刪減,如果刪了對(duì)應(yīng)屬性(除了FLDBID)不影響使用晚吞,但如果增加屬性了,只能從新建表存儲(chǔ)
嵌套模型暫時(shí)不支持單表處理谋国,需要?jiǎng)?chuàng)建多張表處理
六槽地、小總結(jié)
-
為了方便大家使用,提供了兩個(gè)宏芦瘾,創(chuàng)建數(shù)據(jù)庫(kù)管理實(shí)例捌蚊,其中如果是使用
FLFMDBQUEUEMANAGER
,就是使用默認(rèn)的數(shù)據(jù)庫(kù)近弟,文件為gitkong.sqlite
缅糟,使用FLFMDBQUEUEMANAGERX
傳入名稱(chēng),就會(huì)創(chuàng)建文件為“名稱(chēng)”.sqlite
的數(shù)據(jù)庫(kù)來(lái)使用#define FLDB_DEFAULT_NAME @"gitkong"
define FLFMDBMANAGER [FLFMDBManager shareManager:FLDB_DEFAULT_NAME]
define FLFMDBMANAGERX(DB_NAME) [FLFMDBManager shareManager:DB_NAME]
- *技術(shù)上實(shí)現(xiàn)并沒(méi)多難祷愉,使用runtime就很容易獲取當(dāng)前模型類(lèi)中的屬性窗宦,關(guān)鍵還是處理一系列邏輯,代碼比較簡(jiǎn)單二鳄,這里就不詳細(xì)講解了赴涵,Demo中有相對(duì)應(yīng)的注釋 !*
- *每個(gè)人都有自己的編程想法和愛(ài)好订讼,有人喜歡面向字典開(kāi)發(fā)髓窜、有人喜歡面向模型開(kāi)發(fā),我就喜歡面向模型封裝,屏蔽內(nèi)部處理邏輯寄纵,調(diào)用只需要一句代碼鳖敷,享受封裝的過(guò)程~*
- *最后,還是那句程拭,如果你有什么問(wèn)題或者建議定踱,盡管留言,歡迎大家關(guān)注我哺壶,喜歡就給個(gè)like 和 star屋吨,隨時(shí)更新!謝謝支持山宾!*
- ##[gitHub地址](https://github.com/gitkong/FLFMDBManager)至扰,歡迎star