iOS 利用Runtime写一个JSON转Model的工具

前言

好久没有写过新文章了，最近一直在忙工作的事情，我的新浪微博开源项目也停止了一周时间，目前完成了60%，就先写一篇关于JSON转Model的文章和大家聊聊天吧，为什么会写一个这个小工具呢，请看文末😄

核心方法Runtime的介绍

1. Runtime是什么？

顾名思义：Runtime就是运行时的意思，是系统在运行时的一些机制，其中最主要的就是消息机制，举个常用的例子，在面向对象编程的语言中，万物皆对象，对象如何调用方法呢，
[target excuteSEL],需要一个对象，需要一个方法名，系统在运行时会自动转换成以下的形式：
objc_msgSend(target,@selector(excuteSEL:))

关于Runtime的详细介绍，网上有很多，这里就不做过多描述了。

2.Runtime的常见用法

注:使用时需要#import <objc/objc-runtime.h>

* 1 方法替换(黑魔法)

举个例子来说明一下：
将调用A方法替换为调用B方法

class_replaceMethod([self class], @selector(sendAMessage:), (IMP)changeAtoB, NULL);

//MARK: 方法替换_1
- (void)sendAMessage:(NSString *)message {
    NSLog(@"A_message: %@",message);
}

- (void)sendBMessage:(NSString *)message {
    NSLog(@"B_Message: %@",message);
}

ViewController * changeAtoB(ViewController *SELF, SEL _cmd, NSString *message) {
   
    if ([NSStringFromSelector(_cmd) isEqualToString:@"sendAMessage:"]) {
        //将方法进行替换
        [SELF sendBMessage:message];
    }
    return SELF;
}
//这里IMP可以理解为魔法通道，将源方法通过IMP指针转换为目标方法

* 2 获取对象的属性和方法

注：获取对象的属性，这个方法在JSON转Model可以说是核心方法了
举例说明：

//class_copyPropertyList 这个方法会获取到一个类.h和.m文件中interface中的所有属性

//获取CMGCD类的属性名称
    unsigned int count;
    objc_property_t *propertyList = class_copyPropertyList([CMGCD class], &count);
    for (unsigned int i = 0; i < count; i++) {
        const char *propertyName = property_getName(propertyList[i]);
        NSLog(@"property ---> %@",[NSString stringWithUTF8String:propertyName]);
    }

//
unsigned int count;
Method *methodList = class_copyMethodList([CMGCD class], &count);
    for (unsigned int i; i < count; i++) {
        Method method = methodList[i];
        NSLog(@"Method ---> %@",NSStringFromSelector(method_getName(method)));
    }

* 2 设置对象关联

定义：关联是指把两个对象相互关联起来，使其中的一个对象作为另外一个对象的一部分
再举个例子，我在对象中定义了一个属性

@property (strong, nonatomic) NSString *content;

//设置对象属性关联
static char associatedKey;
    objc_setAssociatedObject(self, &associatedKey, @"content_yeah", OBJC_ASSOCIATION_RETAIN_NONATOMIC);
    NSString *get_content = objc_getAssociatedObject(self, &associatedKey);
    NSLog(@"content = %@",get_content);

Tips:设置对象关联需要以下几个要点：
源对象、关键字、关联的对象 关联策略
解释一下：这里我将@"content_yeah"这个对象与self使用OBJC_ASSOCIATION_RETAIN_NONATOMIC策略关联到一起，意思就是在self的生命周期之内关联的对象都不会被释放，通过这个方法，可以实现动态向类里面添加属性
另外还有一些关联的方法，如

  • 断开关联： 设置关联对象为nil即可
    objc_setAssociatedObject(self, &associatedKey, nil, OBJC_ASSOCIATION_RETAIN_NONATOMIC);

  • 断开这个对象的所有关联关系

//断开所有关联
    objc_removeAssociatedObjects(self);

JSON转Model工具的主要介绍

1. 为什么会写这样一个工具

