MJExtension使用指导(转)

作者: PPAbner | 来源:发表于2015-09-14 18:02 被阅读94928次

1. MJExtension使用指导(最新)
2. MJExtension[模型字典]包含[模型字典数组]解析数据的bug及处理方法
3.MJExtension源码导读2016-11-04
4.答简友“小米人”的MJExtension使用困惑,新手注意!!! 2016-11-03,详细介绍拿到数据怎么解析

当自己看到原文的排版时,真的是。。。,自己花了点时间重新排版了下,分享出来!
原文链接:IOS 字典模型互转框架 MJExtension

MJExtension能做什么?

  1. MJExtension是一套字典和模型之间互相转换的超轻量级框架

  2. MJExtension能完成的功能

     字典(JSON) --> 模型(Model)
     模型(Model) --> 字典(JSON)
     字典数组(JSON Array) --> 模型数组(Model Array)
     模型数组(Model Array) --> 字典数组(JSON Array)
    

详尽用法主要参考 main.m中的各个函数 以及 NSObject+MJKeyValue.h

MJExtension和JSONModel、Mantle等框架的区别

1. 转换速率:

最近一次测试表明:MJExtension > JSONModel > Mantle

各位开发者也可以自行测试

2.具体用法:

JSONModel

要求所有模型类必须继承自JSONModel基类

Mantle

要求所有模型类必须继承自MTModel基类

MJExtension

不需要你的模型类继承任何特殊基类,毫无污染,毫无侵入性

如何使用MJExtension

方法一:cocoapods导入pod 'MJExtension'

方法二:手动导入

将MJExtensionExample/MJExtensionExample/MJExtension文件夹中的所有源代码拽入项目中
导入主头文件:#import "MJExtension.h"
MJExtension.h
MJConst.h               
MJConst.m
MJFoundation.h               
MJFoundation.m
MJIvar.h               
MJIvar.m
MJType.h                
MJType.m
NSObject+MJCoding.h     
NSObject+MJCoding.m
NSObject+MJIvar.h       
NSObject+MJIvar.m
NSObject+MJKeyValue.h   
NSObject+MJKeyValue.m

1.最简单的字典转模型

typedef enum {
    SexMale,    
    SexFemale} Sex;
@interface User : NSObject
@property (copy, nonatomic) NSString *name;
@property (copy, nonatomic) NSString *icon;
@property (assign, nonatomic) int age;
@property (assign, nonatomic) double height;
@property (strong, nonatomic) NSNumber *money;
@property (assign, nonatomic) Sex sex;
@end

NSDictionary *dict = @{
                        @"name" : @"Jack",                 
                        @"icon" : @"lufy.png",               
                        @"age" : @20,               
                        @"height" : @"1.55",               
                        @"money" : @100.9,               
                        @"sex" : @(SexFemale)            
};

// 将字典转为User模型
User *user = [User objectWithKeyValues:dict];
NSLog(@"name=%@, icon=%@, age=%d, height=%@, money=%@, sex=%d", user.name, user.icon, user.age, user.height, user.money, user.sex);
// name=Jack, icon=lufy.png, age=20, height=1.550000, money=100.9, sex=1

核心代码1:

[User objectWithKeyValues:dict]

2.模型中嵌套模型

@interface Status : NSObject
/** 微博文本内容 */
@property (copy, nonatomic) NSString *text;
/** 微博作者 */
@property (strong, nonatomic) User *user;
/** 转发的微博 */
@property (strong, nonatomic) Status *retweetedStatus;
@end

NSDictionary *dict = @{               
@"text" : @"是啊,今天天气确实不错!", 
@"user" : @{                   
             @"name" : @"Jack",                   
             @"icon" : @"lufy.png"                
           },               
@"retweetedStatus" : @{                   
                        @"text" : @"今天天气真不错!",                   
                        @"user" : @{                       
                                    @"name" : @"Rose",                       
                                    @"icon" : @"nami.png"                    
                                   }                
                       }            
};

