iOS KVC 键值编码

1 什么是键值编码

键值编码，key value coding， 简称KVC

KVC, 通过字符串间接的获取、改变对象的状态。

2 KVC的基本使用

通过字符串获取对象的状态

接口	oc对象的实例方法：- (id)valueForKey:(NSString *)key;
实例	找name属性或者name方法 如果找不到，就找name和_name实例变量NSString *name = [car valueForKey:@”name”];

通过字符串设置对象的状态

接口	oc对象的实例方法：- (void)setValue:(id)value forKey:(NSString *)key;
实例	找name属性或者setName方法 如果找不到，就找name和_name实例变量 [car setValue:@”北京” forKey:@”name”];

car.h

struct size {
float length, width, height;
};

@interface Car : NSObject
{
NSString *serial;  //出厂编号
}

@property (nonatomic, copy) NSString *name; //品牌
@property (nonatomic) int years;
@property (nonatomic) CGRect rect;
@property (nonatomic, readonly) struct size  size;

@end

car.m

@implementation Car

- (instancetype) init
{
self = [super init];
if (self) {
_name = @"BYD";
_years = 3;
serial = @"12346789";
_rect = CGRectMake(10, 20, 30, 40);

_size.length = 5.0;
_size.width = 1.8;
_size.height = 1.7;
}
return self;
}

@end

main.m

int main(int argc, const char * argv[]) {
@autoreleasepool {
Car *car = [[Car alloc] init];

//找name属性或者name方法
NSString *name = [car valueForKey:@"name"];
NSLog(@"%@", name);

//找serial属性和serial方法都找不到
//就找serial和_serail实例变量
NSString *serial = [car valueForKey:@"serial"];
NSLog(@"%@", serial);

//valueForKey读取的值如果是标量类型（比如int,float等）,则会自动装箱，返回NSNumber类型
NSNumber *years = [car valueForKey:@"years"];
NSLog(@"%d", [years intValue]);

//valueForKey读取的值如果是结构体类型, 则会自动装箱成NSValue类型
//常用结构体类型，可以使用对应的方法直接拆箱，比如rectValue
NSValue *rect = [car valueForKey:@"rect"];
CGRect rect2 = [rect rectValue];
NSLog(@"%.2f, %.2f, %.2f, %.2f",
rect2.origin.x, rect2.origin.y, rect2.size.width, rect2.size.height);

//valueForKey读取的值如果是结构体类型, 则会自动装箱成NSValue类型
//自定义的结构体类型，可以使用通用的getValue:方法拆箱
NSValue *size = [car  valueForKey:@"size"];
struct size size2;
[size getValue:&size2];
NSLog(@"%.2f, %.2f, %.2f", size2.length, size2.width, size2.height);

//设置
[car setValue:@"北京" forKey:@"name"];
NSLog(@"%@", car.name);

//设置标量值时，参数需要自己装箱
//在setValue:forKey:方法内部，会自动把表示值的参数进行拆箱
[car setValue:[NSNumber numberWithInt:4] forKey:@"years"];
NSLog(@"%d", car.years);
}
return 0;
}

3 键路径

接口	-(id)valueForKeyPath:(NSString *)keyPath;
实例	NSString *engineName = [car valueForKeyPath:@”engine.name”];

4 整体操作

键路径中，如果某个属性是一个集合类型（比如，数组、字典），则路径其后的部分将分别作用于该集合中的每一个对象。

接口	1）valueForKeyPath: 对集合中的每个成员发送getter消息,并返回一个数组 2）setValue: forKeyPath:对集合中的每个成员发送setter消息
实例	NSArray *pressures = [car valueForKeyPath:@”tires.pressure”];[car setValue:@15 forKeyPath:@”tires.pressure”];

5 使用KVC实现快速运算

@count

对@count左侧的的值统计总数, 返回NSNumber类型

接口	在valueForKeyPath:中的键路径中使用@count
实例	NSNumber *number = [car valueForKeyPath:@”tires.@count”];NSLog(@”tire count = %d”, [number intValue]);

@sum

接口	在valueForKeyPath:中的键路径中使用@sum
实例	NSNumber *pressureSum = [car valueForKeyPath:@”tires.@sum.pressure”]; NSLog(@”pressureSum = %2.f”, [pressureSum floatValue]);

@avg

与 @sum类似，但是计算的是平均值

接口	在valueForKeyPath:中的键路径中使用@avg
实例	NSNumber *pressureAvg = [car valueForKeyPath:@”tires.@avg.pressure”];NSLog(@”tire pressureAvg = %2.f”, [pressureAvg floatValue]);

@max

与 @sum类似，但是计算的是最大值。

@min

与 @sum类似，但是计算的是最大值。

@distinctUnionOfObjects

返回一个数组，重复值只取一个。

接口	在valueForKeyPath:中的键路径中使用@ distinctUnionOfObjects
实例	NSArray *array2 = [car valueForKeyPath:@”tires.@distinctUnionOfObjects.name”];NSLog(@”%@”, array2); //{3M}

6 使用KVC实现批处理

批处理获取多个属性的值，返回一个字典

接口	(NSDictionary )dictionaryWithValuesForKeys:(NSArray )keys;
实例	NSArray *keys = @[@”name”, @”years”];NSDictionary *values = [car dictionaryWithValuesForKeys:keys];NSLog(@”%@”, values);

批处理设置多个属性的值.

接口	(void)setValuesForKeysWithDictionary:(NSDictionary *)keyedValues;
实例	NSDictionary *dict = @{@”name”:@”BMW”, @”years”:@”5”};[car setValuesForKeysWithDictionary:dict];NSLog(@”%@, %d”, car.name, car.years);

7 处理未定义的键

使用KVC时，如果指定的键或键路径，没有直到对应的属性、方法或实例变量，则会抛出异常而终止。

解决方案：

使用valueForUndefinedKey:和setValue:forUndefinedKey:

对所有未定义的键做统一处理。

原理：

添加一个可变字典实例变量，

当遇到未定义的键时，将会调用对象的valueForUndefinedKey：方法，

在该方法内，把用户设置的未定义的键、值都保存到这个字典中。

这样就可以对该对象使用任意的键了。

demo

car.h

@interface Car : NSObject
{
NSMutableDictionary *_stuff;
}
@end

car.m

- (void)setValue:(id)value forUndefinedKey:(NSString *)key
{
//对_stuff实现惰性初始化，因为一般情况下不会使用未定义的键
if (_stuff == nil) {
_stuff = [[NSMutableDictionary alloc] init];
}
_stuff[key] = value;
}

- (id)valueForUndefinedKey:(NSString*)key
{
return _stuff[key];
}

main.m

int main(int argc, const char * argv[]) {
@autoreleasepool {
Car *car = [[Car alloc] init];

//直接使用未定义的键
[car setValue:@2700 forKey:@"weight"];
NSNumber *weight = [car valueForKey:@"weight"];
NSLog(@"%d kg", [weight intValue]);
}
return 0;
}