[iOS] Json反序列化的几种方式 - KVC / JSONModel / Mantle / MJExtension / YYModel

节前鹏鹏让我看json反序列化为model，主要是很多场景都是从网络拿到json，然后要转成数据model，自己写的话就很费事儿，但讲真节前一天完全没心情写代码0.0 于是假期来补吧~

主要的几种方式为：KVC、Mantle、MJExtension、JSONModel、YYmodel。

以下为示例json文件~

// sample.json文件
{
    "name": "ying", 
    "age": "25", 
    "school": {
        "name": "SJTU", 
        "location": "Shanghai"
    }
}

1. KVC

setValuesForKeysWithDictionary可以直接通过dictionary把key-value设置给object，key只要和property名字一样就可以啦~

下面是model类：

#import <Foundation/Foundation.h>

#import "JsonSchool.h"

NS_ASSUME_NONNULL_BEGIN

@interface JsonPersion : NSObject

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *age;
@property (nonatomic, strong) JsonSchool *school;

@end

NS_ASSUME_NONNULL_END

=======================

#import "JsonPersion.h"

@implementation JsonPersion

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, age:%@, school:%@", self.name, self.age, self.school] ;
}

@end

=======================

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface JsonSchool : NSObject

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *location;

@end

NS_ASSUME_NONNULL_END

=======================

#import "JsonSchool.h"

@implementation JsonSchool

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, location:%@", self.name, self.location] ;
}

@end

解析的时只要：

#import "JsonParserViewController.h"
#import "JsonPersion.h"

@interface JsonParserViewController ()

@end

@implementation JsonParserViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    NSDictionary *dict = [self readLocalFileWithName:@"sample"];
    JsonPersion *p1 = [[JsonPersion alloc] init];
    [p1 setValuesForKeysWithDictionary:dict];
    NSLog(@"p1: %@", p1);
}

- (NSDictionary *)readLocalFileWithName:(NSString *)name
{
    NSString *path = [[NSBundle mainBundle] pathForResource:name ofType:@"json"];
    NSData *data = [[NSData alloc] initWithContentsOfFile:path];
    
    return [NSJSONSerialization JSONObjectWithData:data
                                           options:kNilOptions
                                             error:nil];
}

@end

输出就是酱紫的：

2020-01-25 14:24:02.915340+0800 Example1[4737:869487] p1: name:ying, age:25, school:{
    location = Shanghai;
    name = SJTU;
}

注意key和property必须一一对应，或者key比property少，如果dict里面的key不是property会crash的吼，而且key的名字必须和property的一致，因为其实setValuesForKeysWithDictionary就是依次调用setValueForKeyPath吧~

2. Mantle

git: https://github.com/Mantle/Mantle (使用的时候pod即可)

Mantle可以轻松把JSON数据、字典（Dictionary）和模型（即Objective对象）之间的相互转换，支持自定义映射，并且内置实现了NSCoding和NSCoping，大大简化归档操作。

对于mantle而言最重要的就是实现JSONKeyPathsByPropertyKey，以及千万记得任何一个model类都要继承MTLModel <MTLJSONSerializing>：

#import <Foundation/Foundation.h>
#import <Mantle/Mantle.h>

NS_ASSUME_NONNULL_BEGIN

@interface JsonSchoolMantle : MTLModel <MTLJSONSerializing>

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *location;

@end

@interface JsonPersonMantle : MTLModel <MTLJSONSerializing>

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *age;
@property (nonatomic, strong) JsonSchoolMantle *school;

@end

NS_ASSUME_NONNULL_END

=====================

#import "JsonPersonMantle.h"

@implementation JsonSchoolMantle

+ (NSDictionary *)JSONKeyPathsByPropertyKey {
    return @{
        @"name" : @"name",
        @"location" : @"location"
    };
}

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, location:%@", self.name, self.location] ;
}

@end

@implementation JsonPersonMantle

+ (NSDictionary *)JSONKeyPathsByPropertyKey { 
    return @{
        @"name":@"name",
        @"age":@"age",
        @"school":@"school"
    };
}

+ (NSValueTransformer *)schoolJSONTransformer {
    return [MTLJSONAdapter dictionaryTransformerWithModelClass:[JsonSchoolMantle class]];
}

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, age:%@, school:%@", self.name, self.age, self.school] ;
}