// 将字典转为Status模型
Status *status = [Status objectWithKeyValues:dict];
NSString *text = status.text;
NSString *name = status.user.name;
NSString *icon = status.user.icon;
NSLog(@"text=%@, name=%@, icon=%@", text, name, icon);
// text=是啊,今天天气确实不错!, name=Jack, icon=lufy.png

NSString *text2 = status.retweetedStatus.text;
NSString *name2 = status.retweetedStatus.user.name;
NSString *icon2 = status.retweetedStatus.user.icon;
NSLog(@"text2=%@, name2=%@, icon2=%@", text2, name2, icon2);
// text2=今天天气真不错!, name2=Rose, icon2=nami.png

核心代码2

[Status objectWithKeyValues:dict]

3.模型中有个数组属性,数组里面又要装着其它模型

@interface Ad : NSObject
@property (copy, nonatomic) NSString *image;
@property (copy, nonatomic) NSString *url;
@end

@interface StatusResult : NSObject
/** 存放着一堆的微博数据(里面都是Status模型) */
@property (strong, nonatomic) NSMutableArray *statuses;
/** 存放着一堆的广告数据(里面都是Ad模型) */
@property (strong, nonatomic) NSArray *ads;
@property (strong, nonatomic) NSNumber *totalNumber;
@end

@implementation StatusResult
// 实现这个方法的目的:告诉MJExtension框架statuses和ads数组里面装的是什么模型
/*    + (NSDictionary *)objectClassInArray{    
return @{         
@"statuses" : [Status class],         
@"ads" : [Ad class]    };
}
+ (Class)objectClassInArray:(NSString *)propertyName{    
if ([propertyName isEqualToString:@"statuses"]) {        
return [Status class];    
} else if ([propertyName isEqualToString:@"ads"]) {        
return [Ad class];    }    
return nil;}
*/

// 这个方法对比上面的2个方法更加没有侵入性和污染,因为不需要导入Status和Ad的头文件
+ (NSDictionary *)objectClassInArray{    
    return @{         
              @"statuses" : @"Status",         
              @"ads" : @"Ad"    
            };
}
@end

NSDictionary *dict = @{                       
@"statuses" : @[                           
                @{                                   
                   @"text" : @"今天天气真不错!",
                   @"user" : @{                                   
                                @"name" : @"Rose",
                                @"icon" : @"nami.png"                                                                                  
                              }                            
                 }, 
                                           
                 @{                               
                    @"text" : @"明天去旅游了", 
                    @"user" : @{                                                                   
                                 @"name" : @"Jack",                                       
                                 @"icon" : @"lufy.png"                               
                               }  
                   } 
                                                                         
                ],                       
 @"ads" :@[                           
           @{                               
              @"image" : @"ad01.png", 
              @"url" : @"http://www.ad01.com"                                                          
            }, 
                                      
           @{                               
              @"image" : @"ad02.png",                                   
              @"url" : @"http://www.ad02.com"                           
            }                       
          ],                       
 @"totalNumber" : @"2014"                    
};
         
         // 将字典转为StatusResult模型
         StatusResult *result = [StatusResult objectWithKeyValues:dict];
         NSLog(@"totalNumber=%@", result.totalNumber);
         // totalNumber=2014
         
         // 打印statuses数组中的模型属性
         for (Status *status in result.statuses) {    
                NSString *text = status.text;    
                NSString *name = status.user.name;    NSString *icon = status.user.icon;    
                NSLog(@"text=%@, name=%@, icon=%@", text, name, icon);}
               // text=今天天气真不错!, name=Rose, icon=nami.png
               // text=明天去旅游了, name=Jack, icon=lufy.png
         
         // 打印ads数组中的模型属性
         for (Ad *ad in result.ads) {    
                 NSLog(@"image=%@, url=%@", ad.image, ad.url);}
                 // image=ad01.png, url=http://www.ad01.com
                 // image=ad02.png, url=http://www.ad02.com

核心代码3:

在模型内部实现+ (NSDictionary *)objectClassInArray方法

[StatusResult objectWithKeyValues:dict]

