曾静的博客

但行好事,莫问前程.

嗨,我是曾静 (@devzeng),目前暂居深圳。


这是我用来记录平日学习笔记的地方,欢迎您的访问.

iOS开发中使用Mantle构建模型层

在iOS的开发中为了快速的实现产品的迭代和新功能的开发,常常会弱化Model的功能,NSDictionary作为承载业务的数据类型出现在各种地方(SQLite,Model Object,API Service…),直接使用objectForKey的方式进行数据的读取,参数和值的正确性完全没有经过编译器检查,字符串很容易写错,极容易导致在运行阶段出现低级bug.

1、Property名称转换

由于API使用的开发语言与iOS所使用的Objective-C是截然不同的,所以可能将一些保留关键字作为property的名称(如id),或者不小心override掉基类的属性(如description)。还有可能API中使用了一个很糟糕的名称,或者使用了不符合Objective-C命名规范的名称,这些我们都需要作转换。

只需要实现MTLJSONSerializing protocol并在+JSONKeyPathsByPropertyKey方法中定义好新旧名称的映射关系即可,Mantle会在序列化及反序列化时对属性名进行自动的转换。

+ (NSDictionary *)JSONKeyPathsByPropertyKey {
    return @{
              @keypath(model, xh)   : @"XH",
              @keypath(model, bbmc) : @"BBMC",
              @keypath(model, bbh)  : @"BBH",
              @keypath(model, bz)   : @"BZ",
              @keypath(model, xzdz) : @"XZDZ",
              @keypath(model, fbsj) : @"FBSJ"
    };
}

2、Property类型转换

(1)将NSString的字符串转换为NSURL:

iOS中处理URL使用的是NSURL类型,但JSON只支持基本的字符串,Mantle可以自动帮你转换成NSURL。

+ (NSValueTransformer *)URLJSONTransformer {
    return [NSValueTransformer valueTransformerForName:MTLURLValueTransformerName];
}

(2)将NSString的字符串映射为enum的成员

+ (NSValueTransformer *)stateJSONTransformer {
    return [NSValueTransformer mtl_valueMappingTransformerWithDictionary:@{
        @"open": @(GHIssueStateOpen),
        @"closed": @(GHIssueStateClosed)
    }];
}

(3)将字典转换为Objective-C的对象

+ (NSValueTransformer *)assigneeJSONTransformer {
    return [MTLJSONAdapter dictionaryTransformerWithModelClass:GHUser.class];
}

(4)实现JSON Value和Model Property的互相转换

1)比如将JSON字符串中的2015-10-10 10:10转换为NSDate类型,然后将NSDate类型的数据转换为yyyy-MM-dd HH:mm形式的字符串

+ (NSValueTransformer *)updatedAtJSONTransformer {
    return [MTLValueTransformer transformerUsingForwardBlock:^id(NSString *dateString, BOOL *success, NSError *__autoreleasing *error) {
        return [self.dateFormatter dateFromString:dateString];
    } reverseBlock:^id(NSDate *date, BOOL *success, NSError *__autoreleasing *error) {
        return [self.dateFormatter stringFromDate:date];
    }];
}

2)比如需要将{"id":"xxx", "subject":"", "time":""}这样一个JSON字符串转换为SearchListMailItemModel可以按照下面的方式进行转换

+ (NSValueTransformer *)mailJSONTransformer {
    return [MTLValueTransformer transformerUsingForwardBlock:^id(NSArray *value, BOOL *success, NSError *__autoreleasing *error) {
        if(!value || value.count <= 0) {
            return nil;
        }
        return [SearchListMailItemModel pdModelsWithArray:value error:nil];
    }];
}

3、统一空值处理

有的时候API响应的数据会出现空值,如status字段有些情况下是一个字符串,少数情况下返回的是null,如{"status":null},Mantle在这种情况下会将status转换为nil,但如果是标量(NSInteger,CGFloat)的时候直接会抛出异常。

@interface MTLModel (PDNullableScalar)

