WHC_ModelSqliteKit

项目介绍：https://github.com/netyouli/WHC_ModelSqliteKit

简介

目标: 替代直接使用Sqlite和CoreData

架构: 采用runtime技术和Sqlite Api完美结合打造

易用: 告别繁琐sql语句的编写和CoreData复杂创建

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

强大: 支持模型嵌套模型类存储到数据库和多表嵌套联查

智能: 根据数据库模型类提供的VERSION方法返回的版本号来智能更新数据库字段(动态删除/添加)

要求

iOS 5.0 or later

Xcode 8.0 or later

集成

使用CocoaPods:

pod 'WHC_ModelSqlite', '~> 1.1.4'

手工集成:

导入文件夹WHC_ModelSqliteKit

用法

1.存储嵌套模型对象到数据库演示

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 = @"北京大学";

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.存储批量模型对象到数据库演示

NSArray * persons = [self makeArrayPerson];

[WHC_ModelSqlite insertArray:persons];

3.无条件查询数据库中模型类演示

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

4.条件查询数据库中模型类演示(where 条件查询语法和sql where条件查询语法一样)

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

5.查询数据库并对结果排序

///对person数据表查询并且根据age自动降序或者升序排序

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

6.查询数据库并对结果限制查询条数

/// 对person数据表查询并且并且限制查询数量为8

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

/// 对person数据表查询并且对查询列表偏移8并且限制查询数量为8

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

7.修改数据库中模型对象演示(where 条件查询语法和sql where条件查询语法一样)

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

8.删除数据库中模型对象演示(where条件查询为空则删除所有)

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

9.清空指定数据库演示

[WHC_ModelSqlite clear:[Person class]];

10.删除数据库演示

[WHC_ModelSqlite removeModel:[Person class]];

11.删除所有数据库演示

[WHC_ModelSqlite removeAllModel];

12.获取数据库本地路径演示

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

13.获取数据库本地版本号演示

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

注意

当模型类有新增/删除属性的时候需要在模型类里定义类方法(+ (NSString*)VERSION)修改模型类(数据库)版本号来表明有字段更新操作，库会根据这个VERSION变更智能检查并自动更新数据库字段，无需手动更新数据库字段

Api文档

/**

* 说明: 存储模型数组到本地(事务方式)

* @param model_array 模型数组对象(model_array 里对象类型要一致)

*/

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

/**

* 说明: 存储模型到本地

* @param model_object 模型对象

*/

+ (void)insert:(id)model_object;

/**

* 说明: 查询本地模型对象

* @param model_class 模型类

* @param where 查询条件(查询语法和SQL where 查询语法一样，where为空则查询所有)

* @return 查询模型对象数组

*/

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

/**

* 说明: 查询本地模型对象

* @param model_class 模型类

* @param order 排序条件(排序语法和SQL order 查询语法一样，order为空则不排序)

* @return 查询模型对象数组

*/

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

/// 对person数据表查询并且根据age自动降序或者升序排序

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

/**

* 说明: 查询本地模型对象

* @param model_class 模型类

* @param limit 限制条件(限制语法和SQL limit 查询语法一样，limit为空则不限制查询)

* @return 查询模型对象数组

*/

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

/// 对person数据表查询并且并且限制查询数量为8

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

/// 对person数据表查询并且对查询列表偏移8并且限制查询数量为8

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

/**

* 说明: 查询本地模型对象

* @param model_class 模型类

* @param where 查询条件(查询语法和SQL where 查询语法一样，where为空则查询所有)

* @param order 排序条件(排序语法和SQL order 查询语法一样，order为空则不排序)

* @return 查询模型对象数组

*/

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

/// 对person数据表查询age小于30岁并且根据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 查询模型对象数组

*/

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

/// 对person数据表查询age小于30岁并且限制查询数量为8

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

/// 对person数据表查询age小于30岁并且对查询列表偏移8并且限制查询数量为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 查询模型对象数组

*/

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

/// 对person数据表查询并且根据age自动降序或者升序排序并且限制查询的数量为8

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

/// 对person数据表查询并且根据age自动降序或者升序排序并且限制查询的数量为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 查询模型对象数组

*/

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

/// 对person数据表查询age小于30岁并且根据age自动降序或者升序排序并且限制查询的数量为8

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

/// 对person数据表查询age小于30岁并且根据age自动降序或者升序排序并且限制查询的数量为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;

/**

* 说明: 清空所有本地模型数据库

*/

+ (void)removeAllModel;

/**

* 说明: 清空指定本地模型数据库

* @param model_class 模型类

*/

+ (void)removeModel:(Class)model_class;

/**

* 说明: 返回本地模型数据库路径

* @param model_class 模型类

* @return 路径

*/

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

/**

* 说明: 返回本地模型数据库版本号

* @param model_class 模型类

* @return 版本号

*/

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

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,530评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 86,403评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,120评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,770评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,758评论 5赞 367
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,649评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,021评论 3赞 398
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,675评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,931评论 1赞 299
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1赞 330
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,410评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,004评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2赞 350
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2赞 343

推荐阅读更多精彩内容

  • Spring Cloud
    Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具（例如配置管理，服务发现，断路器，智...
    卡卡罗2017阅读 134,594评论 18赞 139
  • Java初级面试题
    1. Java基础部分 基础部分的顺序：基本语法，类相关的语法，内部类的语法，继承相关的语法，异常的语法，线程的语...
    子非鱼_t_阅读 31,567评论 18赞 399
  • Java面试
    一. Java基础部分.................................................
    wy_sure阅读 3,788评论 0赞 11
  • Django查询集 API
    原文：https://my.oschina.net/liuyuantao/blog/751438 查询集API 参...
    阳光小镇少爷阅读 3,809评论 0赞 8
  • Android利用正则表达式如何匹配URL
    在Android项目中遇到一个问题，需求是需要获取浏览器分享出来的内容中的URL。 正常情况下分享出来的URL信息...
    一个脱离高级趣味的人阅读 10,606评论 2赞 6