Mantle源代码学习笔记一

Mantle代码阅读一

Mantle是一个能够简化我们JSON数据与mocel层面转换的类库，在传统的方法中如果是用手动的转换工作量较大，技术含量也底。使用该类型的库能够简化代码逻辑，提高代码质量。

该类库中主要有以下几个关键类（协议）:

• MTLModel:通常作为我们Model的基类。该类提供了一些默认的行为来处理对象的初始化和归档操作，同时可以获取到对象所有属性的键值集合。
• MTLJSONAdapter:用户MTLModel与JSON之间的转换。关键点地方，对象和数组的解析的关键代码都在此处。
• MTLJSONSerializing协议：需要与JSON字典进行相互转换的MTLModel的子类都需要实现该协议，以方便MTLJSONApadter对象进行转换。此处算是Mantle的核心点之一
• MTLValueTransformer: NSValueTransformer的子类，主要用于数据类型的变换，变换可以是单向或双向的。

MTLModel

1. 该类首先提供了一个初始化方法 - initWithDictionary。当Model中的属性都是普通数据类型的时候（非NSArray和NSObject），并且属性名和key完全一样。我们可以直接用它来初始化。否则无法达到我们的预期。该函数的主要作用在于被MTLJSONAdapter来调用。

- (id)modelFromJSONDictionary:(NSDictionary *)JSONDictionary error:(NSError **)error; 

调用MTLModel中的:

+ (instancetype)modelWithDictionary:(NSDictionary *)dictionary error:(NSError **)error

而该类方法调用的就是initWithDictionary了。

2. 该类中另外一个关键的方法就是+ (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本身的一些属性操作，功能的确十分强大。在这个过程中，通过运行时为对象本身关联了一些属性，其实也让对象增加了一些负担。