Mantle代码阅读一
Mantle是一个能够简化我们JSON数据与mocel层面转换的类库,在传统的方法中如果是用手动的转换工作量较大,技术含量也底。使用该类型的库能够简化代码逻辑,提高代码质量。
该类库中主要有以下几个关键类(协议):
- MTLModel:通常作为我们Model的基类。该类提供了一些默认的行为来处理对象的初始化和归档操作,同时可以获取到对象所有属性的键值集合。
- MTLJSONAdapter:用户MTLModel与JSON之间的转换。关键点地方,对象和数组的解析的关键代码都在此处。
- MTLJSONSerializing协议:需要与JSON字典进行相互转换的MTLModel的子类都需要实现该协议,以方便MTLJSONApadter对象进行转换。此处算是Mantle的核心点之一
- MTLValueTransformer: NSValueTransformer的子类,主要用于数据类型的变换,变换可以是单向或双向的。
MTLModel
- 该类首先提供了一个初始化方法 - initWithDictionary。当Model中的属性都是普通数据类型的时候(非NSArray和NSObject),并且属性名和key完全一样。我们可以直接用它来初始化。否则无法达到我们的预期。该函数的主要作用在于被MTLJSONAdapter来调用。
- (id)modelFromJSONDictionary:(NSDictionary *)JSONDictionary error:(NSError **)error;
调用MTLModel中的:
+ (instancetype)modelWithDictionary:(NSDictionary *)dictionary error:(NSError **)error
而该类方法调用的就是initWithDictionary了。
- 该类中另外一个关键的方法就是+ (NSSet *)propertyKeys; 该方法的定义是由协议MTLModel中继承而来。该方法能够取得Model中所有的属性名称。
取得的属性能够会被缓存到对象中,使用运行时添加到对象中,具体实现代码如下
+ (NSSet *)propertyKeys {
// 取缓存
NSSet *cachedKeys = objc_getAssociatedObject(self, MTLModelCachedPropertyKeysKey);
if (cachedKeys != nil) return cachedKeys;
NSMutableSet *keys = [NSMutableSet set];
[self enumeratePropertiesUsingBlock:^(objc_property_t property, BOOL *stop) {
NSString *key = @(property_getName(property));
if ([self storageBehaviorForPropertyWithKey:key] != MTLPropertyStorageNone) {
[keys addObject:key];
}
}];
// 添加到对象中,MTLModelCachedPropertyKeysKey不需要有值,只需要地址就OK了。
objc_setAssociatedObject(self, MTLModelCachedPropertyKeysKey, keys, OBJC_ASSOCIATION_COPY);
return keys;
}
同时取得的属性包含父类中的属性, 父类一直取到MTLModel得直接子类这一层,如代码为处理方式:
+ (void)enumeratePropertiesUsingBlock:(void (^)(objc_property_t property, BOOL *stop))block {
Class cls = self;
BOOL stop = NO;
// 控制条件 第二个为只取到MTLModel以下
while (!stop && ![cls isEqual:MTLModel.class]) {
unsigned count = 0;
objc_property_t *properties = class_copyPropertyList(cls, &count);
// 取基类
cls = cls.superclass;
if (properties == NULL) continue;
@onExit {
free(properties);
};
for (unsigned i = 0; i < count; i++) {
block(properties[i], &stop);
if (stop) break;
}
}
}
当然这个类中还有其他很多有趣的地方,比如storageBehaviorForPropertyWithKey该函数中对属性存储特性的分析,用到了运行时中很多特性。Mantle中还对整个运行时进行了一定的拓展。
总的来说,该类中主要为用户提供了Model本身的一些属性操作,功能的确十分强大。在这个过程中,通过运行时为对象本身关联了一些属性,其实也让对象增加了一些负担。