又一个高性能轻量级的iOS模型框架YYModel

最新推荐文章于 2024-08-12 08:59:49 发布
最新推荐文章于 2024-08-12 08:59:49 发布
阅读量92 收藏
点赞数
原文链接：https://my.oschina.net/u/2394328/blog/649205
版权

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

前言

iOS的模型框架其实有很多了，去年研究过Mantle，也了解过JSONModel、MJExtension，最近的项目项目优化的时候，再次考虑，基于轻量级、高性能的考虑，最终选择了YYModel。

项目主页

YYModel

简介

YYModel在Github的简介是， iOS/OSX平台下一个高性能的模型框架。下面这张图片展示了原作者的性能比较：

29144613_YD2g.jpg

特色功能

  • 高性能：转换效率接近手写代码。

  • 自动类型转换：对象类型能自动转换。

  • 类型安全：在转换过程中所有的类型都会被验证，以确保类型安全。

  • 非侵入性：不需要让模型类继承自基类。

  • 轻量级：整个库只包含5个文件。

  • 文档和测试覆盖：100%文档覆盖，99.6代码覆盖。

使用方法

简单的 Model 与 JSON 相互转换

// JSON:{    "uid":123456,    "name":"Harry",    "created":"1965-07-31T00:00:00+0000"}// Model:@interface User : NSObject@property UInt64 uid;@property NSString *name;@property NSDate *created;@end@implementation User@end// 将 JSON (NSData,NSString,NSDictionary) 转换为 Model:User *user = [User yy_modelWithJSON:json];// 将 Model 转换为 JSON 对象:NSDictionary *json = [user yy_modelToJSONObject];

当 JSON/Dictionary 中的对象类型与 Model 属性不一致时，YYModel 将会进行如下自动转换。自动转换不支持的值将会被忽略，以避免各种潜在的崩溃问题。

JSON/DictionaryModel
NSStringNSNumber,NSURL,SEL,Class
NSNumberNSString
NSString/NSNumber基础类型 (BOOL,int,float,NSUInteger,UInt64,…)
NaN 和 Inf 会被忽略
NSStringNSDate 以下列格式解析: yyy-MM-dd
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd’T’HH:mm:ss
yyyy-MM-dd’T’HH:mm:ssZ
EEE MMM dd HH:mm:ss Z yyyy
NSDateNSString 格式化为 ISO8601:
“YYYY-MM-dd’T’HH:mm:ssZ”
NSValuestruct (CGRect,CGSize,…)
NSNullnil,0
“no”,“false”,…@(NO),0
“yes”,“true”,…@(YES),1

Model 属性名和 JSON 中的 Key 不相同

// JSON:{    "n":"Harry Pottery",    "p": 256,    "ext" : {        "desc" : "A book written by J.K.Rowing."
    },    "ID" : 100010}// Model:@interface Book : NSObject@property NSString *name;@property NSInteger page;@property NSString *desc;@property NSString *bookID;@end@implementation Book//返回一个 Dict，将 Model 属性名对映射到 JSON 的 Key。+ (NSDictionary *)modelCustomPropertyMapper {    return @{@"name" : @"n",             @"page" : @"p",             @"desc" : @"ext.desc",             @"bookID" : @[@"id",@"ID",@"book_id"]};
}@end

你可以把一个或一组 json key (key path) 映射到一个或多个属性。如果一个属性没有映射关系，那默认会使用相同属性名作为映射。

在 json->model 的过程中：如果一个属性对应了多个 json key，那么转换过程会按顺序查找，并使用第一个不为空的值。

在 model->json 的过程中：如果一个属性对应了多个 json key (key path)，那么转换过程仅会处理第一个 json key (key path)；如果多个属性对应了同一个 json key，则转换过过程会使用其中任意一个不为空的值。

Model 包含其他 Model

// JSON{    "author":{        "name":"J.K.Rowling",        "birthday":"1965-07-31T00:00:00+0000"
    },    "name":"Harry Potter",    "pages":256}// Model: 什么都不用做，转换会自动完成@interface Author : NSObject@property NSString *name;@property NSDate *birthday;@end@implementation Author@end@interface Book : NSObject@property NSString *name;@property NSUInteger pages;@property Author *author; //Book 包含 Author 属性@end@implementation Book@end

容器类属性

@class Shadow, Border, Attachment;@interface Attributes@property NSString *name;@property NSArray *shadows; //Array<Shadow>@property NSSet *borders; //Set<Border>@property NSMutableDictionary *attachments; //Dict<NSString,Attachment>@end@implementation Attributes// 返回容器类中的所需要存放的数据类型 (以 Class 或 Class Name 的形式)。+ (NSDictionary *)modelContainerPropertyGenericClass {    return @{@"shadows" : [Shadow class],             @"borders" : Border.class,             @"attachments" : @"Attachment" };
}@end