@end

使用的时候只要：

NSDictionary *dict = [self readLocalFileWithName:@"sample"];
JsonPersonMantle *p1 = [MTLJSONAdapter modelOfClass:[JsonPersonMantle class] fromJSONDictionary:dict error:nil];
NSLog(@"p1: %@", p1);

输出：
2020-01-26 09:35:13.154737+0800 Example1[6023:1175811] p1: name:ying, age:25, school:name:SJTU, location:shanghai

注意使用的时候属性名JSONTransformer其实就是一个转换器，因为有的时候属性是NSDate这种，但是json里面就是一个string，需要转换成相应的属性类型。本例里面的school也是，由于是一个嵌套结构，school也是一个小json，所以它也需要从一个小json转换成一个model，也需要一个transformer。

由于JSONKeyPathsByPropertyKey可以自定义属性以及json中字段的对应关系，所以Mantle比KVC好的一点就是可以property和json字段不一定必须名字一致哈。

3. JSONModel

git: https://github.com/jsonmodel/jsonmodel

JSONModel和KVC类似，它也不需要.m文件里面干点儿啥，只要一句话就能搞成model。但是model类需要继承JSONModel哦~

#import <Foundation/Foundation.h>
@import JSONModel;

NS_ASSUME_NONNULL_BEGIN

@interface JsonSchoolModel : JSONModel

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *location;

@end

@interface JsonPersonModel : JSONModel

@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *age;
@property (nonatomic, strong) JsonSchoolModel *school;

@end

NS_ASSUME_NONNULL_END

====================

#import "JsonPersonModel.h"

@implementation JsonSchoolModel

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, location:%@", self.name, self.location] ;
}

@end

@implementation JsonPersonModel

- (NSString *)description {
    return [NSString stringWithFormat:@"name:%@, age:%@, school:%@", self.name, self.age, self.school] ;
}

@end

使用的时候：

NSDictionary *dict = [self readLocalFileWithName:@"sample"];
JsonPersonModel *p1 = [[JsonPersonModel alloc] initWithDictionary:dict error:NULL];
NSLog(@"p1: %@", p1);

输出：
2020-01-26 09:59:06.664587+0800 Example1[6093:1188064] p1: name:ying, age:25, school:name:SJTU, location:shanghai
  • 如果key和property名字不一样呢？

可以使用keyMapper来定义如何map，例如下面的官方例子就是把property名orderId对应到json里面的order_id，自动在中间加一个下划线来对应：

{
    "order_id": 104,
    "order_product": "Product #1",
    "order_price": 12.95
}
@interface OrderModel : JSONModel
@property (nonatomic) NSInteger orderId;
@property (nonatomic) NSString *orderProduct;
@property (nonatomic) float orderPrice;
@end

@implementation OrderModel

+ (JSONKeyMapper *)keyMapper
{
    return [JSONKeyMapper mapperForSnakeCase];
}

@end

4. MJExtension

git：https://github.com/CoderMJLee/MJExtension

MJExtension作为网评最好的一款converter，它和JSONModel类似，无需.m文件支持，甚至你的model类都不需要继承JSONModel，只要用正常的model，然后convert的时候用mj_objectWithKeyValues即可。

所以举例里面的model用KVC里面即可，转换用以下代码：

#import <MJExtension/MJExtension.h>

NSDictionary *dict = [self readLocalFileWithName:@"sample"];
JsonPersion *p1 = [JsonPersion mj_objectWithKeyValues:dict];
NSLog(@"p1: %@", p1);

输出：
2020-01-26 12:02:49.662849+0800 Example1[6285:1246846] p1: name:ying, age:25, school:name:SJTU, location:shanghai

如果key和property名字不一致，例如将name属性名改成name2：

NSDictionary *dict = [self readLocalFileWithName:@"sample"];
[JsonPersion mj_setupReplacedKeyFromPropertyName:^NSDictionary *{
    return @{@"name2":@"name"};
}];
JsonPersion *p1 = [JsonPersion mj_objectWithKeyValues:dict];
NSLog(@"p1: %@", p1);

输出：
2020-01-26 12:14:30.028732+0800 Example1[6307:1251963] p1: name2:ying, age:25, school:name:SJTU, location:shanghai

如果字段是NSDate，但是json里面是string，也可以通过重写mj_newValueFromOldValue来实现转换：

