現在大部分的項目都需要將服務器返回的JSON數據轉換為Model再使用。罪最原始的辦法就就是使用KVC 方法。
其次就是使用目前常用的字典轉模型工具，Mantle, MJExtension, JSONModel, 雖然他們做的事情都是一樣的，但是使用方法區別還是蠻大的，以及在一些細節上的處理也是不同的。
| 常用的集中方法 |
|---|
| * KVC |
| * Mantle |
| * MJExtension |
| * JSONModel |
文檔詳細度:
JSONModel > MJExtension > Mantle
性能：
JSONModel > MJExtension > Mantle
參考文檔：
Mantle、JSONModel、MJExtension性能測試
一、KVC
BSERootNoticeModel.m
#import "BSERootNoticeModel.h"
@implementation BSERootNoticeModel
- (instancetype)initWithDict:(NSDictionary *)dict
{
self = [super init];
if (self) {
[self setValuesForKeysWithDictionary:dict];
}
return self;
}
-(void)setValue:(id)value forUndefinedKey:(NSString *)key{
}
-(void)setNilValueForKey:(NSString *)key{
}
@end
BSERootNoticeModel.h
#import <Foundation/Foundation.h>
@interface BSERootNoticeModel : NSObject
@property(nonatomic,strong)NSString *noticeType;
@property(nonatomic,strong)NSString *content;
@property(nonatomic,strong)NSString *endDate;
- (instancetype)initWithDict:(NSDictionary *)dict;
@end
賦值時使用方法
BSERootNoticeModel *model = [[BSERootNoticeModel alloc]initWithDict:dic];
要點：
核心函數
[self setValuesForKeysWithDictionary:dict];
使用KVC 的時候需要注意 在相應的Model類里面需要重寫以下兩個方法，防止閃退。
-(void)setValue:(id)value forUndefinedKey:(NSString *)key;
-(void)setNilValueForKey:(NSString *)key;
二、 Mantle 使用
使用Mantle 的Model 需要集成MTLModel 并且實現MTLJSONSerializing 協議。
簡單的例子就不來了，可以直接到Github上面查看，這里上一個比較典型全面的例子。
- (NSDictionary *)JSONDict {
if (_JSONDict == nil) {
_JSONDict = @{@"name" : [NSNull null],
@"age" : @20,
@"sex" : @0,
@"login_date" : @"1445136827",
@"phone" : @{
@"name" : @"小明的iPhone",
@"price" : @5000
}
@"books" : @[
@{@"name" : @"西游記"},
@{@"name" : @"三國演義"}
]
};
}
return _JSONDict;
}
對應模型的特點: 1、有NSNull對象, 2、模型里面嵌套模型, 3、模型里面有數組，數組里面有模型.
對應的模型如下:
.h 文件
typedef NS_ENUM(NSUInteger, Sex) {
SexMale,
SexFemale
};
@interface BookForMantle : MTLModel <MTLJSONSerializing>
@property (nonatomic, copy, nullable) NSString *name;
@end
@interface PhoneForMantle : MTLModel <MTLJSONSerializing>
@property (nonatomic, copy, nullable) NSString *name;
@property (nonatomic, assign) double price;
@end
@interface UserForMantle : MTLModel <MTLJSONSerializing>
@property (nonatomic, copy, nullable) NSString *name;
@property (nonatomic, assign) NSInteger age;
@property (nonatomic, assign) Sex sex;
@property (nonatomic, strong, nullable) NSDate *loginDate;
@property (nonatomic, strong, nullable) PhoneForMantle *phone;
@property (nonatomic, copy, nullable) NSArray<BookForMantle *> *books;
@end
.m 文件
@implementation PhoneForMantle
+ (NSDictionary *)JSONKeyPathsByPropertyKey {
return @{@"name" : @"name",
@"price" : @"price"};
}
@end
@implementation BookForMantle
+ (NSDictionary *)JSONKeyPathsByPropertyKey {
return @{@"name" : @"name"};
}
@end
@implementation UserForMantle
// 該map不光是JSON->Model, Model->JSON也會用到
+ (NSDictionary *)JSONKeyPathsByPropertyKey {
return @{@"name" : @"name",
@"age" : @"age",
@"sex" : @"sex",
@"loginDate" : @"login_date",
@"phone" : @"phone",
@"books" : @"books"};
}
// 模型里面的模型
+ (NSValueTransformer *)phoneTransformer {
return [MTLJSONAdapter dictionaryTransformerWithModelClass:[PhoneForMantle class]];
}
// 模型里面的數組
+ (NSValueTransformer *)booksTransformer {
return [MTLJSONAdapter arrayTransformerWithModelClass:[BookForMantle class]];
}
// 時間 將 NSNumber類型的時間轉換為NSDate類型
+ (NSValueTransformer *)loginDateJSONTransformer {
return [MTLValueTransformer transformerUsingForwardBlock:^id(NSString *timeIntervalSince1970, BOOL *success, NSError *__autoreleasing *error) {
NSTimeInterval timeInterval = [timeIntervalSince1970 doubleValue];
NSDate *date = [NSDate dateWithTimeIntervalSince1970:timeInterval];
return date;
} reverseBlock:^id(NSDate *date, BOOL *success, NSError *__autoreleasing *error) {
NSTimeInterval timeInterval = date.timeIntervalSince1970;
return @(timeInterval).stringValue;
}];
}
@end
對應的解析方法:
// 注意: Mantle不會自動轉類型，如：String->Int, 一旦類型不匹配，直接crash
// Json->Model
// 該方法會調用key-key map方法。
self.userForMantle = [MTLJSONAdapter modelOfClass:[UserForMantle class] fromJSONDictionary:self.JSONDict error:nil];
// 這種方式只是簡單的使用KVC進行賦值。不會調用key-key map方法, 要求屬性和JSON字典中的key名稱相同，否則就crash
// self.userForMantle = [UserForMantle modelWithDictionary:self.JSONDict error:&error];
// Model -> JSON
// 一旦有屬性為nil, Mantle會轉換成NSNull對象放到JSON字典中，這里有一個坑，使用NSUserDefault存儲這樣的JSON字典時，程序crash，原因是不可以包含NSNull對象。
NSDictionary *jsonDict = [MTLJSONAdapter JSONDictionaryFromModel:self.userForMantle error:nil];
三、JSOMModel 的使用
仍舊使用上面的例子，對應的模型如下:
// BookForJsonModel
@protocol BookForJsonModel
@end
@interface BookForJsonModel : JSONModel
@property (nonatomic, copy, nullable) NSString *name;
@end
@implementation BookForJSONModel
// 前面是服務器字段，后面是模型屬性字段
+ (JSONKeyMapper *)keyMapper {
return [[JSONKeyMapper alloc] initWithDictionary:@{
@"name" : @"name"
}];
}
@end
// PhoneForJSONModel
@interface PhoneForJSONModel : JSONModel
@property (nonatomic, copy, nullable) NSString *name;
@property (nonatomic, assign) double price;
@end
@implementation PhoneForJSONModel
+ (JSONKeyMapper *)keyMapper {
return [[JSONKeyMapper alloc] initWithDictionary:@{
@"name" : @"name",
@"price" : @"price"
}];
}
@end
// UserForJSONModel
@interface UserForJSONModel : JSONModel
@property (nonatomic, copy, nullable) NSString *name;
@property (nonatomic, assign) NSInteger age;
@property (nonatomic, assign) Sex sex;
@property (nonatomic, strong, nullable) NSDate *loginDate;
@property (nonatomic, strong, nullable) PhoneForJSONModel *phone;
// 注意協議 model -> model Array
@property (nonatomic, copy, nullable) NSArray<BookForJSONModel> *books;
@end
@implementation UserForJSONModel
+ (JSONKeyMapper *)keyMapper {
return [[JSONKeyMapper alloc] initWithDictionary:@{
@"name" : @"name",
@"age" : @"age",
@"sex" : @"sex",
@"login_date" : @"loginDate",
@"phone" : @"phone",
@"books" : @"books"
}];
}
// 允許所有字段為空
+ (BOOL)propertyIsOptional:(NSString *)propertyName {
return YES;
}
@end
對應的解析方法
// JSON->Model
UserForJSONModel *user = [[UserForJSONModel alloc] initWithDictionary:self.JSONDict error:nil];
// Model->JSON
NSDictionary *dict = [user toDictionary];
JSONModel各方面都挺好的，唯一需要注意的地方是它歸檔的方式, 它不是將對象歸檔，而是轉換成字典再歸檔。
-(instancetype)initWithCoder:(NSCoder *)decoder{
NSString* json = [decoder decodeObjectForKey:@"json"];
JSONModelError *error = nil;
self = [self initWithString:json error:&error];
if (error) {
JMLog(@"%@",[error localizedDescription]);
}
return self;
}
-(void)encodeWithCoder:(NSCoder *)encoder
{
[encoder encodeObject:self.toJSONString forKey:@"json"];//將對象轉換成json字符串再歸檔
}
四、MJExtension的使用
MJExtension 不再詳細介紹，大家可以直接看github readme文件已經介紹的很詳細