黑名单与白名单

@interface User@property NSString *name;@property NSUInteger age;@end@implementation Attributes// 如果实现了该方法，则处理过程中会忽略该列表内的所有属性+ (NSArray *)modelPropertyBlacklist {    return @[@"test1", @"test2"];
}// 如果实现了该方法，则处理过程中不会处理该列表外的属性。+ (NSArray *)modelPropertyWhitelist {    return @[@"name"];
}@end

数据校验与自定义转换

// JSON:{    "name":"Harry",    "timestamp" : 1445534567}// Model:@interface User@property NSString *name;@property NSDate *createdAt;@end@implementation User// 当 JSON 转为 Model 完成后，该方法会被调用。// 你可以在这里对数据进行校验，如果校验不通过，可以返回 NO，则该 Model 会被忽略。// 你也可以在这里做一些自动转换不能完成的工作。- (BOOL)modelCustomTransformFromDictionary:(NSDictionary *)dic {    NSNumber *timestamp = dic[@"timestamp"];    if (![timestamp isKindOfClass:[NSNumber class]]) return NO;
    _createdAt = [NSDate dateWithTimeIntervalSince1970:timestamp.floatValue];    return YES;
}// 当 Model 转为 JSON 完成后，该方法会被调用。// 你可以在这里对数据进行校验，如果校验不通过，可以返回 NO，则该 Model 会被忽略。// 你也可以在这里做一些自动转换不能完成的工作。- (BOOL)modelCustomTransformToDictionary:(NSMutableDictionary *)dic {    if (!_createdAt) return NO;
    dic[@"timestamp"] = @(n.timeIntervalSince1970);    return YES;
}@end

Coding/Copying/hash/equal/description

@interface YYShadow :NSObject <NSCoding, NSCopying>@property (nonatomic, copy) NSString *name;@property (nonatomic, assign) CGSize size;@end@implementation YYShadow// 直接添加以下代码即可自动完成- (void)encodeWithCoder:(NSCoder *)aCoder { [self yy_modelEncodeWithCoder:aCoder]; }
- (id)initWithCoder:(NSCoder *)aDecoder { self = [super init]; return [self yy_modelInitWithCoder:aDecoder]; }
- (id)copyWithZone:(NSZone *)zone { return [self yy_modelCopy]; }
- (NSUInteger)hash { return [self yy_modelHash]; }
- (BOOL)isEqual:(id)object { return [self yy_modelIsEqual:object]; }
- (NSString *)description { return [self yy_modelDescription]; }@end

安装

CocoaPods

  1. 在 Podfile 中添加 pod 'YYModel'。

  2. 执行 pod install 或 pod update。

  3. 导入 <YYModel/YYModel.h>。

Carthage

  1. 在 Cartfile 中添加 github "ibireme/YYModel"。

  2. 执行 carthage update --platform ios 并将生成的 framework 添加到你的工程。

  3. 导入 <YYModel/YYModel.h>。

手动安装

  1. 下载 YYModel 文件夹内的所有内容。

  2. 将 YYModel 内的源文件添加(拖放)到你的工程。

  3. 导入 YYModel.h。

系统要求

该项目最低支持 iOS 6.0 和 Xcode 7.0。

实例

