WHC_ModelSqliteKit

項(xiàng)目介紹:https://github.com/netyouli/WHC_ModelSqliteKit


簡介

目標(biāo): 替代直接使用Sqlite和CoreData

架構(gòu): 采用runtime技術(shù)和Sqlite Api完美結(jié)合打造

易用: 告別繁瑣sql語句的編寫和CoreData復(fù)雜創(chuàng)建

支持: (NSData,NSString,Int,double,float,Bool,char,NSNumber)類型

強(qiáng)大: 支持模型嵌套模型類存儲到數(shù)據(jù)庫和多表嵌套聯(lián)查

智能: 根據(jù)數(shù)據(jù)庫模型類提供的VERSION方法返回的版本號來智能更新數(shù)據(jù)庫字段(動態(tài)刪除/添加)


要求


iOS 5.0 or later

Xcode 8.0 or later


集成


使用CocoaPods:

pod 'WHC_ModelSqlite', '~> 1.1.4'

手工集成:

導(dǎo)入文件夾WHC_ModelSqliteKit


用法


1.存儲嵌套模型對象到數(shù)據(jù)庫演示

Person * whc = [Person new];

whc.name = @"吳海超";

whc.age = 25;

whc.height = 180.0;

whc.weight = 140.0;

whc.isDeveloper = YES;

whc.sex = 'm';

// 嵌套car對象

whc.car = [Car new];

whc.car.name = @"撼路者";

whc.car.brand = @"大路虎";

// 嵌套school對象

whc.school = [School new];

whc.school.name = @"北京大學(xué)";

whc.school.personCount = 5000;

// school對象嵌套city對象

whc.school.city = [City new];

whc.school.city.name = @"北京";

whc.school.city.personCount = 1000;

[WHC_ModelSqlite insert:whc];

2.存儲批量模型對象到數(shù)據(jù)庫演示

NSArray * persons = [self makeArrayPerson];

[WHC_ModelSqlite insertArray:persons];

3.無條件查詢數(shù)據(jù)庫中模型類演示

NSArray * personArray = [WHC_ModelSqlite query:[Person class] where:nil];

4.條件查詢數(shù)據(jù)庫中模型類演示(where 條件查詢語法和sql where條件查詢語法一樣)

NSArray * personArray = [WHC_ModelSqlite query:[Person class] where:@"name = '吳海超2' OR age <= 18"];

5.查詢數(shù)據(jù)庫并對結(jié)果排序

///對person數(shù)據(jù)表查詢并且根據(jù)age自動降序或者升序排序

[WHC_ModelSqlite query:[Person class] order:@"by age desc/asc"];

6.查詢數(shù)據(jù)庫并對結(jié)果限制查詢條數(shù)

/// 對person數(shù)據(jù)表查詢并且并且限制查詢數(shù)量為8

[WHC_ModelSqlite query:[Person class] limit:@"8"];

/// 對person數(shù)據(jù)表查詢并且對查詢列表偏移8并且限制查詢數(shù)量為8

[WHC_ModelSqlite query:[Person class] limit:@"8 offset 8"];

7.修改數(shù)據(jù)庫中模型對象演示(where 條件查詢語法和sql where條件查詢語法一樣)

[WHC_ModelSqlite update:whc where:@"name = '吳海超2' OR age <= 18"];

8.刪除數(shù)據(jù)庫中模型對象演示(where條件查詢?yōu)榭談t刪除所有)

[WHC_ModelSqlite delete:[Person class] where:@"age = 25 AND name = '吳海超'"];

9.清空指定數(shù)據(jù)庫演示

[WHC_ModelSqlite clear:[Person class]];

10.刪除數(shù)據(jù)庫演示

[WHC_ModelSqlite removeModel:[Person class]];

11.刪除所有數(shù)據(jù)庫演示

[WHC_ModelSqlite removeAllModel];

12.獲取數(shù)據(jù)庫本地路徑演示

NSString * path = [WHC_ModelSqlite localPathWithModel:[Person class]];

13.獲取數(shù)據(jù)庫本地版本號演示

NSString * path = [WHC_ModelSqlite versionWithModel:[Person class]];


注意

當(dāng)模型類有新增/刪除屬性的時(shí)候需要在模型類里定義類方法(+ (NSString*)VERSION)修改模型類(數(shù)據(jù)庫)版本號來表明有字段更新操作隧出,庫會根據(jù)這個(gè)VERSION變更智能檢查并自動更新數(shù)據(jù)庫字段,無需手動更新數(shù)據(jù)庫字段


Api文檔