很多时候我们并不是缺少实力，而且是缺少一种彼可取而代之的勇气，为什么会有MJExtension、YYModel的产生,查看源代码的过程中我有种想死的感觉，但是知道实现的原理后，为什么不能自己去实现一个呢？这个工具的源代码非常简单，我写这个工具的目的只是为了告诉朋友们，真的不复杂，不要因为看着复杂就放弃了自己动手的冲动

2. 工具的整体步骤简介

着重介绍一下我的思考过程

  • 1 核心方法？
    利用Runtime可以遍历出对象的所有属性，然后利用递归的思想逐层解析JSON
  • 2 怎么去做？
    基本所有的Model继承NSObject，我们可以写一个NSObject的Category，然后在其中写一些解析方法，我们需要一个对照JSON字符串的解析路径字典，比如说JSON的狗的属性名称为dog,我们的对象属性名称想定义为xiaogou，这就需要手写一个字典将解析中遇到的dog都给映射为xiaogou
  • 3 开始动手吧

3. 主要代码介绍：

* 1 NSObject+CMModel 介绍

//NSObject+CMModel.h 
// 单个对象
- (NSDictionary *)dict_CMModelWithClass;

// 对象数组
- (NSDictionary *)dict_CMModelWIthArrayClass;

- (instancetype)cm_initWithJSONString:(NSString *)jsonString;

下面着重解释一下.m文件中的内容

//NSObject+CMModel.m
#import <objc/runtime.h>
#import "CMObject.h"
#import "CMProperty.h"

//返回单个对象的解析字典，默认为nil
- ( NSDictionary * _Nullable )dict_CMModelWithClass {
    return nil;
}

//返回对象数组的解析字典，默认为nil
- (NSDictionary *)dict_CMModelWIthArrayClass {
    return nil;
}

//调用方法
- (instancetype)cm_initWithJSONString:(NSString *)jsonString {
    if (self) {
        [self analysisWitnJsonString:jsonString];
    }
    return self;
}

取得对象的所有属性及其对应的类型
Tips: 这里自己写了一个类，将对象的属性及其名称封装到一个类型为CMProperty的数组

  • 1 CMProperty类简介 
//属性名称
@property (strong, nonatomic) NSString *propertyName;

//属性的类
@property (strong, nonatomic) Class propertyClass;

//是否基本类型
@property (assign, nonatomic) BOOL isBasicType;
  • 2 获取对象属性及其类型，并且将其封装为类型为CMProperty的数组 
 //将该类的属性和对应的类型进行封装
- (NSArray <CMProperty *> *)propertyArray {
    NSMutableArray *propertyArray = [NSMutableArray array];
    
    unsigned int count;
    objc_property_t *propertyList = class_copyPropertyList([self class], &count);
    for (unsigned int i = 0; i < count; i++) {
        CMProperty *property = [[CMProperty alloc] init];
        property.propertyName = [NSString stringWithUTF8String:property_getName(propertyList[i])];
        
        NSString *attrs = @(property_getAttributes(propertyList[i]));

        NSUInteger dotLoc = [attrs rangeOfString:@","].location;
        NSString *propertyType = nil;
        NSUInteger loc = 1;
        if (dotLoc == NSNotFound) { // 没有找到
            propertyType = [attrs substringFromIndex:loc];
        }else {
            propertyType = [attrs substringWithRange:NSMakeRange(loc, dotLoc - loc)];
            if ([propertyType isEqualToString:@"Q"]) {
                //基本类型
                property.isBasicType = true;
            }else {
                propertyType = [propertyType substringWithRange:NSMakeRange(2, propertyType.length - 3)];
            }
        }

        property.propertyClass = NSClassFromString(propertyType);
    
        [propertyArray addObject:property];
    }
    
    free(propertyList);
    
    return propertyArray;
}

开始解析

