FMDB 二次封裝,面向模型

最新針對 FMDatabaseQueue封裝 如果你需要多線程處理數(shù)據(jù)庫,用這個(gè)就輕松處理

一、FMDB簡單介紹

FMDB是OC的方式封裝了SQLite的C語言API,并且它對于多線程的并發(fā)操作進(jìn)行了處理,所以是線程安全的;相對系統(tǒng)提供的CoreData,輕量好多,使用起來也很方便,除查詢以外的所有操作,都稱為“更新”,這里就不詳細(xì)介紹了,不是本文的主題

二、為什么要再封裝?

  • 1、隔離網(wǎng)絡(luò)第三方框架,方便修改維護(hù)

  • 2、雖然FMDB已經(jīng)封裝了SQLite,但依然需要寫SQL語句,對于模型中屬性比較多的話,拼接SQL語句將變得十分繁瑣;而且對于字符串、字典、數(shù)組數(shù)據(jù)是沒辦法直接存入數(shù)據(jù)庫,需要特殊處理。

因此封裝面向模型,只需要傳入對應(yīng)的模型信息就能進(jìn)行數(shù)據(jù)庫操作,不需要寫任何SQL語句,屏蔽內(nèi)部所有操作,插入什么模型,就取出什么模型,簡單易用!同時(shí)為了保證傳入的都是模型數(shù)據(jù),添加了異常提示,對傳入的模型做了限制,必須是NSObject或者NSObject的子類,同時(shí)不響應(yīng)事件

  • 3、FMDB中操作執(zhí)行異常只會(huì)打印出來(例如沒有對應(yīng)表的時(shí)候的操作),如果項(xiàng)目中打印信息比較多的話,不容易察覺。

因此操作異常時(shí)添加斷言,準(zhǔn)確定位操作異常位置以及異常情況

  • 4、對數(shù)據(jù)庫操作后需要關(guān)閉數(shù)據(jù)庫,此時(shí)增加了代碼量,而且容易忘記,內(nèi)存沒辦法及時(shí)釋放。

因此將關(guān)閉數(shù)據(jù)庫操作封裝在框架中,此時(shí)調(diào)用不需要關(guān)心數(shù)據(jù)庫的關(guān)閉

  • 5、面向模型開發(fā),操作模型,更加面向?qū)ο螅郧耙话阌脭?shù)據(jù)庫的時(shí)候一般都是直接保存后臺(tái)返回的數(shù)據(jù),此時(shí)每次取出來都要轉(zhuǎn)一次模型,麻煩

三、API介紹(增刪改查)

單例模式,項(xiàng)目中唯一,方便管理,傳入數(shù)據(jù)庫名稱,后續(xù)操作不同的數(shù)據(jù)庫

/**
 *  @author Clarence
 *
 *  單例創(chuàng)建,項(xiàng)目唯一
 */
+ (instancetype)shareManager:(NSString *)fl_dbName;

創(chuàng)表,外界傳入指定的類,工具會(huì)根據(jù)類來創(chuàng)建表,如果此時(shí)表已經(jīng)存在,則跳過,沒有才去創(chuàng)建,執(zhí)行完這個(gè)操作后自動(dòng)關(guān)閉數(shù)據(jù)庫,釋放內(nèi)存

#pragma mark -- 創(chuàng)表

/**
 *  @author Clarence
 *
 *  根據(jù)類名創(chuàng)建表,如果有則跳過,沒有才創(chuàng)建,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示創(chuàng)建表格操作執(zhí)行成功 或者 表格已經(jīng)存在,NO則失敗
 */
- (BOOL)fl_createTable:(Class)modelClass;

插入數(shù)據(jù),可以傳入單個(gè)模型,或者傳入模型數(shù)組,此時(shí)內(nèi)部處理了,遍歷數(shù)組插入的期間數(shù)據(jù)庫不會(huì)關(guān)閉,直到所有插入完畢后才關(guān)閉數(shù)據(jù)庫;同時(shí),如果傳入的模型的FLDBID在對應(yīng)表中已經(jīng)存在,則執(zhí)行更新操作,保證FLDBID對應(yīng)數(shù)據(jù)的唯一性