/**

* 說明: 存儲模型數(shù)組到本地(事務(wù)方式)

* @param model_array 模型數(shù)組對象(model_array 里對象類型要一致)

*/

+ (void)insertArray:(NSArray *)model_array;

/**

* 說明: 存儲模型到本地

* @param model_object 模型對象

*/

+ (void)insert:(id)model_object;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣阀捅,where為空則查詢所有)

* @return 查詢模型對象數(shù)組

*/

+ (NSArray *)query:(Class)model_class where:(NSString *)where;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param order 排序條件(排序語法和SQL order 查詢語法一樣胀瞪,order為空則不排序)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] order:@"by age desc/asc"];

/// 對person數(shù)據(jù)表查詢并且根據(jù)age自動降序或者升序排序

+ (NSArray *)query:(Class)model_class order:(NSString *)order;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param limit 限制條件(限制語法和SQL limit 查詢語法一樣,limit為空則不限制查詢)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] limit:@"8"];

/// 對person數(shù)據(jù)表查詢并且并且限制查詢數(shù)量為8

/// ?example: [WHC_ModelSqlite query:[Person class] limit:@"8 offset 8"];

/// 對person數(shù)據(jù)表查詢并且對查詢列表偏移8并且限制查詢數(shù)量為8

+ (NSArray *)query:(Class)model_class limit:(NSString *)limit;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣饲鄙,where為空則查詢所有)

* @param order 排序條件(排序語法和SQL order 查詢語法一樣凄诞,order為空則不排序)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] where:@"age < 30" order:@"by age desc/asc"];

/// 對person數(shù)據(jù)表查詢age小于30歲并且根據(jù)age自動降序或者升序排序

+ (NSArray *)query:(Class)model_class where:(NSString *)where order:(NSString *)order;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣,where為空則查詢所有)

* @param limit 限制條件(限制語法和SQL limit 查詢語法一樣傍妒,limit為空則不限制查詢)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] where:@"age <= 30" limit:@"8"];

/// 對person數(shù)據(jù)表查詢age小于30歲并且限制查詢數(shù)量為8

/// ?example: [WHC_ModelSqlite query:[Person class] where:@"age <= 30" limit:@"8 offset 8"];

/// 對person數(shù)據(jù)表查詢age小于30歲并且對查詢列表偏移8并且限制查詢數(shù)量為8

+ (NSArray *)query:(Class)model_class where:(NSString *)where limit:(NSString *)limit;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param order 排序條件(排序語法和SQL order 查詢語法一樣幔摸,order為空則不排序)

* @param limit 限制條件(限制語法和SQL limit 查詢語法一樣,limit為空則不限制查詢)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] order:@"by age desc/asc" limit:@"8"];

/// 對person數(shù)據(jù)表查詢并且根據(jù)age自動降序或者升序排序并且限制查詢的數(shù)量為8

/// ?example: [WHC_ModelSqlite query:[Person class] order:@"by age desc/asc" limit:@"8 offset 8"];

/// 對person數(shù)據(jù)表查詢并且根據(jù)age自動降序或者升序排序并且限制查詢的數(shù)量為8偏移為8

+ (NSArray *)query:(Class)model_class order:(NSString *)order limit:(NSString *)limit;

/**

* 說明: 查詢本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣颤练,where為空則查詢所有)

* @param order 排序條件(排序語法和SQL order 查詢語法一樣既忆,order為空則不排序)

* @param limit 限制條件(限制語法和SQL limit 查詢語法一樣,limit為空則不限制查詢)

* @return 查詢模型對象數(shù)組

*/

/// ?example: [WHC_ModelSqlite query:[Person class] where:@"age <= 30" order:@"by age desc/asc" limit:@"8"];

/// 對person數(shù)據(jù)表查詢age小于30歲并且根據(jù)age自動降序或者升序排序并且限制查詢的數(shù)量為8

/// ?example: [WHC_ModelSqlite query:[Person class] where:@"age <= 30" order:@"by age desc/asc" limit:@"8 offset 8"];

/// 對person數(shù)據(jù)表查詢age小于30歲并且根據(jù)age自動降序或者升序排序并且限制查詢的數(shù)量為8偏移為8

+ (NSArray *)query:(Class)model_class where:(NSString *)where order:(NSString *)order limit:(NSString *)limit;

/**

* 說明: 更新本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣嗦玖,where為空則更新所有)

*/

+ (void)update:(id)model_object where:(NSString *)where;

/**

* 說明: 清空本地模型對象

* @param model_class 模型類

*/

+ (void)clear:(Class)model_class;

/**

* 說明: 刪除本地模型對象

* @param model_class 模型類

* @param where 查詢條件(查詢語法和SQL where 查詢語法一樣患雇,where為空則刪除所有)

*/