//进行解析
- (void)analysisWitnJsonString:(NSString *)json {
    
    //存在解析字典
    if ([self dict_CMModelWithClass] != nil || [self dict_CMModelWIthArrayClass] != nil) {
        CMObject *analysisTools = [[CMObject alloc] initWithGoalObject:self CMPropertyArray:[self propertyArray]];
        if ([self dict_CMModelWIthArrayClass]) {
            analysisTools.analysisObjectArrayDict = [self dict_CMModelWIthArrayClass];
        }
        if ([self dict_CMModelWithClass]) {
            analysisTools.analysisDict = [self dict_CMModelWithClass];
        }
        analysisTools.jsonString = json;
    }
}

* 2 CMObject 介绍

这个类为实际进行解析工具的类，或者可以称之为工具,这里我们需要特殊对待NSArray、NSDictionary、int、float等基本类型

//CMObject.h

//要解析的对象
@property (strong, nonatomic) id object;

//解析key对应列表 单个对象
@property (strong, nonatomic) NSDictionary *analysisDict;

//解析key对应列表 对象数组
@property (strong, nonatomic) NSDictionary *analysisObjectArrayDict;

//属性列表
@property (strong, nonatomic) NSArray <CMProperty *> *propertyArray;

//init方法
- (instancetype)initWithGoalObject:(id)object CMPropertyArray:(NSArray <CMProperty *> *)propertyArray;

//解析的源JSON
@property (strong, nonatomic) NSString *jsonString;


BOOL Exist_(id obj,NSArray *existArray);

Tips: 下面代码可能看着会不舒服，我说一下整体的思路

* 1 NSObject+CMModel中将封装的属性数组传递过来，我们一个接一个的对属性进行遍历构造

* 2 遍历详解：举例，碰到NSArray的属性时，我们去看要解析的类中实现的- (NSDictionary *)dict_CMModelWIthArrayClass这个方法，找到目的对象的类型OBJClass，然后将JSON字典拆分后利用- (instancetype)cm_initWithJSONString:(NSString *)jsonString这个方法创建一个OBJClass类型的对象，并且添加到数组中，创建完后，使用KVC将数组赋给源对象，具体代码看下面

//CMObject.m
//这里说一下解析方法, 代码较多
//开始进行model解析
- (void)analysisModel {
    NSDictionary *jsonDict = [NSJSONSerialization JSONObjectWithData:[_jsonString dataUsingEncoding:NSUTF8StringEncoding] options:NSJSONReadingAllowFragments error:nil];

    //将`NSObject+CMModel`中获取的属性数组进行遍历构造，并赋值给对应的属性
    [_propertyArray enumerateObjectsUsingBlock:^(CMProperty * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        //单独处理数组类型
        if (obj.propertyClass == [NSArray class]) {
            //  对象为数组类型，
            NSString *key = [_analysisObjectArrayDict objectForKey:obj.propertyName];

            Class OBJClass = NSClassFromString(key);
        
            if (![jsonDict objectForKey:key]) {
                //名称与json中的名称并不相符
                if ([_analysisDict objectForKey:obj.propertyName]) {
                    NSMutableArray *objectArray = [NSMutableArray array];
                    
                    NSArray *obj_json_array = [jsonDict objectForKey:[_analysisDict objectForKey:obj.propertyName]];
                    [obj_json_array enumerateObjectsUsingBlock:^(NSDictionary   * _Nonnull obj_dict, NSUInteger idx, BOOL * _Nonnull stop) {
                        id objx = [[OBJClass alloc] cm_initWithJSONString:DataToJSONString(obj_dict)];
                        //解析好对象之后，存到数据中
                        [objectArray addObject:objx];
                        
                    }];
                    [_object setValue:objectArray forKey:obj.propertyName];
                }else {
                    
                }
            }
        }else if (Exist_(obj.propertyClass, @[[NSDictionary class],[NSMutableDictionary class]])) {
            NSDictionary *obj_dict = [jsonDict valueForKey:[_analysisDict objectForKey:obj.propertyName]];
            if (!obj_dict) {
                [_object setValue:[NSNull null] forKey:obj.propertyName];
            }else {
                [_object setValue:obj_dict forKey:obj.propertyName];
            }
        }else if (obj.isBasicType){
            //基本类型
            id num = [jsonDict valueForKey:[_analysisDict objectForKey:obj.propertyName]];
            if (!num || num == [NSNull null]) {
                //为空判断
                //这里我们默认设置为 0.00大小的NSNumber对象 
                [_object setValue:NULL_NUM forKey:obj.propertyName];
            }else {
                NSNumber *number = (NSNumber *)num;
                [_object setValue:number forKey:obj.propertyName];
            }
        }else {
            Class OBJClass = obj.propertyClass;
            if(!Exist_(OBJClass, foundationClasses_)) {
                //如果类型为自定义类
                id obj_dict = [jsonDict valueForKey:[_analysisDict objectForKey:obj.propertyName]];
                //非空判断
                if (!obj_dict) {
                    id objx = [[OBJClass alloc] cm_initWithJSONString:DataToJSONString(obj_dict)];
                    [_object setValue:objx forKey:obj.propertyName];
                }else {
                    //这里可以赋值为[NSNull null] 可以赋值为一个新对象
//                    [_object setValue:[NSNull null] forKey:obj.propertyName];
                    [_object setValue:[[OBJClass alloc] init] forKey:obj.propertyName];
                }
            }else {
                [_object setValue:[jsonDict valueForKey:[_analysisDict objectForKey:obj.propertyName]] forKey:obj.propertyName];
            }
        }
    }];
}

