一、KVC的概念理解及常用方法
概念
KVC(Key-Value Coding)顾名思义,就是键值编码的意思。
在iOS
中,KVC就是通过使用属性的名称间接性来访问属性的方法
,通俗一点的理解就是可以通过对象属性名称(Key)直接给属性值(Value)编码(Coding)“编码”可以理解为“赋值”。
这个方法可以不通过getter/setter
方法来访问对象的属性。因为一个类的成员变量如果没有提供getter/sette
r的话,外界就失去了对这个变量的访问渠道。而KVC
则提供了一种访问的方法,这个在某些场合会很有威力。例如,直接修改系统控件的内部属性,并且KVC
还是KVO
,CoreData
的技术基础,他们都是利用了OC的动态性。
KVC常用的方法
- (void)setValue:(nullable id)value forKey:(NSString *)key; // 为对象的属性赋值
- (id)valueForKey:(NSString *)key; // 根据key取值
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath; // 为对象的属性赋值(包含了setValue:forKey:的功能,并且还可以对对象内的类的属性进行赋值)
- (nullable id)valueForKeyPath:(NSString *)keyPath; // 根据keyPath取值
- (void)setValuesForKeysWithDictionary:(NSDictionary<NSString *, id> *)keyedValues; // 对模型一次性赋值,前提是必须声明好所有对应的属性(key)
现在我们用例子简单的使用上面提到的KVC
常用到的方法
创建一个YGPerson和YGCar类,头文件分别为:
YGPerson.h
YGCar
ViewController
从上面三张图片的代码,我们分析一下:
YGPerson和YGCar两个类中,我们都是简单的声明了属性,但是YGPerson中,我们用@class引入了YGCar的头文件,将YGCar这个类的对象声明成我们的属性。而通过setValue: forKey:
和setVaule: forKeyPath:
分别能给YGPerson中的name属性和YGCar中的price属性赋值。
并且通过打印结果,我们知道KVC通过value:forKey
可以读取了属性的值,也进一步印证了我们开始的总结:KVC可以通过属性的名称间接的访问属性的方法,能赋值也能取值。
从下图来看,我们使用setValue: forKey:
给price赋值时就会报
"[setValue:forUndefindKey:]:this is not key value coding-compliant for key car.price"
的错误,意思是说在setValue:forUndefinKey 这方法中找不到car.price的属性。所以我们就能知道setValue:forKey
此方法是在YGPerson类中无法找到car.price这个属性,而setValue:forKeyPath
是通过.号来把一个一个key链接起来,这样就可以根据这个路径访问下去
通过上面的分析,KVC的注意点
1、在Person中我仅仅只是声明了@class Car,而没有引用#import "Car.h",然后在ViewController.m中便可以对其进行: [person setValue:[NSNumber numberWithFloat:price] forKeyPath:@"car.price"];这样子的赋值。所以说明KVC会去自动查找Car类进行赋值
2、-(void)setValue:(nullable id)value forKey:(NSString *)key;
你会发现value的值必须是id,也就是说不能传基本数据类型,必须是指针类型的变量,所以使用基本数据类型的时候,要装箱成为NSNumber类型。
3、key和keyPath的区别:
keyPath方法是集成了key的所有功能,也就是说对一个对象的一般属性进行赋值、取值,两个方法是通用的,都可以实现。但是对对象中的对象的属性进行赋值,只有keyPath能够实现
4、当key的值是没有定义的,valueForUndefinedKey:这个方法会被调用,如果你自己写了这个方法,key的值出错就会调用到这里来
5.、因为类key反复嵌套,所以有个keyPath的概念,keyPath就是用.号来把一个一个key链接起来,这样就可以根据这个路径访问下去
setValuesForKeysWithDictionary:的巧妙使用(字典转模型)
-(instancetype)initWithDict:(NSDictionary *)dict{
if (self = [super init]) {
[self setValuesForKeysWithDictionary:dict];
}
return self;
}
注意点:
- 字典转模型的时候,字典中的某一个key一定要在模型中有对应的属性
- 如果一个模型中包含了另外的模型对象,是不能直接转化成功的。
- 通过kvc转化模型中的模型,也是不能直接转化成功的
- 底层还是调用了setValue: forKey:
二、KVC的应用
1、修改系统控件的内部属性(Runtime+KVC)
例如,界面要设计成这样
但我们平时做轮播图的效果是这样的,这显然不是我们的效果,但是要如何修改UIPageControl才能改成我们想要的横线的效果呢?
那我们试想一下,UIPageControl默认的图片就是一个圆点,那这个圆点是可能是一张图片,它的属性应该会有类型是UIImage这样的属性,那我们查看一下他的头文件,看是否存在此类型的属性。
从头文件中,我们找不到我们想要相关的UIImage或UIImageView这样的属性类型,那我们想深入的查看一下UIPageControl.m文件里的属性,可能就是在.m文件里的私有属性,那我们如何能看到.m文件的成员属性呢?这就要通过runtime遍历出UIPageControl所有属性(包括私有属性)。
/**
* 运行时(runtime),获取所有成员变量
*/
- (void)getMemberVariables
{
unsigned ivarCount;
Ivar *ivars = class_copyIvarList([UIPageControl class], &ivarCount);
for (int i = 0; i < ivarCount; i ++) {
NSString *varibale = [NSString stringWithUTF8String:ivar_getName(ivars[i])];
NSLog(@"%@",varibale);
}
}
我们通过此方法打印出UIPageControl的所有属性,发现有_pageImage和_currentPageImage 两个属性是符合我们修改当前pageControl的图片和默认pageControl的图片,如下我们就能修改了我们想要的UIPageControl的图片了。
通过KVC来修改
UIPageControl *pageControl = [[UIPageControl alloc ] init];
[pageControl setValue:[UIImage imageNamed:%@"nomal.png"] forKey:@"_pageImage"];
[pageControl setValue:[UIImage imageNamed:%@"selected.png"] forKey:@"_currentPageImage"]
2、在xib/Storyboard中,也可以使用KVC,下面是在xib中使用KVC把图片边框设置成圆角
3、在对模型转换时,会出现警告。
例如:我们要将下列字典数据转化为模型
{
"id" :"23"
"name" :"zhangrm"
"age" :"25"
"like" :"oc"
}
当我们在模型类中定义时:如下。我们发现id是oc中的关键字,会报警告⚠️
@property (nonatomic, strong) NSString *id;
@property (nonatomic, strong) NSString *name;
@property (nonatomic, strong) NSString *age;
@property (nonatomic, strong) NSString *like;
虽然可以使用以下方法,对模型中的成员变量进行统一设置,但是出现警告总归是不好的:
- (void)setValuesForKeysWithDictionary:(NSDictionary *)keyedValues;
既然这样,可以选择手动一个个去实现。但是这样在数据少的时候可以试试,在数据比较多时就不太现实了,程序的可扩展性也不好。
两种解决方法:
方法1.重写setValue:forKey:
setValuesForKeysWithDictionary:的底层是调用setValue:forKey:的,所以可以考虑重写这个方法,并且判断其key是id时,手动转换成模型的成员变量名,这里假设把id对应成以下属性:
@property (nonatomic, strong) NSString *ID;
有了对应的属性名后,就可以重写底层方法了
- (void)setValue:(id)value forKey:(NSString *)key
{
if ([key isEqualToString:@"id"]) {
[self setValue:value forKeyPath:@"ID"];
}else{
[super setValue:value forKey:key];
}
}
这样,当使用setValuesForKeysWithDictionary:就不会出现模型中找不到对应的成员变量的错误了,但是必须注意,在使用setValuesForKeysWithDictionary,属性必须和字典中的key一一对应。
方法二:使用rumtime
+ (instancetype)objcWithDict:(NSDictionary *)dict mapDict:(NSDictionary *)mapDict
{
id objc = [[self alloc] init];
// 遍历模型中成员变量
unsigned int outCount = 0;
Ivar *ivars = class_copyIvarList(self, &outCount);
for (int i = 0 ; i < count; i++) {
Ivar ivar = ivars[i];
// 成员变量名称
NSString *ivarName = @(ivar_getName(ivar));
// 获取出来的是`_`开头的成员变量名,需要截取`_`之后的字符串
ivarName = [ivarName substringFromIndex:1];
id value = dict[ivarName];
// 由外界通知内部,模型中成员变量名对应字典里面的哪个key
// ID -> id
if (value == nil) {
if (mapDict) {
NSString *keyName = mapDict[ivarName];
value = dict[keyName];
}
}
[objc setValue:value forKeyPath:ivarName];
}
return objc;
}
使用方法
+ (instancetype)itemWithDict:(NSDictionary *)dict
{
// 传入key和实例变量名的映射字典@{@"ID":@"id"}
TPCItem *item = [TPCItem objcWithDict:dict mapDict:@{@"ID":@"id"}];
return item;
}
KVC底层原理分析
setValue:forKey:赋值原理如下:
- 去模型中查找有没有对应的setter方法:例如:setIcon方法,有就直接调用这个setter方法给模型这个属性赋值[self setIcon:dic[@"icon"]];
- 如果找不到setter方法,接着就会去寻找有没有icon属性,如果有,就直接访问模型中的icon属性,进行赋值,icon=dict[@"icon"];
- 如果找不到icon属性,接着又会去寻找_icon属性,如果有,直接进行赋值_icon=dict[@"icon"];
- 如果都找不到就会报错:[<Flag 0X7fb74bc7a2c0> setValue:forUndefinedKey:]
- 如果对某个类,不允许使用KVC,可以通过设置 accessInstanceVariablesDirectly 控制。
KVC内部的实现
比如说如下的一行KVC的代码:
[site setValue:@"sitename" forKey:@"name"];
就会被编译器处理成:
SEL sel = sel_get_uid ("setValue:forKey:");
IMP method = objc_msg_lookup (site->isa,sel);
method(site, sel, @"sitename", @"name");
这下KVC内部的实现就很清楚的清楚了:一个对象在调用setValue的时候,(1)首先根据方法名找到运行方法的时候所需要的环境参数。(2)他会从自己isa指针结合环境参数,找到具体的方法实现的接口。(3)再直接查找得来的具体的方法实现。