- (id)mj_newValueFromOldValue:(id)oldValue property:(MJProperty *)property{
    if ([property.name isEqualToString:@"birthday"]) {
        if (oldValue) {
            // 格式化时间
            NSDateFormatter* formatter = [[NSDateFormatter alloc] init];
            formatter.timeZone = [NSTimeZone timeZoneWithName:@"shanghai"];
            [formatter setDateStyle:NSDateFormatterMediumStyle];
            [formatter setTimeStyle:NSDateFormatterShortStyle];
            [formatter setDateFormat:@"yyyy年MM月dd日 HH:mm"];
            NSDate* date = [NSDate dateWithTimeIntervalSince1970:[oldValue doubleValue]];
            NSString* dateString = [formatter stringFromDate:date];
            return dateString;
            }
        }
        else {
            return @"日期有误";
        }
    return oldValue;
}

如果json里面包含array，就是下面酱紫：

[StatusResult mj_setupObjectClassInArray:^NSDictionary *{
    return @{
               @"statuses" : @"Status",
               // @"statuses" : [Status class],
               @"ads" : @"Ad"
               // @"ads" : [Ad class]
           };
}];

5. YYModel

git: https://github.com/ibireme/YYModel

围观膜拜大神~ YY系列真的超厉害，它用起来也是不用.m干啥，直接用就行，model就用KVC里面的：

#import <NSObject+YYModel.h>

NSDictionary *dict = [self readLocalFileWithName:@"sample"];
JsonPersion *p1 = [JsonPersion modelWithDictionary:dict];
NSLog(@"p1: %@", p1);

输出：
2020-01-26 12:35:51.598271+0800 Example1[6320:1258252] p1: name:ying, age:25, school:name:SJTU, location:shanghai

注意无论是model没定义json里面的相应property，或是json里面少了property相应的key，都已可以正常编译过不会crash的哦~

YYModel还可以自动转换数据格式吼~ 例如model的property是NSDate，只要json里面的value符合date的格式就会被自动转换吼。

JSON/Dictionary Model
NSString NSNumber,NSURL,SEL,Class
NSNumber NSString
NSString/NSNumber C number (BOOL,int,float,NSUInteger,UInt64,...) NaN and Inf will be ignored
NSString NSDate parsed with these formats: yyyy-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
NSDate NSString formatted with ISO8601:"YYYY-MM-dd'T'HH:mm:ssZ"
NSValue struct (CGRect,CGSize,...)
NSNull nil,0
"no","false",... @(NO),0
"yes","true",... @(YES),1
  • 如果property和key不一致可以在model里面覆写modelCustomPropertyMapper：
// 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
+ (NSDictionary *)modelCustomPropertyMapper {
    return @{@"name" : @"n",
             @"page" : @"p",
             @"desc" : @"ext.desc",
             @"bookID" : @[@"id",@"ID",@"book_id"]};
}
@end

这里的嵌套可以用 xx.xxx的方式映射为model的一个属性吼，不用必须让嵌套的内容变成单独的model。这样的做法mantle之类的也可以哈。

YYModel也是支持array之类的，感兴趣的同学可以git看一下，它的文档也很全。

6. Comparison

image

上图是转换同样次数所花的时间，可以看出来mantle是最慢的，MJExtension一向是号称转换效率最高并且最好用的。YYModel各项指标都非常的快，用起来也很方便~

总体而言KVC不适于property和json key名称不一致，所以不太好用；mantle必须要提供key和property的对应表，并且速度较慢；JSONModel也还挺方便的，但是model需要继承JSONModel，整体性能不如MJExtension；YYModel比MJExtension要快一些。使用上讲MJExtension、YYModel其实方便程度差不多。

但具体使用哪个还是要看情景，比如mantle自动实现了NSCopying，MJExtension和YYModel并没有让原来model继承神马，所以没有对原来的model做默认的改变。但性能和方便性而言YYmodel还是很厉害的~

最后推荐一个json直接转成model.h以及.m的工具：https://www.jianshu.com/p/7c09fcbb42c3

参考:
https://www.jianshu.com/p/d07aaae459d2
性能对比：https://www.jianshu.com/p/5d50b7d9abd2
MJExtension用法：https://www.jianshu.com/p/1efa3c2ffde3

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