4.模型中的属性名和字典中的key不相同(或者需要多级映射)

@interface Bag : NSObject
@property (copy, nonatomic) NSString *name;
@property (assign, nonatomic) double price;@end@interface Student : NSObject
@property (copy, nonatomic) NSString *ID;
@property (copy, nonatomic) NSString *desc;
@property (copy, nonatomic) NSString *nowName;
@property (copy, nonatomic) NSString *oldName;
@property (copy, nonatomic) NSString *nameChangedTime;
@property (strong, nonatomic) Bag *bag;
@end

@implementation Student
// 实现这个方法的目的:告诉MJExtension框架模型中的属性名对应着字典的哪个key
+ (NSDictionary *)replacedKeyFromPropertyName{    
     return @{                
               @"ID" : @"id",                
               @"desc" : @"desciption",                
               @"oldName" : @"name.oldName", 
               @"nowName" : @"name.newName",  
               @"nameChangedTime" : @"name.info.nameChangedTime",                                       
               @"bag" : @"other.bag"            
              };
}

@end

NSDictionary *dict = @{                       
                        @"id" : @"20",                       
                        @"desciption" : @"孩子",
                        @"name" : @{                                                         
                                     @"newName" : @"lufy", 
                                     @"oldName" : @"kitty",  
                                     @"info" : @{                                                                                                   
                                                  @"nameChangedTime" : @"2013-08"                            
                                                 }                       
                                    },                       
                        @"other" : @{                            
                                      @"bag" : @{                                
                                                  @"name" : @"小书包", 
                                                  @"price" : @100.7                                                              
                                                 }                       
                                     }                   
};

// 将字典转为Student模型
Student *stu = [Student objectWithKeyValues:dict];
// 打印Student模型的属性
NSLog(@"ID=%@, desc=%@, oldName=%@, nowName=%@, nameChangedTime=%@", stu.ID, stu.desc, stu.oldName, stu.nowName, stu.nameChangedTime);
// ID=20, desc=孩子, oldName=kitty, nowName=lufy, nameChangedTime=2013-08
NSLog(@"bagName=%@, bagPrice=%f", stu.bag.name, stu.bag.price);
// bagName=小书包, bagPrice=100.700000

核心代码4:

在模型内部实现+ (NSDictionary *)replacedKeyFromPropertyName方法

[Student objectWithKeyValues:dict]

5.将一个字典数组转成模型数组

NSArray *dictArray = @[                       
                        @{                           
                           @"name" : @"Jack",                           
                           @"icon" : @"lufy.png",                        
                         },                       
                        @{                           
                           @"name" : @"Rose",                           
                           @"icon" : @"nami.png",                        
                         }                    
                       ];

// 将字典数组转为User模型数组
NSArray *userArray = [User objectArrayWithKeyValuesArray:dictArray];
// 打印userArray数组中的User模型属性
for (User *user in userArray) {   
      NSLog(@"name=%@, icon=%@", user.name, user.icon);}
      // name=Jack, icon=lufy.png
      // name=Rose, icon=nami.png

核心代码5:

[User objectArrayWithKeyValuesArray:dictArray]

6.将一个模型转成字典

// 新建模型
  User *user = [[User alloc] init];
user.name = @"Jack";
user.icon = @"lufy.png";

Status *status = [[Status alloc] init];
status.user = user;
status.text = @"今天的心情不错!";


// 将模型转为字典
NSDictionary *statusDict = status.keyValues;
NSLog(@"%@", statusDict);
/*{ text = "今天的心情不错!";    
    user = {        
             icon = "lufy.png";        
             name = Jack;    
           };
  }*/
  
// 多级映射的模型
Student *stu = [[Student alloc] init];
stu.ID = @"123";
stu.oldName = @"rose";
stu.nowName = @"jack";
stu.desc = @"handsome";
stu.nameChangedTime = @"2018-09-08";

