iOS Mantle解析框架简单的使用入门（字典映射model）

做个笔记给有需要的人快速入门

参考链接：http://blog.csdn.net/majiakun1/article/details/45829667

我主要使用Mantle来做数据解析，以前自己有用runtime写了一个字典到model的数据映射，但是看到很多人用第三方的Mantle，所以今天就看了一下，

我不讲他的实现原理，有兴趣可以慢慢去了解

1.下载Mantle

2.创建model时候必须继承：MTLModel

3.model必须实现协议：MTLJSONSerializing

4.重写协议的一个方法：

//使用Mantle必须实现的协议  KVO的形式

+(NSDictionary *)JSONKeyPathsByPropertyKey

5.如果model里面属性有嵌套model 或者 属性需要做转换等就实现

+(NSValueTransformer *)JSONTransformerForKey:(NSString *)key

6.映射model主要涉及的类：MTLJSONAdapter

例子：

//
//  TempObj.h
//  KangarooApp
//
//  Created by linpeng on 16/3/7.
//  Copyright © 2016年 KangarooFamily. All rights reserved.
//

#import <Foundation/Foundation.h>
#import "KSBaseObject.h"



@interface TempObj1 : MTLModel<MTLJSONSerializing>

@property (nonatomic,strong) NSString *name_a;
@property (nonatomic,strong) NSString *age_a;

@end


@interface TempObj : MTLModel<MTLJSONSerializing>

@property (nonatomic,strong) NSString *name;
@property (nonatomic,strong) NSString *age;
@property (nonatomic,strong) NSDate *birth;
@property (nonatomic,strong) TempObj1 *model;
@property (nonatomic,strong) NSArray *list;
@end

实现文件

//
//  TempObj.m
//  KangarooApp
//
//  Created by linpeng on 16/3/7.
//  Copyright © 2016年 KangarooFamily. All rights reserved.
//

#import "TempObj.h"


@implementation TempObj1

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

@end

@implementation TempObj

//使用Mantle必须实现的协议  KVO的形式
+(NSDictionary *)JSONKeyPathsByPropertyKey
{
    return @{ @"name":@"name",
              @"age":@"age",
              @"birth":@"birth",
              @"model":@"model1",
              @"list":@"listArray"  //list：属性名称    listArray：对应需要解析的字段key
              };
}
//属性值做转换 例如 时间戳转成NSDate，dic转model等操作（嵌套model）
//方法一：（这是协议方法）
+(NSValueTransformer *)JSONTransformerForKey:(NSString *)key
{
    if ([key isEqualToString:@"birth"])
    {
        return [MTLValueTransformer transformerUsingForwardBlock:^(NSString *str, BOOL *success, NSError **error){
            return [NSDate dateWithTimeIntervalSince1970:str.floatValue];
        } reverseBlock:^(NSDate *date, BOOL *success, NSError **error) {
            return [NSString stringWithFormat:@"%f", [date timeIntervalSince1970]];
        }];
    }
    else if ([key isEqualToString:@"list"])
    {
        return [MTLJSONAdapter arrayTransformerWithModelClass:[TempObj1 class]];
    }
    /*
     跟方法二一样（不重复所以注释掉）
     else if ([key isEqualToString:@"model"])
     {
     return [MTLJSONAdapter dictionaryTransformerWithModelClass:[TempObj1 class]];
     }
     */
    return nil;
    
}

//属性值做转换 例如 时间戳转成NSDate，dic转model等操作（嵌套model）
方法二：方法名必须遵循特定的规则
//SEL selector = MTLSelectorWithKeyPattern(key, "JSONTransformer");
//注意：属性名+JSONTransformer
+ (NSValueTransformer *)modelJSONTransformer {
    
    return [MTLJSONAdapter dictionaryTransformerWithModelClass:[TempObj1 class]];
    
    // 下面方法与上面这个效果一样。
    /*
    return [MTLValueTransformer transformerUsingForwardBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {
        
        NSDictionary *dic = value;
        
        return [MTLJSONAdapter modelOfClass:[TempObj1 class] fromJSONDictionary:dic error:nil];
        
    }];
     */
}
@end

注意以上的方法里面的注释 有两种方式做处理 建议方法二的方式 没有那么多的if-else 

测试：

 NSDictionary *dict = [[NSDictionary alloc] initWithObjects:@[@"iOS开发工程师",@"23岁",@1457097793] forKeys:@[@"name",@"age",@"birth"]];
    
    NSDictionary *dict1 = [[NSDictionary alloc] initWithObjects:@[@"我是屎壳郎情调",@"25岁"] forKeys:@[@"name",@"age"]];
   
    int count = 3;
    NSMutableArray *array = [[NSMutableArray alloc] initWithCapacity:count];
    for (int i = 0 ; i<count;i++)
    {
        [array addObject:dict1];
    }
    
    NSMutableDictionary *dicts = [[NSMutableDictionary alloc] initWithDictionary:dict];
    [dicts setObject:dict1 forKey:@"model1"];
    [dicts setObject:array forKey:@"listArray"];
    
    TempObj *obj = [MTLJSONAdapter modelOfClass:[TempObj class] fromJSONDictionary:dicts error:nil];

结果：