FMDB 二次封裝忙厌,面向模型

最新針對(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]
FMDB封裝效果.gif

五咒精、使用注意點(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
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市资锰,隨后出現(xiàn)的幾起案子敢课,更是在濱河造成了極大的恐慌,老刑警劉巖绷杜,帶你破解...
    沈念sama閱讀 206,378評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件直秆,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡鞭盟,警方通過(guò)查閱死者的電腦和手機(jī)圾结,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,356評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)齿诉,“玉大人筝野,你說(shuō)我怎么就攤上這事≡辆纾” “怎么了歇竟?”我有些...
    開(kāi)封第一講書(shū)人閱讀 152,702評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀(guān)的道長(zhǎng)抵恋。 經(jīng)常有香客問(wèn)我焕议,道長(zhǎng),這世上最難降的妖魔是什么弧关? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,259評(píng)論 1 279
  • 正文 為了忘掉前任盅安,我火速辦了婚禮,結(jié)果婚禮上梯醒,老公的妹妹穿的比我還像新娘宽堆。我一直安慰自己,他們只是感情好茸习,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,263評(píng)論 5 371
  • 文/花漫 我一把揭開(kāi)白布畜隶。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪籽慢。 梳的紋絲不亂的頭發(fā)上浸遗,一...
    開(kāi)封第一講書(shū)人閱讀 49,036評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音箱亿,去河邊找鬼跛锌。 笑死,一個(gè)胖子當(dāng)著我的面吹牛届惋,可吹牛的內(nèi)容都是我干的髓帽。 我是一名探鬼主播,決...
    沈念sama閱讀 38,349評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼脑豹,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼郑藏!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起瘩欺,我...
    開(kāi)封第一講書(shū)人閱讀 36,979評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤必盖,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后俱饿,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體歌粥,經(jīng)...
    沈念sama閱讀 43,469評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,938評(píng)論 2 323
  • 正文 我和宋清朗相戀三年拍埠,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了失驶。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,059評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡枣购,死狀恐怖突勇,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情坷虑,我是刑警寧澤,帶...
    沈念sama閱讀 33,703評(píng)論 4 323
  • 正文 年R本政府宣布埂奈,位于F島的核電站迄损,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏芹敌。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,257評(píng)論 3 307
  • 文/蒙蒙 一垮抗、第九天 我趴在偏房一處隱蔽的房頂上張望氏捞。 院中可真熱鬧,春花似錦捆等、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,262評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)篇亭。三九已至,卻和暖如春锄贷,著一層夾襖步出監(jiān)牢的瞬間谊却,已是汗流浹背柔昼。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留炎辨,地道東北人捕透。 一個(gè)月前我還...
    沈念sama閱讀 45,501評(píng)論 2 354
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像碴萧,于是被迫代替她去往敵國(guó)和親乙嘀。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,792評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容