Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/netyouli/WHC_Model
iOS平台高效转换引擎json->model,model->json,model->Dictionary,支持模型类继承其他模型类,支持指定路径转换,不区分json的key和模型属性名称大小写,自动处理json中null
https://github.com/netyouli/WHC_Model
json json-parser jsonmodel model whc
Last synced: about 2 months ago
JSON representation
iOS平台高效转换引擎json->model,model->json,model->Dictionary,支持模型类继承其他模型类,支持指定路径转换,不区分json的key和模型属性名称大小写,自动处理json中null
- Host: GitHub
- URL: https://github.com/netyouli/WHC_Model
- Owner: netyouli
- License: mit
- Created: 2015-05-04T03:44:35.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-04-13T14:10:37.000Z (over 3 years ago)
- Last Synced: 2024-04-25T14:41:24.952Z (5 months ago)
- Topics: json, json-parser, jsonmodel, model, whc
- Language: Objective-C
- Homepage:
- Size: 1.49 MB
- Stars: 245
- Watchers: 12
- Forks: 50
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
WHC_Model
==============
[](http://cocoadocs.org/docsets/WHC_Model/)
[](http://cocoadocs.org/docsets/WHC_Model/)
[](https://opensource.org/licenses/MIT)
简介
==============
- **高效**: 深度递归高性能解析架构,性能超过目前主流JsonModel，MJExtension...
- **继承**: 支持model类继承其他model类
- **安全**: 自动处理json中的null
- **优势**: 高容错能力(model类属性名称和json里key名称不区分大小写)
- **强大**: 支持自定义模型类属性名称以及类型别名设置
- **特性**: 支持反射指定json路径key来解析指定的节点json对象
- **嵌套**: 支持json或者model类的无限嵌套,json->model ,model->json的转换
- **附加**: 支持模型对象归档解档以及copy操作
性能测试
==============
Time lost (Benchmark 1000 times)
* 查看性能测试请运行项目： Benchmark/ModelBenchmark.xcodeproj
要求
==============
* iOS 6.0 or later
* Xcode 8.0 or later
集成
==============
* 使用CocoaPods:
- pod 'WHC_Model'
* 手工集成:
- 导入文件夹WHC_ModelKit
用法
==============
### json -> model
```Objective-C
/// jsonString 是一个比较复杂3000行的json文件，具体参考demo
ModelObject * model = [ModelObject whc_ModelWithJson:jsonString];
NSLog(@"model = %@\n\n\n",model);
```
### model -> json
```Objective-C
NSString * modelString = [model whc_Json];
NSLog(@"modelString = %@\n\n\n",modelString);
```
### model - > NSDictionary
```Objective-C
NSDictionary * modelDict = [model whc_Dictionary];
NSLog(@"modelDict = %@\n\n\n",modelDict);
```
### 四,指定路径只解析Head对象
```Objective-C
Head * head = [Head whc_ModelWithJson:jsonString keyPath:@"Head"];
NSLog(@"head = %@\n\n\n",head);
```
### 五,指定路径只解析ResponseBody对象
```Objective-C
ResponseBody * body = [ResponseBody whc_ModelWithJson:jsonString keyPath:@"ResponseBody"];
NSLog(@"ResponseBody = %@\n\n\n",body);
```
### 六,指定路径只解析PolicyRuleList集合中第一个对象
```Objective-C
PolicyRuleList * rule = [PolicyRuleList whc_ModelWithJson:jsonString keyPath:@"ResponseBody.PolicyRuleList[0]"];
NSLog(@"rule = %@\n\n\n",rule);
```
###七,归档对象
```Objective-C
NSData *data = [NSKeyedArchiver archivedDataWithRootObject:body];
NSLog(@"data = %@\n\n\n",data);
```
### 八,解归档对象
```Objective-C
ResponseBody * body = [NSKeyedUnarchiver unarchiveObjectWithData:data];
NSLog(@"body = %@\n\n\n",body);
```
### 九,模型对象复制
```Objective-C
ResponseBody * copyBody = body.copy;
NSLog(@"copyBody = %@",copyBody);
```
自定义别名
==============
```Objective-C
/// 模型类可自定义属性名称
+ (NSDictionary *)whc_ModelReplacePropertyMapper {
return @{};
}
/// 模型数组/字典元素对象可自定义类
+ (NSDictionary *)whc_ModelReplaceContainerElementClassMapper {
return @{替换实际属性名 : 实际类};
}
/// 模型类可自定义属性类型
+ (NSDictionary *)whc_ModelReplacePropertyClassMapper {
return @{替换实际属性名 : 实际类};
}
```
推荐
==============
- WHC_DataModelFactory mac工具github地址：https://github.com/netyouli/WHC_DataModelFactory
文档
==============
```Objective-C
#pragma mark - json转模型对象 Api -
/** 说明:把json解析为模型对象
*@param json :json数据对象
*@return 模型对象
*/
+ (id)whc_ModelWithJson:(id)json;
/** 说明:把json解析为模型对象
*@param json :json数据对象
*@param keyPath :json key的路径
*@return 模型对象
*/
+ (id)whc_ModelWithJson:(id)json keyPath:(NSString *)keyPath;
#pragma mark - 模型对象转json Api -
/** 说明:把模型对象转换为字典
*@return 字典对象
*/
- (NSDictionary *)whc_Dictionary;
/** 说明:把模型对象转换为json字符串
*@return json字符串
*/
- (NSString *)whc_Json;
#pragma mark - 模型对象序列化 Api -
/// 复制模型对象
- (id)whc_Copy;
/// 序列化模型对象
- (void)whc_Encode:(NSCoder *)aCoder;
/// 反序列化模型对象
- (void)whc_Decode:(NSCoder *)aDecoder;
```
## 期待
- 如果您在使用过程中有任何问题，欢迎issue me! 很乐意为您解答任何相关问题!
- 与其给我点star，不如向我狠狠地抛来一个BUG！
- 如果您想要更多的接口来自定义或者建议/意见，欢迎issue me！我会根据大家的需求提供更多的接口！
## Licenses
All source code is licensed under the MIT License.