特点：
基于ObjC Runtime,SafeCategory,NSCache实现自动解析
自动化数据与Model互相解析
一个NSObject Category类，only一个方法即可实现
数据与model互相转换，涉及到 :字典<-->模型 字典数组<-->模型数组 josn<-->模型
数据与model互相转换，仅仅处理有效数值，不存在的key，value将不赋值
数据与model互相转换，可指定model属性名被忽略,不进行dic、json和model的转换或者不进行归档
Model层级嵌套：Model中属性为数组，NSArray中每个元素为另一model（字典数组<-->模型数组）
Josn层级嵌套，Mode对象josn化
最大缓存500个Model定义,1个model按10个左右属性，大约0.1K，500个model点内存50K
实现 模型序列化存储、读取、copy 【NSCoding NSCopying】
使用 WDSafeCategories保证每条数据安全解析
jsonKeyName支持education.teacherResume 多层级使用(解析及反向)
实现 memoryDB->serializable files、sqlite3
项目用例：
1.model定义->属性字典
2.复杂的字典 -> 模型 (模型的数组属性里面又装着模型)
3.模型 (模型的数组属性里面又装着模型) -> 复杂的字典
4.模型 (模型的数组属性里面又装着模型) -> json字符串
5.json文件 -> 模型 (模型的数组属性里面又装着模型) 用于mock
6.model存储序列化文件
7.序列化文件读取model
8.字典数组转型数组
9.型数组转字典数组
Model定义使用如下：
@JSONInterface(Status) : NSObject
@property (nonatomic, strong) NSString *text;
@property (nonatomic, strong) User *user;
@property (nonatomic, strong) Status *retweetedStatus;
@end
//宏JSONImplementation实现了NSCoding,NSCopying
@JSONImplementation(Statuse)
@end
@JSONInterface(StatusResult) : NSObject
@property (nonatomic, strong) JSONMutableArray(Status) *statuses;
@property (nonatomic, strong) User *user;
@property (nonatomic, strong) NSNumber *totalNumber;
@property (nonatomic, assign) NSUInteger previousCursor;
@property (nonatomic, assign) NSUInteger nextCursor;
//每条记录依据数据在runtime时动态确定是NSNumber,NSString,NSDictionary
@property (nonatomic, strong) NSArray *list;
@property (nonatomic, strong) JSONMutableArray(NSNumber) *numberList;
@property (nonatomic, strong) JSONMutableArray(NSString) *stringList;
@property (nonatomic, strong) JSONMutableArray(NSDictionary) *dictionaryList;
@end
@JSONImplementation(StatusResult)
+ (NSDictionary *)replacedKeyMap{
NSMutableDictionary *map = [NSMutableDictionary dictionary];
//[map safeSetObject:@"jsonKeyName" forKey:@"propertyName"];
[map safeSetObject:@"total_number" forKey:@"totalNumber"];
return map;
}
//or
+ (NSDictionary *)replacedKeyMap{
return @{@"propertyName" : @"jsonKeyName",
@"totalNumber" : @"total_number"
};
}
+ (NSArray *)ignoredParserPropertyNames{
return [NSArray arrayWithObjects:@"nextCursor", nil];
}
+ (NSArray *)ignoredCodingPropertyNames{
return [NSArray arrayWithObjects:@"nextCursor", nil];
}
@end
使用：
- AutoParser
- JOSN2MODEL 下载JOSN2Model.app
- 1.项目引入AutoParser目录下的NSObjectHelper.h，NSObjectHelper.m 主要用到其中的 initWithDic() & dic(）两个方法
若propertyName与josnKeyName不一致时，用到replacedKeyMap（）方法
可指定model属性名被忽略,不进行dic、json和model的转换或者不进行归档，用到ignoredParserPropertyNames（）或者ignoredCodingPropertyNames（）方法 - 2.JOSN2Model.app 桌面app，将api返回的josn数据转成model.h,model.m，保存.h.m，并引入到项目中
- 3.使用:
ModelClass *record=[[ModelClass alloc] initWithDic:response[@"data"]];//dic转model
NSDictionary *dic=[record dic];//model转dic
ModelClass *record=[[ModelClass alloc] initWithJson:jsonString];//json字符串转model
NSString *jsonString=[record json];//model转json字符串
NSMutableArray *models=[ModelClass modelsFromDics:dics];//dic数组转model数组
NSMutableArray *dics=[ModelClass dicsFromModels:models];//dic数组转model数组
/**
在propertyName与josnKeyName不一致时，要在model.m实现的类方法
返回replacedKeyMap：{propertyName:jsonKeyName}
建议使用 JOSN2Model.app 自动生成
*/
+ (NSDictionary *)replacedKeyMap{
NSMutableDictionary *map = [NSMutableDictionary dictionary];
//[map safeSetObject:@"jsonKeyName" forKey:@"propertyName"];
[map safeSetObject:@"avatar" forKey:@"icon"];
return map;
}
//or
+ (NSDictionary *)replacedKeyMap{
return @{@"propertyName" : @"jsonKeyName",
@"icon" : @"avatar"
};
}
/**
可指定model属性名被忽略：不进行dic、json和model的转换，如model的fat属性
*/
+ (NSArray *)ignoredParserPropertyNames{
return [NSArray arrayWithObjects:@"fat", nil];
}
/**
可指定model属性名被忽略：不进行归档，如model的fat属性
*/
+ (NSArray *)ignoredCodingPropertyNames{
return [NSArray arrayWithObjects:@"fat", nil];
}
NSDictionary *userPpropertiesDic = [NSObject propertiesOfClass:[ModelClass class]];//model定义->属性字典
ModelClass *copy=[record copy];//支持model NSCoding
[NSKeyedArchiver archiveRootObject:copy toFile:path];//model存储序列化文件
ModelClass *read=[NSKeyedUnarchiver unarchiveObjectWithFile:path];//序列化文件读取model
AutoParser is released under the MIT license. See LICENSE for details.