Model定义

  Stock.h//  YifaDemo  Created by 唐有炜 on 16/3/29.//  Copyright (c) 2015年 Yifa Network. All rights reserved.//#import <Foundation/Foundation.h>@interface Stock : NSObject/**
 *  交易所
 */@property (nonatomic,copy) NSString *stockMarket;/**
 * 股票代码
 */@property (nonatomic,copy) NSString *stockCode;/**
 *  机构信息
 */@property (nonatomic,copy) NSString *stockOrg;@end
  Stock.m//  YifaDemo  Created by 唐有炜 on 16/3/29.//  Copyright (c) 2015年 Yifa Network. All rights reserved.//#import "Stock.h"#import <YYModel/YYModel.h>@implementation Stock#pragma mark - Model 属性名和 JSON 中的 Key 不相同//返回一个 Dict，将 Model 属性名对映射到 JSON 的 Key。+ (NSDictionary *)modelCustomPropertyMapper {    return @{@"stockOrg" : @"prod_name"};
}#pragma mark - Model 包含其他 Model// Model: 什么都不用做，转换会自动完成#pragma mark - 容器类属性//@property NSArray *shadows; //Array<Shadow>//@property NSSet *borders; //Set<Border> 返回容器类中的所需要存放的数据类型 (以 Class 或 Class Name 的形式)。//+ (NSDictionary *)modelContainerPropertyGenericClass {//       return @{@"shadows" : [Shadow class],//                @"borders" : Border.class};//}#pragma mark - 黑名单与白名单 如果实现了该方法，则处理过程中会忽略该列表内的所有属性//+ (NSArray *)modelPropertyBlacklist {//    return @[@"test1", @"test2"];//} 如果实现了该方法，则处理过程中不会处理该列表外的属性。//+ (NSArray *)modelPropertyWhitelist {//    return @[@"test3"];//}#pragma mark - 数据校验与自定义转换// 当 JSON 转为 Model 完成后，该方法会被调用。// 你可以在这里对数据进行校验，如果校验不通过，可以返回 NO，则该 Model 会被忽略。// 你也可以在这里做一些自动转换不能完成的工作。- (BOOL)modelCustomTransformFromDictionary:(NSDictionary *)dic {
    _stockMarket = [dic[@"prod_code"] componentsSeparatedByString:@"."][1];
    _stockCode = [dic[@"prod_code"] componentsSeparatedByString:@"."][0];    return YES;
} 当 Model 转为 JSON 完成后，该方法会被调用。 你可以在这里对数据进行校验，如果校验不通过，可以返回 NO，则该 Model 会被忽略。 你也可以在这里做一些自动转换不能完成的工作。//- (BOOL)modelCustomTransformToDictionary:(NSMutableDictionary *)dic {//    return YES;//}#pragma mark - Coding/Copying/hash/equal 直接添加以下代码即可自动完成//- (void)encodeWithCoder:(NSCoder *)aCoder { [self yy_modelEncodeWithCoder:aCoder]; }//- (id)initWithCoder:(NSCoder *)aDecoder { self = [super init]; return [self yy_modelInitWithCoder:aDecoder]; }//- (id)copyWithZone:(NSZone *)zone { return [self yy_modelCopy]; }//- (NSUInteger)hash { return [self yy_modelHash]; }//- (BOOL)isEqual:(id)object { return [self yy_modelIsEqual:object]; }@end

使用

1、引用#import <YYModel/YYModel.h>

2、JSON转Model

    Stock *stock = [Stock yy_modelWithJSON:json];
    
    Stock *stock = [Stock yy_modelWithDictionary:item];

3、 将 Model 转换为 JSON 对象:

    NSDictionary *dic = [stock yy_modelToJSONObject];    NSString *json = [stock yy_modelToJSONString];    NSData *data = [stock yy_modelToJSONData];

参考

iOS JSON 模型转换库评测

YYKit系列之——YYModel使用

转载请注明：特维博客 » 又一个高性能轻量级的iOS模型框架YYModel

http://cxy.liuzhihengseo.com/499.html

问啊APP，程序员答题神器，解决你所有的技术难题，   (上问啊APP 了解更多) http://t.cn/R4vE2d7 下载注册送5元 快去下载注册吧！ 

问啊-定制化IT教育平台，牛人一对一服务，有问必答，开发编程社交头条 官方网站：www.wenaaa.com 下载问啊APP，参与官方悬赏，赚百元现金。

QQ群290551701 聚集很多互联网精英，技术总监，架构师，项目经理！开源技术研究，欢迎业内人士，大牛及新手有志于从事IT行业人员进入！


转载于:https://my.oschina.net/u/2394328/blog/649205

