YYModel

特性

• 高性能: 模型转换性能接近手写解析代码。
• 自动类型转换: 对象类型可以自动转换，详情见下方表格。
• 类型安全: 转换过程中，所有的数据类型都会被检测一遍，以保证类型安全，避免崩溃问题。
• 无侵入性: 模型无需继承自其他基类。
• 轻量: 该框架只有 5 个文件 (包括.h文件)。
• 文档和单元测试: 文档覆盖率100%, 代码覆盖率99.6%

使用方法

简单的 Model 与 JSON 相互转换

// JSON:

{
"uid":123456,
"name":"Harry",
"created":"1965-07-31T00:00:00+0000"

}

// Model:
@interface User : NSObject
@property UInt64 uid;
@property NSString *name;
@property NSDate *created;
@end
@implementation User
@end


// 将 JSON (NSData,NSString,NSDictionary) 转换为 Model:

User *user = [User yy_modelWithJSON:json];

// 将 Model 转换为 JSON 对象:
NSDictionary *json = [user yy_modelToJSONObject];

当 JSON/Dictionary 中的对象类型与 Model 属性不一致时，YYModel 将会进行如下自动转换。自动转换不支持的值将会被忽略，以避免各种潜在的崩溃问题。

Model 属性名和 JSON 中的 Key 不相同

// JSON:

{
"n":"Harry Pottery",
"p": 256,
"ext" : {
"desc" : "A book written by J.K.Rowing."

    },
"ID" : 100010

}

// Model:
@interface Book : NSObject
@property NSString *name;
@property NSInteger page;
@property NSString *desc;
@property NSString *bookID;
@end
@implementation Book
//返回一个 Dict，将 Model 属性名对映射到 JSON 的 Key。

+ (NSDictionary *)modelCustomPropertyMapper {
return @{@"name" : @"n",
@"page" : @"p",
@"desc" : @"ext.desc",
@"bookID" : @[@"id",@"ID",@"book_id"]};

}
@end

你可以把一个或一组 json key (key path) 映射到一个或多个属性。如果一个属性没有映射关系，那默认会使用相同属性名作为映射。

在 json->model 的过程中：如果一个属性对应了多个 json key，那么转换过程会按顺序查找，并使用第一个不为空的值。

在 model->json 的过程中：如果一个属性对应了多个 json key (key path)，那么转换过程仅会处理第一个 json key (key path)；如果多个属性对应了同一个 json key，则转换过过程会使用其中任意一个不为空的值。

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

安装

CocoaPods

1. 在 Podfile 中添加 pod 'YYModel'。
2. 执行 pod install 或 pod update。
3. 导入 。

Carthage

1. 在 Cartfile 中添加 github "ibireme/YYModel"。
2. 执行 carthage update --platform ios 并将生成的 framework 添加到你的工程。
3. 导入 。

手动安装

1. 下载 YYModel 文件夹内的所有内容。
2. 将 YYModel 内的源文件添加(拖放)到你的工程。
3. 导入 YYModel.h。

常见问题及demo:点击这里

源码下载:YYModel.zip