JSON和对象之间的转换是个很基础的功能,YYModel非常好地完成了这个工作,和同类的库相比,它无论从易用性和性能上都有很突出的优点。详见作者的评测:http://blog.ibireme.com/2015/10/23/ios_model_framework_benchmark/。我前后看了不下3遍,最近因为要给同事分享,又认真看了一遍,还是有不小的收获。看完,我依旧写不出这样的代码。所以很佩服90后的作者的代码功底,实在是我的榜样,也让我这个80后十分惭愧。
学习源代码的最好方式就是去使用和改写它,我修复其中的两个bug,并用单元测试捕获这个bug。已经提交了,希望能合并到作者的代码里:)
基本用法
从JSON字符串到对象的转换会经过以下的过程,NSString<—>NSData<—>NSDictionary<—>Model。 其中NSData<—>NSDictionary由系统提供的NSJSONSerialization类完成,这个类只允许NSString,NSNumber,NSArray,NSDictionary, orNSNull.这几种对象和NSDictionary的转换。YYModel作为NSObject的分类上述转换的功能。
1)YYModel的接口
@interfaceNSObject (YYModel)
+ (nullableinstancetype)yy_modelWithJSON:(id)json;
+ (nullableinstancetype)yy_modelWithDictionary:(NSDictionary*)dictionary;
- (BOOL)yy_modelSetWithJSON:(id)json;
- (BOOL)yy_modelSetWithDictionary:(NSDictionary*)dic;
- (nullableid)yy_modelToJSONObject;
- (nullableNSData*)yy_modelToJSONData;
- (nullableNSString*)yy_modelToJSONString;
提供了一些辅助的方法
- (nullableid)yy_modelCopy;
- (void)yy_modelEncodeWithCoder:(NSCoder*)aCoder;
- (id)yy_modelInitWithCoder:(NSCoder*)aDecoder;
- (NSUInteger)yy_modelHash;
- (BOOL)yy_modelIsEqual:(id)model;
- (NSString*)yy_modelDescription;
2)通过YYModel协议提供定制功能。
@protocolYYModel
@optional
+ (nullableNSDictionary *)modelCustomPropertyMapper;
+ (nullableNSDictionary *)modelContainerPropertyGenericClass;
+ (nullableClass)modelCustomClassForDictionary:(NSDictionary*)dictionary;
+ (nullableNSArray *)modelPropertyBlacklist;
+ (nullableNSArray *)modelPropertyWhitelist;
- (NSDictionary*)modelCustomWillTransformFromDictionary:(NSDictionary*)dic;
- (BOOL)modelCustomTransformFromDictionary:(NSDictionary*)dic;
- (BOOL)modelCustomTransformToDictionary:(NSMutableDictionary*)dic;
3)类型自动转换(容错性)
参加作者的评测文章:http://blog.ibireme.com/2015/10/23/ios_model_framework_benchmark/
源码分析
原理非常简单,利用Objective-C运行时,获取属性的类型信息,使用NSDictionary为相应的属性赋值。但是涉及到的细节比较多,类型主要有以下几个。
1)类型信息类。 ClassInfo, 如何获取属性信息。YYClassIvarInfo,YYClassMethodInfo,YYClassPropertyInfo,YYClassInfo
2)定制的信息类。_YYModelPropertyMeta,_YYModelMeta
3)主要的几个方法。
ModelSetValueForProperty (设置model单个属性的值)
yy_modelSetWithDictionary (用字典设置model的值)
ModelToJSONObjectRecursive (转化为字典)
单元测试
单元测试的意义在于验证代码在哪些场景下是正确的。如果发现了缺陷,通过添加单元测试来捕获缺陷,并修复缺陷,这样能保证以后再修改代码时,不会引入曾经引入的问题。
性能评测以及性能优化
作者提到优化的几个Tips,都是很底层的优化,这也是为什么YYModel的性能能得到保证。在应用层,一般不需要这些优化手段,因为代码的可读性和可维护性是更重要的。但是对于底层,性能要求应该要很苛刻。
里面用到CACurrentMediaTime函数获取当前时间,我查了文档,还是不知道这个值具体的含义,(文档说,相对于2001年1月1日的值)
typedefdoubleCFTimeInterval;
typedefCFTimeInterval CFAbsoluteTime;
/* absolute time is the time interval since the reference date */
/* the reference date (epoch) is 00:00:00 1 January 2001. */
但是我获取的描述明显不是这个值,重启电脑之后,这个值似乎从0从新开始计算。
评测方法虽然简单,但是要用心去做!
选择YYModel的原因
1)代码实现简洁。包括头文件就5个文件,.m文件,总共不到2500行的代码。
2)容错性高。支持NSString,NSDate,NSNumber等类型的自动转换。避免崩溃。
3)性能高。
4)非侵入性。
因为OC单继承的原因,使用基于NSObject类来实现JSON转化的功能会更灵活一些。