KVC -- Key Value Coding(键值编码)
在iOS开发过程中,允许开发者通过key直接访问对象属性或对象属性进行赋值。
KVC原理(赋值、取值流程)
-
赋值流程:调用setValue:forKey:方法
执行流程:1、访问器方法 2、实例变量 3、setValue:forUndefinedKey:异常崩溃
1、按照顺序查找名为set<Key>或 _ set<Key>的第一个访问器。如果找到,则使用输入值(或未包装值,视需要而定)调用它并完成。 访问器方法必须带一个参数,否也无效
2、如果没有找到简单的访问器,并且类方法accessInstanceVariablesDirectly返回YES,那么查找一个名为_<key>, _is< key>, <key>,或is<key>的实例变量,顺序如下。如果找到,则使用输入值(或未包装值)直接设置变量并完成。
3、在没有找到访问器或实例变量时,调用setValue:forUndefinedKey:。这将在默认情况下引发一个异常,但是NSObject的子类可能提供特定键的行为(转模型中,返回数据key为关键字id等,重写该方法并赋值给对应模型属性值)。
-
取值流程:调用valueForKey:
主要流程:1、访问器方法 2、实例变量 3、valueForUndefinedKey:异常崩溃
1、在实例中搜索名称为get<Key>、<Key>、is<Key>或_ < Key>的第一个访问器方法。如果找到,则调用它,并带着结果继续步骤5。否则继续执行下一步。'简单访问器方法' 访问方法不一定返回值
2、2 3 '集合访问方法组',具体访问官方文档
4、如果没有找到简单的访问器方法或集合访问方法组,并且如果接收方的类方法accessinstancvariablesdirectly返回YES,则按此顺序搜索名为_<key>、_is< key>、<key>或is<key>的'实例变量'。如果找到,直接获取实例变量的值,然后继续步骤5。否则,请执行步骤6。
5、如果检索到的属性值是一个对象指针,简单地返回结果;如果该值是NSNumber支持的标量类型,则将其存储在NSNumber实例中并返回;如果结果是NSNumber不支持的标量类型,则转换为NSValue对象并返回该对象。
6、如果其他都失败了,调用valueForUndefinedKey:。默认情况下,这将引发异常,但NSObject的子类可能提供特定于键的行为。
参考官方文档说明 上文赋值取值流程步骤由有道词典翻译。
//代码实现
@interface KCModel : NSObject{
@public
// NSString *_name;
// NSString *_isName;
// NSString *name;
// NSString *isName;
}
/////属性会生成setter getter方法证明:+accessInstanceVariablesDirectly返回NO时,kvc赋值、取值都成功了。
//@property (nonatomic,copy) NSString *name;
@end
#import "KCModel.h"
@implementation KCModel
#pragma mark - KVC setValue:forKey: 赋值流程
//*步骤1 第一访问器 参数名称可以不一样
//- (void)setName:(NSString *)param{
// self->name = @"111";
// NSLog(@"%s\t设置的成员变量值:%@", __func__, param);
//}
//
//- (void)_setName:(NSString *)name{
// self->name = @"_222";
// NSLog(@"%s\t设置的成员变量值:%@", __func__, name);
//}
#//[注意]:以下两个方法不符合setter方法 必须带一个参数,但参数名称可以不一样是name
//- (void)setName:(NSString *)name a:(NSString *)a{
// self->name = @"111";
// NSLog(@"%s\t name:%@ a:%@", __func__, name, a);
//}
//
//- (void)_setName{
// self->name = @"_222";
// NSLog(@"%s\t", __func__);
//}
/**步骤2 访问实例变量(访问顺序由上至下)
NSString *_name;
NSString *_isName;
NSString *name;
NSString *isName;
*/
//步骤2的前提条件,该类方法默认返回YES;如果为NO,则进入步骤3
//+ (BOOL)accessInstanceVariablesDirectly{
//
// return NO;
//}
//*步骤3
//步骤3未实现crash info *** Terminating app due to uncaught exception 'NSUnknownKeyException', reason: '[<KCModel 0x6000014a84b0> setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key name.'
//- (void)setValue:(id)value forUndefinedKey:(NSString *)key{
// NSLog(@"%s\t设置的键值%@:%@", __func__, key, value);
//}
#pragma mark - KVC setValue:forKey: 取值流程
//*步骤1、访问第一访问器(简单的访问器方法)
//- (NSString *)getName{
// NSLog(@"%s", __func__);
// return @"getName";
//}
//- (NSString *)name{
// NSLog(@"%s", __func__);
// return @"name";
//}
//
//- (NSString *)isName{
// NSLog(@"%s", __func__);
// return @"isName";
//}
//- (NSString *)_name{
// NSLog(@"%s", __func__);
// return @"_name";
//}
#//[注意]:getter访问器方法 无返回也可以访问
//- (void)getName{
// NSLog(@"%s", __func__);
//
//}
//- (void)name{
// NSLog(@"%s", __func__);
//}
/**[注意]:getter访问器方法,如果返回值类型void * 直接跳过步骤进入下一步骤;
如果是返回是id,会访问当前方法。有兴趣的同学可以玩玩看*/
//- (void *)isName{
// NSLog(@"%s", __func__);
// return @"isName";
//}
//- (void)_name{
// NSLog(@"%s", __func__);
//
//}
/**步骤4 访问实例变量(访问顺序由上至下)
NSString *_name;
NSString *_isName;
NSString *name;
NSString *isName;
*/
//步骤4的前提条件,该类方法默认返回YES;如果为NO,则进入步骤3
//+ (BOOL)accessInstanceVariablesDirectly{
//
// return YES;
//}
//步骤6未实现的crash info*** Terminating app due to uncaught exception 'NSUnknownKeyException', reason: '[<KCModel 0x600000710260> valueForUndefinedKey:]: this class is not key value coding-compliant for the key name.'
//步骤6
- (id)valueForUndefinedKey:(NSString *)key{
NSLog(@"%s\t设置的键%@", __func__, key);
return @"步骤6";
}
@end
#mark pragma - 调用实现
-(void)viewDidLoad {
[super viewDidLoad];
self.view.backgroundColor = UIColor.whiteColor;
//kc为当前vc的属性
self.kc = [KCModel alloc];
//KVC赋值流程
[self.kc setValue:@"niuniu" forKey:@"name"];
//赋值验证
// NSLog(@"_name:%@", self.kc->_name);
// NSLog(@"_isName:%@", self.kc->_isName);
// NSLog(@"name:%@", self.kc->name);
// NSLog(@"isName:%@", self.kc->isName);
//KVC取值流程
//取值验证 -- 访问实例变量
// self.kc->_name = @"1";
// self.kc->_isName = @"2";
// self.kc->name = @"3";
// self.kc->isName = @"4";
//KVC取值
id value = [self.kc valueForKey:@"name"];
// NSLog(@"实际值:%@, %@", value, self.kc.name);
NSLog(@"实际值:%@", value);
}
应用场景:数据转模型、iOS13前访问UITextField成员变量等
KVO相关可查看该文章 KVO剖析