#pragma mark -- 插入

/**
 *  @author Clarence
 *
 *  @param model 插入單個(gè)模型或者模型數(shù)組,如果此時(shí)傳入的模型對應(yīng)的FLDBID在表中已經(jīng)存在,則替換更新舊的
 *  如果沒創(chuàng)建表就自動(dòng)先創(chuàng)建,表名為模型類名
 *  此時(shí)執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示創(chuàng)建表格操作執(zhí)行成功 或者 表格已經(jīng)存在,NO則失敗
 */
- (BOOL)fl_insertModel:(id)model;

查詢 提供三個(gè)方法

  • 查詢表是否存在,執(zhí)行完畢就會(huì)自動(dòng)關(guān)閉數(shù)據(jù)庫,由于此方法存在,框架工具中會(huì)出現(xiàn)錯(cuò)誤提示信息,因?yàn)槿绻麤]有對應(yīng)表,執(zhí)行操作語句FMDB就會(huì)打印出錯(cuò)誤信息
  • 查找指定表中指定FLDBID的單個(gè)模型數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言
  • 查找指定表中模型數(shù)組(所有的),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言
#pragma mark -- 查詢
/**
 *  @author Clarence
 *
 *  查詢指定表是否存在,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示操作執(zhí)行成功并且 modelClass 表格存在,NO則操作失敗或者 modelClass 表格不存在
 */
- (BOOL)fl_isExitTable:(Class)modelClass;
/**
 *  @author Clarence
 *
 *  查找指定表中指定DBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return 不等于nil,表示查詢數(shù)據(jù)操作執(zhí)行成功并有數(shù)據(jù),返回查詢成功的模型數(shù)據(jù),nil則表示查詢操作失敗 或者 查詢成功但數(shù)據(jù)為空 或者 對應(yīng)的表格不存在
 */
- (id)fl_searchModel:(Class)modelClass byID:(NSString *)FLDBID;
/**
 *  @author Clarence
 *
 *  查找指定表中模型數(shù)組(所有的),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return 不等于nil,表示查詢數(shù)據(jù)操作執(zhí)行成功并有數(shù)據(jù),返回查詢成功的模型數(shù)據(jù),nil則表示查詢操作失敗 或者 查詢成功但數(shù)據(jù)為空 或者 對應(yīng)的表格不存在
 */
- (NSArray *)fl_searchModelArr:(Class)modelClass;

修改 根據(jù)指定FLDBID,將新傳入的模型替換舊的模型數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言

#pragma mark -- 修改

/**
 *  @author Clarence
 *
 *  修改指定DBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示更新操作執(zhí)行成功,NO則操作失敗 或者 對應(yīng)的表格不存在
 */

- (BOOL)fl_modifyModel:(id)model byID:(NSString *)FLDBID;

刪除,此時(shí)也提供了三個(gè)方法

  • 刪除指定表,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言
  • 刪除指定表格的所有數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言
  • 刪除指定表中指定FLDBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫,如果沒有對應(yīng)表,會(huì)有斷言
  • 刪除數(shù)據(jù)庫
#pragma mark -- 刪除
/**
 *  @author Clarence
 *
 *  刪除指定表,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示刪除操作執(zhí)行成功,NO則操作失敗 或者 對應(yīng)的表格不存在
 */
- (BOOL)fl_dropTable:(Class)modelClass;
/**
 *  @author Clarence
 *
 *  刪除指定表格的所有數(shù)據(jù),執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示刪除操作執(zhí)行成功,NO則操作失敗 或者 對應(yīng)的表格不存在 或者 沒有對應(yīng)數(shù)據(jù)可以刪除
 */
- (BOOL)fl_deleteAllModel:(Class)modelClass;
/**
 *  @author Clarence
 *
 *  刪除指定表中指定DBID的模型,執(zhí)行完畢后自動(dòng)關(guān)閉數(shù)據(jù)庫
 
 *  @return YES表示刪除操作執(zhí)行成功,NO則操作失敗 或者 對應(yīng)的表格不存在 或者 沒有對應(yīng)數(shù)據(jù)可以刪除
 */