weixin_34265814
关注
JCDB:基于FMDB和SQLite的轻量级iOS数据库框架
05-19
基于和轻量级iOS数据库框架。 特征 该框架支持在ARC中开发iOS 7.0+。 数据库表CREATE / DROP / ALERT。 数据库使用SELECT记录查询。 数据库记录INSERT / REPLACE / UPDATE / DELETE。 创建并关闭数据库 [...
IOS YYModel
煮酒Shae
08-16 1109
文章目录YYModel介绍YYModel的安装YYModel中的常用方法举例准备工作代码 YYModel介绍 YYModel是iOS/OSX平台下一个高性能的模型转换框架，和同类的其他框架相比，其无论从易用性和性能上都有很突出的优点。 YYModel在github上的仓库地址是：https://github.com/ibireme/YYModel，我们可以从中获取最新的版本以及相关信息。 YYMo...
探索MJExtension：高效便捷的JSON与模型转换框架
gitblog_00130的博客
08-12 397
探索MJExtension：高效便捷的JSON与模型转换框架 MJExtensionA fast, convenient and nonintrusive conversion framework between JSON and model. Your model class doesn't need to extend any base class. You don't need to mo...
YYModel的简介与使用
MikeJune的博客
12-21 7537
关于YYModel的性能，一张图带你看懂 特性: 高性能: 模型转换性能接近手写解析代码。 自动类型转换: 对象类型可以自动转换，详情见下方表格。 类型安全: 转换过程中，所有的数据类型都会被检测一遍，以保证类型安全，避免崩溃问题。 无侵入性: 模型无需继承自其他基类。 轻量: 该框架只有 5 个文件 (包括.h文件)。 文档和单元测试: 文档覆盖率100%, 代码覆
YYModel的深入理解
小马哥好棒哦
03-09 2008
文件结构 ​ 相信使用过MJExtensions的iOS开发者来说，接触YYModel并不是很陌生，因为两者在某些思路上是相似的，例如都用了category的方式来实现，Protocol中的方法都有着相似的功能，例如黑白名单、Property名称和dictionary中key中的对应关系等。YYModel的文件包括： YYModel.h YYClassInfo.h、YYClassInfo....
一个轻量级框架
04-05
作者OldChicken，源码LCCSqliteManager，这是一个轻量级框架，可以让使用的人脱离Sql语句进行数据库的管理。概述:一个封装了sqlite的轻量级框架。目前提供了建表（可以带主键和外键约束），查询表字段，获取表数据，...
swift-NoChat一个轻量级的iOS聊天UI框架
08-15
总之，NoChat是一个专为iOS设计的轻量级聊天UI框架，它简化了聊天界面的开发过程，提供了丰富的自定义选项，支持Swift语言，兼顾性能与用户体验。对于那些希望快速构建聊天功能的开发者来说，NoChat无疑是一个值得...
茜：轻量级本地iOS MVVM框架
02-05
茜 Akane是一个iOS框架，可通过采用MVVM设计模式帮助您构建更好的本机应用程序。 如果想查看框架的实际用例，请转到我们的。 注意：当前版本（0.30）是beta。 如果您需要最新稳定版本（0.20.0）的文档，请。 主要...
swift-DLLLayout是一个基于UIView.frame的轻量级iOS布局框架
08-14
Swift-DLLLayout是一款专为iOS开发者设计的轻量级布局框架，它主要依赖于UIView的frame属性来实现界面元素的布局。在iOS开发中，尤其是面对复杂界面时，使用AutoLayout或者SnapKit等布局库虽然功能强大，但可能会...
关于在swift中怎么使用MJExtension
allanGold
01-06 2922
1. 对于模型中还有其他模型类属性的情况：只要在属性的冒号之后把对应的模型类写上即可 2. 对于属性中有id为名的属性，在该模型的类实现以下代码 overridestaticfunc mj_replacedKeyFromPropertyName() -> [AnyHashable :Any]? {         return ["ID" :"id"]     }
iOS YYModel使用方法
ihoudf
04-24 6708
文档地址：https://github.com/ibireme/YYModel NSDictionary *testDic = @{@"groupId":@"01", @"result":@[ @{@"name":@"Lucy", @"
iOS开发 ☞ YY_Model
Magic-ZYJ的博客
04-15 735
首先来看一下这个效率近乎是手动完成字典与模型之间转换的轻量级框架——YY_Model github下载地址：https://github.com/ibireme/YYModel性能特性 高性能: 模型转换性能接近手写解析代码。 自动类型转换: 对象类型可以自动转换，详情见下方表格。 类型安全: 转换过程中，所有的数据类型都会被检测一遍，以保证类型安全，避免崩溃问题。 无侵入性: 模型无需继
基于MNIST数据集的分类器设计_MNIST_Classifier.zip
10-01
基于MNIST数据集的分类器设计_MNIST_Classifier
基于springboot项目,集成常用第三方整合的一个框架,包含通用mapper实现百分之
10-01
基于springboot项目,集成常用第三方整合的一个框架,包含通用mapper实现百分之八九十的s_myspringboot
一些经典机器学习算法的Matlab实现_MachineLearing_Matlab.zip
10-01
一些经典机器学习算法的Matlab实现_MachineLearing_Matlab
蜂鸣声音简谱播放器fmjpbfq.zip
10-01
蜂鸣声音简谱播放器fmjpbfq
电商-拼团倒计时.zip
最新发布
10-01
我们的小程序源码功能多样，涵盖社交、电商等领域。高度定制化，轻松打造专属风格。用户体验佳，界面美观操作便捷。安全可靠，保障数据与运行稳定。适合创业者、企业和开发者。提供技术支持与文档说明。快来下载，开启精彩之旅！
iOS高级组件与框架详解：探索iOSSDK的深度特性
通过阅读这本书，开发者不仅可以学习如何利用内置的iOS组件和框架，还能掌握如何扩展和自定义这些组件以满足特定需求，以及如何有效地集成第三方框架，确保应用程序的稳定性和性能。书中会深入探讨框架的工作原理、...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值