+ (void)delete:(Class)model_class where:(NSString *)where;

/**

* 說明: 清空所有本地模型數(shù)據(jù)庫

*/

+ (void)removeAllModel;

/**

* 說明: 清空指定本地模型數(shù)據(jù)庫

* @param model_class 模型類

*/

+ (void)removeModel:(Class)model_class;

/**

* 說明: 返回本地模型數(shù)據(jù)庫路徑

* @param model_class 模型類

* @return 路徑

*/

+ (NSString *)localPathWithModel:(Class)model_class;

/**

* 說明: 返回本地模型數(shù)據(jù)庫版本號

* @param model_class 模型類

* @return 版本號

*/

+ (NSString *)versionWithModel:(Class)model_class;

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市宇挫,隨后出現(xiàn)的幾起案子苛吱,更是在濱河造成了極大的恐慌,老刑警劉巖器瘪,帶你破解...
    沈念sama閱讀 221,695評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件翠储,死亡現(xiàn)場離奇詭異,居然都是意外死亡橡疼,警方通過查閱死者的電腦和手機(jī)援所,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,569評論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來欣除,“玉大人住拭,你說我怎么就攤上這事±悖” “怎么了滔岳?”我有些...
    開封第一講書人閱讀 168,130評論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長挽牢。 經(jīng)常有香客問我谱煤,道長,這世上最難降的妖魔是什么卓研? 我笑而不...
    開封第一講書人閱讀 59,648評論 1 297
  • 正文 為了忘掉前任趴俘,我火速辦了婚禮睹簇,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘寥闪。我一直安慰自己太惠,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,655評論 6 397
  • 文/花漫 我一把揭開白布疲憋。 她就那樣靜靜地躺著凿渊,像睡著了一般。 火紅的嫁衣襯著肌膚如雪缚柳。 梳的紋絲不亂的頭發(fā)上埃脏,一...
    開封第一講書人閱讀 52,268評論 1 309
  • 那天,我揣著相機(jī)與錄音秋忙,去河邊找鬼彩掐。 笑死,一個(gè)胖子當(dāng)著我的面吹牛灰追,可吹牛的內(nèi)容都是我干的堵幽。 我是一名探鬼主播,決...
    沈念sama閱讀 40,835評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼弹澎,長吁一口氣:“原來是場噩夢啊……” “哼朴下!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起苦蒿,我...
    開封第一講書人閱讀 39,740評論 0 276
  • 序言:老撾萬榮一對情侶失蹤殴胧,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后佩迟,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體团滥,經(jīng)...
    沈念sama閱讀 46,286評論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,375評論 3 340
  • 正文 我和宋清朗相戀三年报强,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了惫撰。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,505評論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡躺涝,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出扼雏,到底是詐尸還是另有隱情坚嗜,我是刑警寧澤,帶...
    沈念sama閱讀 36,185評論 5 350
  • 正文 年R本政府宣布诗充,位于F島的核電站苍蔬,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏蝴蜓。R本人自食惡果不足惜碟绑,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,873評論 3 333
  • 文/蒙蒙 一俺猿、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧格仲,春花似錦押袍、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,357評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至侮东,卻和暖如春圈盔,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背悄雅。 一陣腳步聲響...
    開封第一講書人閱讀 33,466評論 1 272
  • 我被黑心中介騙來泰國打工驱敲, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人宽闲。 一個(gè)月前我還...
    沈念sama閱讀 48,921評論 3 376
  • 正文 我出身青樓众眨,卻偏偏與公主長得像,于是被迫代替她去往敵國和親便锨。 傳聞我的和親對象是個(gè)殘疾皇子围辙,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,515評論 2 359

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

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn)放案,斷路器姚建,智...
    卡卡羅2017閱讀 134,701評論 18 139
  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法,類相關(guān)的語法吱殉,內(nèi)部類的語法掸冤,繼承相關(guān)的語法,異常的語法友雳,線程的語...
    子非魚_t_閱讀 31,663評論 18 399
  • 一. Java基礎(chǔ)部分.................................................
    wy_sure閱讀 3,814評論 0 11
  • 原文:https://my.oschina.net/liuyuantao/blog/751438 查詢集API 參...
    陽光小鎮(zhèn)少爺閱讀 3,827評論 0 8
  • 在Android項(xiàng)目中遇到一個(gè)問題稿湿,需求是需要獲取瀏覽器分享出來的內(nèi)容中的URL。 正常情況下分享出來的URL信息...
    一個(gè)脫離高級趣味的人閱讀 10,634評論 2 6