一. 前言
KVC(Key Value Coding)是Cocoa框架为开发者提供的非常强大的工具,简单解释为:键值编码。它依赖于Runtime,在OC的动态性方面发挥了重要作用。
它主要的功能在于直接通过变量名称字符串来访问成员变量,不管是私有的还是共有的,这也是为什么对于OC来说没有真正的私有变量,因为它们都可以使用KVC访问。
二. 使用场景
下面是KVC的一些实用场景,读者可自行编码尝试。
1.访问私有属性
例如设置UITextField的placeholder颜色,常规的方法是:
// 方式一:常规设置
_nameTextField.attributedPlaceholder = [[NSAttributedString alloc] initWithString:@"请输入名字" attributes:@{NSForegroundColorAttributeName : [UIColor redColor]}];
通过KVC的方式设置:
// 方式二:使用KVC获取私有属性
_nameTextField.placeholder = @"请输入名字";
// UILabel *placeHolderLabel = [_nameTextField valueForKey:@"placeholderLabel"];
UILabel *placeHolderLabel = [_nameTextField valueForKey:@"_placeholderLabel"];
placeHolderLabel.textColor = UIColor.blackColor;
[self.view addSubview:_nameTextField];
这里通过valueForKey的方式获取了UITextField的placeholderLabel,然后对该对象的颜色进行设置。如果获取到的placeholderLabel为nil,有几种可能:
- key输入有误(重新输入)
- 系统实现发生改变
- 苹果使用的Lazy Load,导致在使用valueForKey获取的时候还没有初始化(因此这里先赋值placeholder,然后再获取placeholderLabel)
还是建议使用使用方式一对属性进行设置。站在苹果的角度,它之所以把某些属性设置为私有,就是不想让开发者进行直接修改,后续一旦苹果对系统实现有所更改,那就会导致使用KVC获取的内容失效。
另外,在使用setValue:forKey:的时候一定要类型统一,比如你通过key获取到的是一个Label,却将string设置为了value,将会crash。
上面在使用valueForKey:方法的时候参数可以带下划线( _ placeholderLabel ),也可以不带下划线,它的主要区别就是如果使用了带下划线的key,就算类中手动实现了getter方法,也不会执行类中实现的getter方法。如果使用了不带下划线的,将会执行类中getter方法。setter也是如此。
2.对象关系映射
在没有比较成熟的第三方Model解析(如Mantle)前,ORM(Object Relational Mapping)可以使用KVC进行处理:
- (instancetype)init {
return [self initWithJSONDictionary:nil];
}
- (instancetype)initWithJSONDictionary:(NSDictionary *)anDictionary {
if (self = [super init]) {
[self setValuesForKeysWithDictionary:anDictionary];
}
return self;
}
- (void)setValue:(id)value forUndefinedKey:(NSString *)key {
NSLog(@"%@",key);
}
//
- (void)objectRelationalMapping {
NSDictionary *personInfoDictionary = @{
@"name" : @"zhangsan",
@"age" : @"30",
@"school" : @"Hist"
};
Person *p1 = [[Person alloc] initWithJSONDictionary:personInfoDictionary];
NSLog(@"%@",p1);
}
@end
这里主要使用了setValuesForKeysWithDictionary:方法。需要注意的是,需要实现setValue:forUndefinedKey:方法,因为当字典中包含的key在Person属性中并不一定存在,如果不存在的话,就会调用setValue:forUndefinedKey:。该方法默认抛出NSUndefinedKeyException异常。所以需要对其进行重写,避免Crash。
3. 使用keyPath实现多级访问
KVC除了setValue:forKey:方法,还有setValue:forKeypath:方法。具体使用如下:
_nameTextField.placeholder = @"请输入名字";
[_nameTextField setValue:UIColor.blackColor forKeyPath:@"placeholderLabel.textColor"];
这里一步操作,就完成了对placeholder颜色的变更。
4. 安全性访问
现在Person有一个friends方法,属性声明如下:
@property (nonatomic, copy) NSMutableArray *friends;
此时可以通过如下的方式进行设置friends:
NSArray *personsArray = ...;
Person *zhangsan = [[Person alloc] init];
zhangsan.name = @"zhangsan";
[[zhangsan mutableArrayValueForKey:@"friends"] addObjectsFromArray:personsArray];
这样就可以顺利将personsArray赋值给zhangsan的friends。接下来换个操作:将属性改为
@property (nonatomic, copy) NSArray *friends;
其他代码保持不变。再次执行,依然会给zhangsan.friends赋值。而且没有任何crash或者异常。由此可见,通过mutableArrayValueForKey这种方式进行处理,可以对于不可变的集合类型,提供安全的可变访问,即使是不可变数组,也可以增加数组元素。
5. 函数操作
使用KVC,可以很方便地进行一些基本的函数操作,例如:
NSMutableArray *personsArray = [[NSMutableArray alloc] initWithCapacity:5];
for (NSInteger i = 0; i < 5; i ++) {
NSString *tempName = [NSString stringWithFormat:@"people%ld",(long)i];
NSDictionary *personInfoDictionary = @{
@"name" : tempName,
@"age" : @(10 + i),
@"school" : @"Hist"
};
Person *tempPerson = [[Person alloc] initWithJSONDictionary:personInfoDictionary];
[personsArray addObject:tempPerson];
}
NSNumber *count = [personsArray valueForKeyPath:@"@count"];
NSNumber *sumAge = [personsArray valueForKeyPath:@"@sum.age"];
NSNumber *avgAge = [personsArray valueForKeyPath:@"@avg.age"];
NSNumber *maxAge = [personsArray valueForKeyPath:@"@max.age"];
NSNumber *minAge = [personsArray valueForKeyPath:@"@min.age"];
其中@表示是数组特有的键,而不是名为count的键。可以使用valueForKeyPath:快速进行计算。还可以进行更复杂的一些计算:
NSArray *array = @[@"apple", @"banner", @"apple", @"orange"];
NSLog(@"%@", [array valueForKeyPath:@"@distinctUnionOfObjects.self"]); // orange,apple,banner
NSArray *array1 = @[@[@"apple", @"banner"], @[@"apple", @"orange"]];
NSLog(@"%@", [array1 valueForKeyPath:@"@unionOfArrays.self"]); // apple,banner,apple,orange
NSMutableArray *personsArray1 = [[NSMutableArray alloc] initWithCapacity:5];
NSMutableArray *personsArray2 = [[NSMutableArray alloc] initWithCapacity:5];
for (NSInteger i = 0; i < 5; i ++) {
NSString *tempName = [NSString stringWithFormat:@"people%ld",(long)i];
NSDictionary *personInfoDictionary = @{
@"name" : tempName,
@"age" : @(10 + i),
@"school" : @"Hist"
};
Person *tempPerson = [[Person alloc] initWithJSONDictionary:personInfoDictionary];
i % 2 == 0 ? [personsArray1 addObject:tempPerson] : [personsArray2 addObject:tempPerson];
}
NSArray *personsArray = @[personsArray1, personsArray2];
NSLog(@"%@",[[personsArray valueForKeyPath:@"@unionOfArrays.age"] valueForKeyPath:@"@sum.self"]); // 60
类似上面的代码,可以使用KVC对复杂的操作进行简单化,而没有必要再使用for循环或者其他遍历操作。
三. KVC验证
Person *person = [[Person alloc] init];
[person setValue:[UIColor redColor] forKey:@"name"];
name是string类型,但是传入一个UIColor类型也没有异常或者Crash产生,这也是一个潜在的问题,一旦按照string使用name,就会出现问题。因此需要对value类型与key是否匹配进行判断。KVC提供了如下的方法:
Person *person = [[Person alloc] init];
UIColor *color = [UIColor redColor];
NSError *error = nil;
BOOL isValidate = [person validateValue:&color forKey:@"name" error:&error];
if (isValidate && !error) {
[person setValue:color forKey:@"name"];
}
发现依然可以设置成功,validateValue:forKey:error:方法竟然返回了YES。根据官方文档可知,此方法的默认实现将搜索接收方的类,寻找名称匹配validate
- (BOOL)validateName:(id *)ioValue error:(NSError **)error {
if ([*ioValue isKindOfClass:[NSString class]]) {
return YES;
}
return NO;
}