【iOS】YYModel初学习

前言

YYModel是一个OC的开源库，用于处理json数据和iOS应用中的数据的相互转换，在使用场景中非常的实用。

常用方法

// 字典转模型
+ (nullable instancetype)yy_modelWithDictionary:(NSDictionary *)dictionary;
// json转模型
+ (nullable instancetype)yy_modelWithJSON:(id)json;
// 模型转NSObject
- (nullable id)yy_modelToJSONObject;
// 模型转NSData
- (nullable NSData *)yy_modelToJSONData;
// 模型转json字符串
- (nullable NSString *)yy_modelToJSONString;
// 模型深拷贝
- (nullable id)yy_modelCopy;
// 判断模型是否相等
- (BOOL)yy_modelIsEqual:(id)model;
// 属性数据映射，用来定义多样化数据时转换声明
+ (nullable NSDictionary<NSString *, id> *)yy_modelCustomPropertyMapper;
// 属性自定义类映射，用来实现自定义类的转换声明
+ (nullable NSDictionary<NSString *, id> *)yy_modelContainerPropertyGenericClass;
// 属性黑名单，该名单属性不转换为model
+ (nullable NSArray<NSString *> *)yy_modelPropertyBlacklist;
// 属性白名单，只有该名单的属性转换为model
+ (nullable NSArray<NSString *> *)yy_modelPropertyWhitelist;
// JSON 转为 Model 完成后，该方法会被调用，返回false该model会被忽略
// 同时可以在该model中做一些，转换不能实现的操作，如NSDate类型转换
- (BOOL)yy_modelCustomTransformFromDictionary:(NSDictionary *)dic;
// Model 转为 JSON 完成后，该方法会被调用，返回false该model会被忽略
// 同时可以在该model中做一些，转换不能实现的操作，如NSDate类型转换
- (BOOL)yy_modelCustomTransformToDictionary:(NSMutableDictionary *)dic

基本的使用方法

数据交换

NSDictionary *dic = @{@"name":@"张三",@"age":@(12),@"sex":@"男"};
// 将数据转模型
YYPersonModel *model = [YYPersonModel yy_modelWithDictionary:dic];
// 将模型转数据
NSDictionary *dics = [model yy_modelToJSONObject];

多样化的数据类型交换

YYModel支持自定义的属性名进行映射，也就是说数据的key和属性名可以是不相同。那么怎么才知道你自定义的属性名对应的是数据的哪个key呢？那就需要对自定义属性的映射进行映射声明。

@interface TestYYModel : NSObject@property (strong, nonatomic) NSNumber *personId;
@property (copy,   nonatomic) NSString *name;
@property (assign, nonatomic) int age;
@property (copy,   nonatomic) NSString *sex;@end

在YYPersonModel.m 重写YYModel的方法yy_modelCustomPropertyMapper，返回设定的映射值,并且YYModel提供多个字段的映射。(笔者本人并未搞懂这里的用法，在YYModel源码中并未找到)

+ (NSDictionary *)yy_modelCustomPropertyMapper {// 将personId映射到key为id的数据字段return @{@"personId":@"id"};// 映射可以设定多个映射字段//  return @{@"personId":@[@"id",@"uid",@"ID"]};
}

最后依然通过像原来的数据那样，直接通过字典的方式进行模型转换，当key为id时，会自动给personId赋值，达到我们需要的效果。

// ViewController.m
NSDictionary *dic = @{@"id":@"123",@"name":@"lisi",@"age":@(20),@"sex":@"man"};TestYYModel *model = [TestYYModel yy_modelWithDictionary:dic];NSLog(@"ID: %@",model.personId);NSDictionary *dics = [model yy_modelToJSONObject];NSLog(@"ID: %@", dics);

自定义属性映射数据交换

YYModel支持多样化的数据类型，甚至字典，数组等数据，如果不存在，则该model会自动设置为null，该例子提出使用NSArray和NSDictionary作为数据，效果依然一样。


@interface TestYYModel : NSObject@property (strong, nonatomic) NSNumber *personId;
@property (copy,   nonatomic) NSString *name;
@property (assign, nonatomic) int age;
@property (copy,   nonatomic) NSString *sex;
@property (strong, nonatomic) NSArray *languages;
@property (strong, nonatomic) NSDictionary *job;@end

在数据中依然可以找到NSArray和NSDictionary和sexDic下的sex字段并转化为模型:

// ViewController.m
NSDictionary *dic = @{@"id":@"123",@"name":@"张三",@"age":@(12),@"sexDic":@{@"sex":@"男"},@"languages":@[@"汉语",@"英语",@"法语"],@"job":@{@"work":@"iOS",@"eveDay":@"10小时",@"site":@"CSDN"}};
YYPersonModel *model = [YYPersonModel yy_modelWithDictionary:dic];

自定义类数据转换(多个model嵌套)

这里我们并不需要做什么，只需要将一个model设置成另一个model的属性就可以了。

// JSON
{"author":{"name":"J.K.Rowling","birthday":"1965-07-31T00:00:00+0000"},"name":"Harry Potter","pages":256
}// Model: 什么都不用做，转换会自动完成
@interface Author : NSObject
@property NSString *name;
@property NSDate *birthday;
@end
@implementation Author
@end@interface Book : NSObject
@property NSString *name;
@property NSUInteger pages;
@property Author *author; //Book 包含 Author 属性
@end
@implementation Book
@end