Bag *bag = [[Bag alloc] init];
bag.name = @"小书包";
bag.price = 205;
stu.bag = bag;
NSDictionary *stuDict = stu.keyValues;NSLog(@"%@", stuDict);
/*
{    desciption = handsome;    
       id = 123;    
       name = {        
                info ={            
                nameChangedTime = "2018-09-08";        
                       };        
                newName = jack;        
                oldName = rose;    
               };    
                other = {  
                          bag ={            
                                 name = "小书包";            
                                 price = 205;        
                               };    
                        }; 
               }
 */

核心代码6:

status.keyValues、stu.keyValues

7.将一个模型数组转成字典数组

// 新建模型数组
  User *user1 = [[User alloc] init];
user1.name = @"Jack";
user1.icon = @"lufy.png";

User *user2 = [[User alloc] init];
user2.name = @"Rose";
user2.icon = @"nami.png";

NSArray *userArray = @[user1, user2];
// 将模型数组转为字典数组
NSArray *dictArray = [User keyValuesArrayWithObjectArray:userArray];
NSLog(@"%@", dictArray);
/*(    
{        icon = "lufy.png";        name = Jack;    },    
{        icon = "nami.png";        name = Rose;    }  )*/

核心代码7:

[User keyValuesArrayWithObjectArray:userArray]

更多用法

参考NSObject+MJKeyValue.h
参考NSObject+MJCoding.h

相关文章