@end

@implementation MTLModel (PDNullableScalar)

- (void)setNilValueForKey:(NSString *)key {
    [self setValue:@0 forKey:key];  
}

@end

4、便捷NSDictionary->Model, Model->NSDictionary转换

(1) 将NSDictionary -> Model

CustomModel *model = [MTLJSONAdapter modelOfClass:PDBaseModel.class fromJSONDictionary:dictionary error:error];

(2) 将Model -> NSDictionary

NSDictionary *dict = [MTLJSONAdapter JSONDictionaryFromModel:self error:error];

5、结合RPJSONValidator实现JSON格式的校验

NSDictionary *dictionary = @{@"name":@"zhangsan", @"age":20};
NSDictionary *requirementsDictionary = @{@"name":RPValidatorPredicate.isString.isOptional, @"age":RPValidatorPredicate.isNumber.isOptional};
NSError *validError = nil;
BOOL valid = [RPJSONValidator validateValuesFrom:dictionary withRequirements:requirementsDictionary error:&validError];
if (!valid) {
        NSString *failingKeys = validError.userInfo[RPJSONValidatorFailingKeys];
        NSString *errorDescription = [NSString stringWithFormat:@"%@校验失败,错误信息:%@", NSStringFromClass(self), failingKeys];
        NSAssert(NO, errorDescription);
        return NO;
}

6、自动NSCoding/NSCopying Procotol的实现

如果需要将一个对象进行归档处理,在OC中需要实现NSCoding的Protocol,需要实现下面两个方法:

- (id)initWithCoder:(NSCoder *)coder {
    self = [self init];
    if (self == nil) return nil;
    _URL = [coder decodeObjectForKey:@"URL"];
    _number = [coder decodeObjectForKey:@"number"];
    _state = [coder decodeUnsignedIntegerForKey:@"state"];
    return self;
}
- (void)encodeWithCoder:(NSCoder *)coder {
    if (self.URL != nil) [coder encodeObject:self.URL forKey:@"URL"];
    if (self.number != nil) [coder encodeObject:self.number forKey:@"number"];
    [coder encodeUnsignedInteger:self.state forKey:@"state"];
}

如果需要将一个对象进行Copy处理,那么需要实现NSCopying的Protocol,需要实现下面两个方法:

- (id)copyWithZone:(NSZone *)zone {
    GHIssue *issue = [[self.class allocWithZone:zone] init];
    issue->_URL = self.URL;
    issue->_number = self.number;
    issue->_state = self.state;
    return issue;
}

但是使用Mantle之后NSCoding和NSCopyin Procotol是默认进行实现的,直接使用即可

参考资料

1、为什么唱吧iOS 6.0选择了Mantle

2、Mantle官网

最近的文章

使用Verdaccio搭建npm仓库

Verdaccio是一个轻量级的私有NPM的Registry(从Sinopiafork过来的,sinopia最后一次更新是在几年前了)。最开始是打算使用cnpmjs这个来搭建私有的npm仓库但是搭建完成之后存在一些问题,所以使用了Sinopia,本文记录下来搭建的过程。直接安装npm install verdaccio -g安装完成之后直接执行命令即可完成启动:verdaccio对于服务器上面部署可以使用pm2更多关于PM2的用法的可以参考:https://wohugb.gitbooks....…

Note继续阅读
更早的文章

使用StatSVN对SVN日志进行可视化分析

StatSVN是一个开源的SVN统计工具(Java语言编写,最近一次更新是2010-01-01),能够从Subversion版本库中取得信息,然后生成描述项目开发的各种表格和图表(StatSVN生成的报表是一组包括表格与图表的静态HTML文档)。比如: 代码行数的时间线; 针对每个开发者的代码行数; 开发者的活跃程度; 开发者最近所提交的; 文件数量; 平均文件大小; 最大文件; 哪个文件是修改最多次数的; 目录大小; 带有文件数量和代码行数的Repository tr...…

Note继续阅读