ios Mantle使用小记

先从Mantle github上下载下最新代码， （最近发现这个Mantle升级变化也挺大的，或许过一段时间， 这个文章记录的方法也不适用了）

1. 测试时， 可以使用下面这个网址及代码来测试， 里面有模型，数组，以及字典， 还可以有long long 转NSDate,  string 转 int等。

    NSURL *url = [NSURLURLWithString:@"http://api.openweathermap.org/data/2.5/weather?lat=37.785834&lon=-122.406417&units=imperial"];

    [NSURLConnectionsendAsynchronousRequest:[NSURLRequestrequestWithURL:url]

                                       queue:[NSOperationQueuemainQueue]

                           completionHandler:^(NSURLResponse* response,NSData* data, NSError* connectionError){

                               if (!connectionError) {

                                   NSDictionary *dict = [NSJSONSerializationJSONObjectWithData:data

                                                                                       options:NSJSONReadingMutableContainers

                                                                                         error:nil];

                                   

                                   //将JSON数据和Model的属性进行绑定

                                   FirstInterfaceModel *model = [MTLJSONAdaptermodelOfClass:[FirstInterfaceModelclass]

                                                                         fromJSONDictionary:dict

                                                                                      error:nil];

                                   NSLog(@"dict=%@\nmodel:%@",dict, model);

                                   

                                   NSError *testError =nil;

                                   NSDictionary *dicFromModel = [MTLJSONAdapterJSONDictionaryFromModel:model error:&testError];

                                   if (testError ==nil) {

                                       NSLog(@"after convert dic=%@", dicFromModel);

                                   }else {

                                       NSLog(@"after convert dic failed");

                                   }

                               }

                           }];

2. 使用时，需要把该模型有哪些属性值写清楚， 转的时候Mantle才知道哪些是需要转的。类型建议使用NSString, NSNumber, NSArray, NSDictionary, 等，不建议使用基本类型。

@interface FirstInterfaceModel :MTLModel <MTLJSONSerializing>

@property (nonatomic,strong) NSDate *date;

@property (nonatomic,strong) NSNumber *humidity;

@property (nonatomic,strong) NSNumber *temperature;

@property (nonatomic,strong) NSString *cod;

@property (nonatomic,strong) NSString *name;

@property (nonatomic,strong) NSString *xxxTestStr;

@property (nonatomic,strong) NSArray *arrWeathers;

@property (nonatomic,strong) sysModel *sys;

@end

3. 实现

+ (NSDictionary *)JSONKeyPathsByPropertyKey {

    NSMutableDictionary *mutDic = [[NSDictionarymtl_identityPropertyMapWithModel:[selfclass]] mutableCopy];

    [mutDic setObject:@"dt"forKey:@"date"];

    [mutDic setObject:@"main.humidity"forKey:@"humidity"];

    [mutDic setObject:@"main.temp"forKey:@"temperature"];

    [mutDic setObject:@"weather"forKey:@"arrWeathers"];

    

    return mutDic;

}

上面这个方法， 可以把服务器返回的字段与当前的属性名比较，如果相同，则直接使用，如果不相同的， 则与mutDic中的value进行比较， 然后转换成对应key的属性值。

4. 如果上面的服务器返回的cod为整弄，205这样的数据， 但我们这里定义的属性值为NSString， 则就需要下面这样的方式来进行转换，注意下面这个方法是双向转换。

+ (NSValueTransformer *)codJSONTransformer {

    return [MTLValueTransformertransformerUsingForwardBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {

        NSNumber *num = value;

        NSString *tempStr = [NSStringstringWithFormat:@"%@", num];

        return tempStr;

    } reverseBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {

        NSString *tempStr = value;

        NSNumber *tempNum = @(tempStr.integerValue);

        return tempNum;

    }];

}

再附一个服务器返回的dt为一个long long整型，这里需要一个NSDate.

+ (NSValueTransformer *)dateJSONTransformer {

    return [MTLValueTransformertransformerUsingForwardBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {

        NSNumber *dateNum = (NSNumber *)value;

        return [NSDatedateWithTimeIntervalSince1970:dateNum.floatValue];

    } reverseBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {

        NSDate *numDate = (NSDate *)value;

        return [NSStringstringWithFormat:@"%f", [numDatetimeIntervalSince1970]];

    }];

}

5. 附一个model内嵌model的实现, 注意和上面最初的类型一样，是一个sysModel.class.

+ (NSValueTransformer *)sysJSONTransformer {

    return [MTLJSONAdapterdictionaryTransformerWithModelClass:sysModel.class];

    

    // 下面方法与上面这个效果一样。

    return [MTLValueTransformertransformerUsingForwardBlock:^id(id value,BOOL *success, NSError *__autoreleasing *error) {

        NSDictionary *dic = value;

        return [MTLJSONAdaptermodelOfClass:[sysModelclass] fromJSONDictionary:dicerror:nil];

    }];

}

然后就会得到一个内嵌的sysModel对象。

6. 再加上一个数组的对象。服务器返回的weather是一个数组， 然后数组中的对象是WeatherModel.

+ (NSValueTransformer *)arrWeathersJSONTransformer {

    return [MTLJSONAdapterarrayTransformerWithModelClass:WeatherModel.class];

}

 

7. 再来一个安全方法。如果我们要求其中的cod不能为空，我们就可以实现下面这个方法，来对当其中有数据为空时，进行一个容错处理。下面这个方法，当服务器有返回数据为null的键值时，而本地又对这个键做了属性匹配时，就会调用下面这个方法，一般情况下可能会崩溃， 所以建议如果有一些重要的不能为null的键，可以在这里进行处理。

- (void)setNilValueForKey:(NSString *)key {

    NSLog(@"nil value detect for key=%@", key);

    if ([keyisEqualToString:@"cod"]) {

        [selfsetValue:@"something"forKey:@"cod"];

    }else {

        [supersetNilValueForKey:key];

    }

}

注意这个方法仅对非指针类型有用，即int float, bool等， 其它类型要想容错[NSNull null]， 需要在 MTLValueTransformer transformerUsingForwardBlock中进行识别处理。