詳細輕參考:https://github.com/CoderMJLee/MJExtension 功能很牛掰git
MJExtension是一套字典和模型之間互相轉換
的超輕量級框架github
MJExtension能完成的功能json
字典(JSON)
--> 模型(Model)
數組
模型(Model)
--> 字典(JSON)
框架
字典數組(JSON Array)
--> 模型數組(Model Array)
函數
模型數組(Model Array)
--> 字典數組(JSON Array)
測試
詳盡用法主要參考 main.m中的各個函數 以及 NSObject+MJKeyValue.h
atom
轉換速率:url
最近一次測試代表:MJExtension
> JSONModel
> Mantle
spa
各位開發者也能夠自行測試
具體用法:
JSONModel
:要求全部模型類必須
繼承自JSONModel基類
Mantle
:要求全部模型類必須
繼承自MTModel基類
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
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
[User objectWithKeyValues:dict]
@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
[Status objectWithKeyValues:dict]
@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
在模型內部實現+ (NSDictionary *)objectClassInArray
方法
[StatusResult objectWithKeyValues:dict]
@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
在模型內部實現+ (NSDictionary *)replacedKeyFromPropertyName
方法
[Student objectWithKeyValues:dict]
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
[User objectArrayWithKeyValuesArray:dictArray]
// 新建模型 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; }; }; } */
status.keyValues
、stu.keyValues
// 新建模型數組 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; } ) */
[User keyValuesArrayWithObjectArray:userArray]
參考NSObject+MJKeyValue.h
參考NSObject+MJCoding.h