网友评论

  • JaneEyre3X:楼主问一下1.最简单的字典转模型是写在哪个界面 里的为什么我怎么写都是报错呢
  • 冰三尺:swift 中使用这个框架可以解析吗?我自己试了下, 好像不行呀?
  • 肾得朕心:请教一下,如果model有个属性也是model,而数据dict只有一层这样的话可以取吗?比如:people类里有个属性是sex类的对象,sex里有个属性是value,想直接取dict[@"sex"]赋值给people.sex.value。刚才试了下 没取到不知道是不是我的方法有问题。
    肾得朕心:@PPAbner 现在情况这样的一个类似微博的数据,包括用户信息,微博信息,但是数据只有一层,我定义了一个model,里面包括用户信息和微博信息的model,用户信息里有name什么的。想用MJExtension直接给用户信息里的name赋值
    PPAbner:可以参考这一条 4.模型中的属性名和字典中的key不相同(或者需要多级映射),着重对比看看。
    PPAbner:@肾得朕心 people.sex = dict[@"sex"],不是应该这样吗??
  • 肾得朕心:最近发现 mj_newValueFromOldValue这个方法挺实用的,可以清除一些空对象,转成自己想要的值,比如某个字段为nil或者NSNull 可以转成@“”
    PPAbner:@肾得朕心
    ```
    #pragma mark --- 判断字符串是不是安全的
    -(BOOL)pp_isSafe
    {
    NSString *str = self;
    return isSafeStr(str);
    }

    static BOOL isSafeStr(NSString *str){
    if ([str isKindOfClass:[NSNull class]] || str == nil || str.length == 0 || [str isEqualToString:@"(null)"] || [str isEqualToString:@"null"] || [str isEqualToString:@"NULL"] || [str isEqualToString:@"(null)"] || [str isEqualToString:@"<null>"] || [str isEqualToString:@"<NULL>"]) {
    return NO;
    }else{
    return YES;
    }
    }
    ```
    肾得朕心:@PPAbner 楼主 NSString的category你去怎么处理的呀。代码可以看下不
    PPAbner:@肾得朕心 是的,但是一般很少用,项目中我一般用NSString的category去处理字符串。看自己喜欢。
  • handsome丶亮:很棒很棒,赞一个
  • jianshu小赵:写得很详细 不错
  • 突刺刺:博主,亲测,数组转模型,单单指定模型类型,会转换不成功,必须要在驼峰命名方法中指定一下数组的名称,比如
    [NSClassFromString(@"CYSecondSubBetModel") mj_setupObjectClassInArray:^NSDictionary *{
    return @{@"gatherArr":@"CYLeastModel"};
    }]; //CYSecondSubBetModel.gatherArr 为空(实际有三个模型CYLeastModel)
    加上这个方法
    [NSClassFromString(@"CYSecondSubBetModel") mj_setupReplacedKeyFromPropertyName121:^id(NSString *propertyName) {
    if ([propertyName isEqualToString:@"gatherArr"]) return @"gatherArr";
    return [propertyName mj_underlineFromCamel];
    }];
    就能成功转换CYSecondSubBetModel.gatherArr 有三个模型CYLeastModel
  • 9bd74219c762:写的挺不错的,已经收藏了。

    源码解析:http://suo.im/1FKU2k


    e717d49b5f9f:写的蛮用心的,希望多多坚持那
  • 再不侃:写的真好,条理清晰,简单易懂
  • 宋卓_89e8:MJ偶像。
  • 宋卓_89e8:牛逼。
  • 4eafcf9f0a2a:如果我想让转换的对象支持<NSCopying>,可以拷贝,MJExtension有这方面的API 吗 ?
    PPAbner:@小猫007 没有,需要自己遵守
  • Be_ingenious:第三个 《模型中有个数组属性,数组里面又要装着其它模型》其中我在转的过程中遇到了 数组里的模型转化出来不是Model,而是一个字典。这样输出的时候回崩溃。例如楼主文中所写 NSLog(@"image=%@, url=%@", ad.image, ad.url); 因为ad是字典不是模型,所以会崩溃。解决方案 在这个方法下面加上 @Implementation Ad
    + (NSDictionary *)objectClassInArray{
    return @{
    @"statuses" : @"Status",
    @"ads" : @"Ad"
    };
    }
    @EnD
    Be_ingenious:@PPAbner 我的qq568629494可以加我一下么
    PPAbner:@Be_ingenious 靠,我给你发的不就是这个!!!再后来回过头你会觉得,这他妈的简直是easy 。还是那句话,用多了就好了!
  • Be_ingenious:就是 组数里面的模型转出来 是字典啊 楼下提出过这个问题 我看了你们好多简书 都有这个问题 读者也都提出来这个 。字典 数组 字典 按道理是模型 但是是字典
    Be_ingenious:@PPAbner 搞定了,待会我会给出解决方案,因为相信,我们写了但是找不到问题,所以久有点不撞南墙不回头。
    PPAbner:@Be_ingenious 在模型点h中声明数组「比如你的数组key是@"arrKey",就建个可变数组 *arrKey」,然后在点m中,实现+(NSDictionry *)mj_objectClsaaInArray{
    return @{@“arrKey”:[yourModel class};
    }
    PPAbner:@Be_ingenious 我现在没电脑,你也别急,按你说的,不是个大问题。你现在有电脑,把你的数据弄个json文件,或者给个网路请求,我明天上班第一件事给你解决掉,兄弟我保证。别急!因为不看数据,我也说不清楚!但真不是大问题!别急,兄弟!
  • Be_ingenious:楼主在么 数组那个转的 在MOdel的 。M文件中 那个方法在哪掉
  • Be_ingenious:楼主在么 我里面有个数组 写的没用啊
    PPAbner:@Be_ingenious 能再说清楚点不?我不是很懂,或者你发我一个简单的demo,明天到公司立马给你看看!chinesemanbobo@163.com
  • 4ed9c19e6074: 如果 模型嵌套的是不是模型数组,只是模型 不需要特殊处理一下吗?
    4ed9c19e6074:@PP_Abner 好的 谢谢
    PPAbner:@4ed9c19e6074 不需要
  • 码农进城::smile: 谢谢作者,不得不说写的很好,自己演示了一遍都理解了
    PPAbner:@码农进城 谢谢!
  • 承宇:你好,感谢分享。这个框架里面,有在数组字典转化为模型数组时,我想把服务器返回来的字符串转换为时间,这个有么。还是我自己二次处理。
    承宇:@PP_Abner OK
    PPAbner:@承宇 没有,你自己在用的时候处理下!
  • 玫瑰花瓣的信笺:请问,如果字典中套模型,模型里有个JSON字符串,这个字符串是其实是一个字典。这个字符串字典模型里又有数组,数组里又装有模型字典。该怎么弄?
  • 翻滚的炒勺2013:很详细~
    PPAbner:@翻滚的炒勺2016 谢谢!
  • feng_dev:我碰到了 替换 id 关键字,转换 Model array 后,Model 里面 都有值,除了 id 那个,怎么回事啊、我以前都能用的
    PPAbner:@伤感的小孩 等下,我电脑打开,你简信我,代码发来一看
    feng_dev:@PP_Abner 我就是那么写的,遵循代理是什么鬼?导入头文件不就行了么
    PPAbner:@伤感的小孩 你把id用其它比如orderId替换,然后就模型点m文件,遵循代理,返回那个字典设置下!
  • _de_bug_life:楼主,问下当数据是带小数点的一连串数字时出现这样的问题怎么办(84.35=>84.34999999999...)用的是mj_objectWithKeyValues:方法
    折光:拿到数据后二次处理,比如转成float格式就可以
  • 二三年华:这不是MJ作者李明杰github简介中readme里面的东西嘛
    PPAbner:@二三年华 全是吧,相似程度很高,高的有点离谱!无非多了点注释!:smile:
  • 高手世界:JSON 转对象的时候,一个NSString的属性,如果后台返回对应这个属性的类型不是NSString,而是其他的数据类型,怎么办
    PPAbner:@高手世界 没遇到过,不过我试了基本数据类型转NSString的,木问题。其它我也再看看。
  • FingertipFish:请问一下,xcode8之后,这个的使用会有影响吗
  • 高高叔叔:其实我真不知道这个好用在哪里有什么好处, 和自己写的有什么差别。
    PPAbner:@高高叔叔 第一,对于多说没有你能自己写出来的牛人很方便,第二,国产开源比较早的开源库,第三,正如mj所说,模型不需要像mantle那样继承规定的模型,第四,作者持续维护,开发者不用担心维护的烦恼,第五,开发者认可,就算性能有影响,也是值得的。
  • 萧旭:MJExtension 真心强!!!!!

    自己加油!
    PPAbner:@JeanRookieXu 加油!
  • 朋友有朋:瞬间懂了很多,谢谢了,伙计!!
  • 郑明明:挺不错
  • 有梦想de咸鱼:赞一个,很详细
  • XiuQiCloud:3.模型中有个数组属性,数组里面又要装着其它模型.
      这个你试过吗?为什么我的数据参照此方法,属性对应的数组model,解析后是以字典的形式组装的,而非属性model组装的?
    SunnyFeng0501:@Be_ingenious 这个问题解决了 我也是 不是模型而是字典呢
    Be_ingenious:就是 写了 不行 楼主啊
    PPAbner:@Cloud_W 你在模型.m文件中有没有写类似下面的代码// 这个方法对比上面的2个方法更加没有侵入性和污染,因为不需要导入Status和Ad的头文件
    + (NSDictionary *)objectClassInArray{
    return @{
    @"statuses" : @"Status",
    @"ads" : @"Ad"
    };
    }
    ???
  • efd0507a0501:感谢分享
    PPAbner:@efd0507a0501 :smile::smile:
  • 陆壹吱吱:6666666
    PPAbner:@陆壹的V博 6666,3q
  • 杏仁丶:很详细,感谢分享~
    PPAbner:@杏仁丶 希望对你有用!
  • 等这姑娘老在我心里:假如说返回的dic 里面key 是关键字 比如说 id 应该如何处理
    PPAbner:@等这姑娘老在我心里 http://www.zhihu.com/question/35588974/answer/63656074?f3fb8ead20=1266b11ef5aaf6cc633a1fa9692389f8这是我去年回复知乎一个网友的,现在注意在前面加mj_就可以
  • 爱码师:写的确实不错!
  • cfa214d17e4d:艹 迷糊了
  • 栀厄:很给力!谢谢!!
  • 流刃若火泣:不错!

本文标题:MJExtension使用指导(转)

本文链接:https://www.haomeiwen.com/subject/jqqmcttx.html