- (BOOL)fl_deleteModel:(Class)modelClass byId:(NSString *)FLDBID;
/**
 *  @author gitKong
 *
 *  刪除數(shù)據(jù)庫
 
 *  @return 操作不涉及到數(shù)據(jù)庫操作 YES 表示刪除成功,NO則刪除失敗
 */
- (BOOL)fl_dropDB;

四、調(diào)用以及效果圖(只舉部分例子,詳細(xì)請移步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ù)庫,對于聊天賬號的數(shù)據(jù)存儲(chǔ)就可能不適用;最新已支持多數(shù)據(jù),前往更新

  • 內(nèi)部暫時(shí)使用FMDatabase這個(gè)類,線程不安全的,如果在多個(gè)線程中同時(shí)使用一個(gè)FMDatabase實(shí)例,會(huì)造成數(shù)據(jù)混亂等問題,后續(xù)會(huì)新增FMDatabaseQueue處理,線程安全;已新增針對 FMDatabaseQueue封裝

  • 需要在模型中添加一個(gè)屬性FLDBID,NSString類型,為了綁定對應(yīng)的數(shù)據(jù),從而進(jìn)行增刪改查操作
  • 需要插入數(shù)據(jù)庫的模型不支持繼承,因?yàn)楦鶕?jù)類名來創(chuàng)建表,框架內(nèi)部只能讀取當(dāng)前類的屬性,其父類的屬性沒辦法獲取

  • 修改數(shù)據(jù)庫中的模型數(shù)據(jù)只能通過指定的FLDBID作為條件修改

  • 暫時(shí)不支持模型屬性動(dòng)態(tài)刪減,如果刪了對應(yīng)屬性(除了FLDBID)不影響使用,但如果增加屬性了,只能從新建表存儲(chǔ)

  • 嵌套模型暫時(shí)不支持單表處理,需要?jiǎng)?chuàng)建多張表處理

六、小總結(jié)

  • 為了方便大家使用,提供了兩個(gè)宏,創(chuàng)建數(shù)據(jù)庫管理實(shí)例,其中如果是使用FLFMDBQUEUEMANAGER,就是使用默認(rèn)的數(shù)據(jù)庫,文件為gitkong.sqlite,使用FLFMDBQUEUEMANAGERX 傳入名稱,就會(huì)創(chuàng)建文件為 “名稱”.sqlite 的數(shù)據(jù)庫來使用

    #define FLDB_DEFAULT_NAME @"gitkong"
    

define FLFMDBMANAGER [FLFMDBManager shareManager:FLDB_DEFAULT_NAME]

define FLFMDBMANAGERX(DB_NAME) [FLFMDBManager shareManager:DB_NAME]


- *技術(shù)上實(shí)現(xiàn)并沒多難,使用runtime就很容易獲取當(dāng)前模型類中的屬性,關(guān)鍵還是處理一系列邏輯,代碼比較簡單,這里就不詳細(xì)講解了,Demo中有相對應(yīng)的注釋 !*

- *每個(gè)人都有自己的編程想法和愛好,有人喜歡面向字典開發(fā)、有人喜歡面向模型開發(fā),我就喜歡面向模型封裝,屏蔽內(nèi)部處理邏輯,調(diào)用只需要一句代碼,享受封裝的過程~*

- *最后,還是那句,如果你有什么問題或者建議,盡管留言,歡迎大家關(guān)注我,喜歡就給個(gè)like 和 star,隨時(shí)更新!謝謝支持!*

- ##[gitHub地址](https://github.com/gitkong/FLFMDBManager),歡迎star
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,461評論 6 532
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,538評論 3 417
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,423評論 0 375
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,991評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 71,761評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,207評論 1 324
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,268評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,419評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 48,959評論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 40,782評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 42,983評論 1 369
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,528評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,222評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,653評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,901評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 51,678評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 47,978評論 2 374

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