最新針對 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]
五、使用注意點(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