【Objective-c】 YYModel 基本使用

本编内容均出自于：张羽婷_Laura

听朋友介绍，YYModel是一位90年后用周末两天的时间搭建完成的一套框架，今天学习了一下午，收获不少，满满的惊喜，作者思绪很缜密，不得不佩服...

#import "ViewController.h"
#import "YYModel.h"
#import "Book.h"
@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    NSDictionary *dict = @{
        @"n":@"Harry Pottery",
        @"p": @(256),
        @"ext" : @{
                    @"desc" : @"A book written by J.K.Rowing."
                },
        @"ID" : @(100010),
        @"author":@{
            @"name":@"J.K.Rowling",
            @"birthday":@"1965-07-31T00:00:00+0000"
        },
        @"works":@[@"one",@"two",@"three"],
        @"timestamp":@(1445534567)
        };
    
    //单模型，或者模型嵌套，都是只要一句代码，会自动嵌套
    Book *model = [[Book alloc]init];
    [model yy_modelSetWithDictionary:dict];
    NSLog(@"===============%@",model.name);
    NSLog(@"+++++++++++++++%ld",model.page);
    NSLog(@"--------------%@",model.author.name);       //模型嵌套
}

#import "Book.h"
@implementation Book
/*
    创建一个JSON的Key 与 Model属性的映射列表
    可以一对多、多对一、多对多
    1、如果一个属性没有映射关系，那默认会使用相同属性名作为映射
    2、在 json->model 的过程中：如果一个属性对应了多个 json key，那么转换过程会按顺序查找，并使用第一个不为空的值。
    3、在 model->json 的过程中：如果一个属性对应了多个 json key (key path)，那么转换过程仅会处理第一个 json key (key path)；如果多个属性对应了同一个 json key，则转换过过程会使用其中任意一个不为空的值。
 */

//返回一个 Dict，将 Model 属性名对映射到 JSON 的 Key。
//创建映射表，主要是因为JSON的Key与Model的属性明不一致
+ (NSDictionary *)modelCustomPropertyMapper {
    return @{@"name" : @"n",
             @"page" : @"p",
             @"desc" : @"ext.desc",
             @"bookID" : @[@"id",@"ID",@"book_id"],
             };
}

//返回容器类中的所需存放的数据类型(以Class或 Class Name 的形式)
+ (NSDictionary *)modelContainerPropertyGenericClass{
    return @{
             @"works":[NSString class], //声明数组works中的元素都是字符串类型
             };
}

//黑名单：在处理过程中会忽略该列表内的所有属性
+ (NSArray *)modelPropertyBlacklist{
    //结果是：name属性不会被赋值，其他正常
    return @[@"name"];
}

//白名单: 在处理过程中不会处理该列表以外的属性
+ (NSArray *)modelPropertyWhitelist{
    //结果是：只会给name属性赋值
    return @[@"name"];
}

//当JSON 转为 Model 完成后，该方法会被调用
//可以在这里对数据进行校验，如果校验不通过，可以返回NO，则该Model会被忽略
//也可以在这里对一些自动转换不能完成的工作，如数据格式更改
- (BOOL)modelCustomTransformFromDictionary:(NSDictionary *)dic{
    NSNumber *timestamp = dic[@"timestamp"];
    if (![timestamp isKindOfClass:[NSNumber class]]) {
        return NO;
    }
    //数据转换
    _timestamp = [NSDate dateWithTimeIntervalSince1970:timestamp.floatValue];
    return YES;
}

//当Model 转为 JSON 完成后，该方法会被调用
//可以在这里对数据进行校验，如果校验不通过，可以返回NO，则该Model 会被忽略
//也可以在这里做一些自动转换不能完成的工作
- (BOOL)modelCustomTransformToDictionary:(NSMutableDictionary *)dic{
    return YES;
}

以上是部分代码，完整的DEMO