Mantle简单认识及使用

Mantle是什么？

Mantle是一个建模框架，实现了多个不同的NSCoding和NSCopying方法，还添加了许多非常便利的方法允许你实现更多有用的功能，比如返回一个json字典，以代表你的对象。很多情况下，Mantle可以作为Core Data的替代选择。

Mantle如何使用？

• 从github下载加入到项目或者通过cocoapod导入（pod 'Mantle'）

• 简单自定义对象继承MTLModel并声明<MTLJSONSerializing>协议，实现+ (NSDictionary *)JSONKeyPathsByPropertyKey协议方法。

例如对下面的jsonDic数据进行转换： "id": 12, "code": 200, "msg": "ok"

简单对象定义：

@interface SampleEntity : MTLModel<MTLJSONSerializing>@property (nonatomic, assgin) NSInteger *sampleId; //与系统id会冲突@property (nonatomic, assgin) NSInteger code;@property (nonatomic, strong) NSString  *msg;@end@implementation ESFHouseEntity+ (NSDictionary *)JSONKeyPathsByPropertyKey {     NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];     mapping[@"sampleId"] = @"id"; //解决与系统id会冲突的问题    return mapping;}@end

jsonDic数据转SampleEntity：

SampleEntity *entity = [MTLJSONAdapter modelOfClass:[SampleEntity class] fromJSONDictionary:jsonDic error:nil];

---

• 对jsonArr数组进行解析：

    [      {          "age": 0,          "id": 1,          "name": "name0"      },      {          "age": 1,          "id": 2,          "name": "name1"      },      {          "age": 2,          "id": 3,          "name": "name2"      }  ]

对象定义：

@interface SampleArrEntity : MTLModel<MTLJSONSerializing>@property (nonatomic, assgin) NSInteger *sampleArrId; //与系统id会冲突@property (nonatomic, assgin) NSInteger age;@property (nonatomic, strong) NSString  *name;@end@implementation ESFHouseEntity+ (NSDictionary *)JSONKeyPathsByPropertyKey {     NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];     mapping[@"sampleArrId"] = @"id"; //解决与系统id会冲突的问题    return mapping;}@end

jsonArr数据转SampleArrEntity：

NSArray *SampleArrEntityArr = [MTLJSONAdapter modelsOfClass:[SampleArrEntity class] fromJSONArray:jsonArr error:nil];

---

• 对于比较复杂的json数据：

    {  "houseLookByAgentMsgList": [  {      "agent": {          "credit": 0,          "id": 206591      },      "lookedDate": "2015-07-29"  },  {      "agent": {          "credit": 0,          "id": 224354      },      "lookedDate": "2015-07-29"  }  ],  "similarHouseMsgList": [  {      "id": 517109,      "picture": "http://fs.xxx.net/image/000/003/919/ValtlhStZdQdZ93OaQ-gvNgdI_I.jpg"  },  {      "id": 517109,      "picture": "http://fs.xxx.net/image/000/003/919/ValtlhStZdQdZ93OaQ-gvNgdI_I.jpg"  }  ],  "houseId": 123  }

对象定义：

@class ESFAgentEntity,ESFHouseListEntity,HouseLookByAgentMsg;@interface ComplexEntity : MTLModel<MTLJSONSerializing>@property (nonatomic, strong) NSArray *houseLookByAgentMsgList; //经纪人带看记录列表<HouseLookByAgentMsg>@property (nonatomic, strong) NSArray *similarHouseMsgList;//相似房源<ESFHouseListEntity>@property (nonatomic, strong) NSString  *houseId;@end#pragma mark - 经纪人带看记录对象@interface HouseLookByAgentMsg : MTLModel <MTLJSONSerializing>@property (nonatomic, strong) ESFAgentEntity *agent;//经纪人实体@property (nonatomic, strong) NSString *lookedDate;//"2014-12-05", // 带看时间@end#pragma mark - 经纪人对象@interface ESFAgentEntity : MTLModel <MTLJSONSerializing>@property (nonatomic, assign) NSInteger credit;@property (nonatomic, strong) NSInteger agentId;//与系统id会冲突@end#pragma mark - 相似房源对象@interface ESFHouseListEntity : MTLModel <MTLJSONSerializing>@property (nonatomic, assign) NSString  *picture;@property (nonatomic, strong) NSInteger houseListId;//与系统id会冲突@end@implementation ComplexEntity+ (NSDictionary *)JSONKeyPathsByPropertyKey {     NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];    return mapping;}//经纪人带看记录列表<HouseLookByAgentMsg>进行解析+ (NSValueTransformer *)houseLookByAgentMsgListJSONTransformer{    return [MTLJSONAdapter arrayTransformerWithModelClass:HouseLookByAgentMsg.class];}//相似房源<ESFHouseListEntity>进行解析+ (NSValueTransformer *)similarHouseMsgListJSONTransformer{    return [MTLJSONAdapter arrayTransformerWithModelClass:ESFHouseListEntity.class];}@end@implementation HouseLookByAgentMsg+ (NSDictionary *)JSONKeyPathsByPropertyKey {NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];return mapping;}//对经纪人实体agent进行解析+ (NSValueTransformer *)agentJSONTransformer{    return [MTLJSONAdapter dictionaryTransformerWithModelClass:ESFAgentEntity.class];}@end@implementation ESFHouseListEntity+ (NSDictionary *)JSONKeyPathsByPropertyKey {NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];mapping[@"houseListId"] = @"id";//与系统id会冲突return mapping;}@end@implementation ESFAgentEntity+ (NSDictionary *)JSONKeyPathsByPropertyKey {NSMutableDictionary *mapping = [[NSDictionary mtl_identityPropertyMapWithModel:self] mutableCopy];mapping[@"agentId"] = @"id";return mapping;}