4. 如何使用

举例说明：
这里有三个类
Animals(动物)

@property (strong, nonatomic) NSArray <Dog *> *dogs;
@property (strong, nonatomic) NSArray <Pig *> *pigs;

---实现方法：

- (NSDictionary *)dict_CMModelWithClass {
    return @{
             @"dogs" : @"dog",
             @"pigs" : @"pig",
             };
}

- (NSDictionary *)dict_CMModelWIthArrayClass {
    return @{
             @"dogs" : @"Dog",
             @"pigs" : @"Pig",
             };
}

Dog(狗)

@property (strong, nonatomic) NSString *dog_name;
@property (assign, nonatomic) NSUInteger dog_age;

//狗养的猪
@property (strong, nonatomic) Pig *dog_pig;

---实现方法

- (NSDictionary *)dict_CMModelWithClass {
    return @{
             @"dog_age" : @"age",
             @"dog_name" : @"name",
             @"dog_pig" : @"dog_pig"
             };
}

Pig(猪)

@property (strong, nonatomic) NSString *pig_name;
@property (assign, nonatomic) NSUInteger pig_age;

---实现方法

- (NSDictionary *)dict_CMModelWithClass {
    return @{
             @"pig_age" : @"age",
             @"pig_name" : @"name"
             };
}

调用方法

NSString *testJSON = @"{\"dog\":[{\"name\":\"dog_1\",\"age\":15,\"dog_pig\":{\"name\":\"dogAndPig1\",\"age\":666}},{\"name\":\"dog_2\",\"age\":null,\"dog_pig\":null}],\"pig\":[{\"name\":\"pig_1\",\"age\":10},{\"name\":\"pig_2\",\"age\":12}]}";

Animals *animals = [[Animals alloc] cm_initWithJSONString:testJSON];

写在后面的话

这个项目并不完善，比如说对于其中日期的格式化，非空的一些判断等，其中也有一些bug，本文权当是抛砖引玉，利用Runtime可以做很多事情，比如你可以实现，一句话完成归档与解归档，不会再出现Model属性过多时重写initWithCoder和encodeWithCoder的尴尬了，so，有时候我们更缺的是一种思考问题的方式，共勉！

PS：欢迎来我的简书、Github、个人博客交流😄

文中的Demo下载地址

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

推荐阅读更多精彩内容