KVC概念
KVC(Key-value coding)
键值编码,是对NSObject
的扩展来实现的,Objective-C
中有个显式的NSKeyValueCoding
类别名--NSObject(NSKeyValueCoding)
,故而所有基于NSObject
创建的对象都可使用
KVC相关方法
- 常见的四种方法
- (nullable id)valueForKey:(NSString *)key; //直接通过Key来取值
- (void)setValue:(nullable id)value forKey:(NSString *)key; //通过Key来设值
- (nullable id)valueForKeyPath:(NSString *)keyPath; //通过KeyPath来取值
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath; //通过KeyPath来设值
- 其他方法
+ (BOOL)accessInstanceVariablesDirectly;
//默认返回YES,表示如果没有找到Set<Key>方法的话,会按照_key,_iskey,key,iskey的顺序搜索成员,设置成NO就不这样搜索
- (BOOL)validateValue:(inout id __nullable * __nonnull)ioValue forKey:(NSString *)inKey error:(out NSError **)outError;
//KVC提供属性值正确性验证的API,它可以用来检查set的值是否正确、为不正确的值做一个替换值或者拒绝设置新值并返回错误原因。
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;
//这是集合操作的API,里面还有一系列这样的API,如果属性是一个NSMutableArray,那么可以用这个方法来返回。
- (nullable id)valueForUndefinedKey:(NSString *)key;
//如果Key不存在,且没有KVC无法搜索到任何和Key有关的字段或者属性,则会调用这个方法,默认是抛出异常。
- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key;
//和上一个方法一样,但这个方法是设值。
- (void)setNilValueForKey:(NSString *)key;
//如果你在SetValue方法时面给Value传nil,则会调用这个方法
- (NSDictionary<NSString *, id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;
//输入一组key,返回该组key对应的Value,再转成字典返回,用于将Model转到字典。
KVC设值流程
通过 KVC官方文档 得知,当调用setValue:forKey:
设置属性value
时,其底层的执行流程如下:
- 首先调用setter方法,按照查找顺序为set<Key>:-> _set<Key> -> setIs<Key>
- (void)setName:(NSString *)name{
NSLog(@"%s - %@",__func__,name);
}
- (void)_setName:(NSString *)name{
NSLog(@"%s - %@",__func__,name);
}
- (void)setIsName:(NSString *)name{
NSLog(@"%s - %@",__func__,name);
}
如上代码:
1. 如果任一set
方法实现,则可完成属性赋值
注:首字母大小写要符合
KVC
的命名规则
2.如果set方法均没有实现则走下面流程
- 查找
accessInstanceVariablesDirectly
是否返回YES
- 如果为
YES
,按顺序查找名称为_<key>
、_is<Key>
、<key>
或is<Key>
的实例变量,任一变量存在
则可完成赋值 - 如果为
NO
,则继续下面流程
- 如果为
- 如果
set
方法或者成员变量
都不
存在,系统将会执行该对象的setValue:forUndefinedKey:
方法,默认是抛出异常
KVC取值流程
按顺序搜索实例,查找名称为
get<Key>、<key>、is<Key>或_<key>
的第一个访问器方法。如果找到,请调用它,然后继续进行第5步
并得出结果。否则请继续下一步
-
如果没有找到简单的访问器方法,请在实例中搜索名称与模式
countOf<Key>
和objectIn<Key>AtIndex:
(对应NSArray
类定义的原始方法)和<key>AtIndexes:
(对应NSArray方法objectsAtIndexes:
)的方法。代理对象随后将其接收的任何NSArray
消息转换为countOf<Key>
、objectIn<Key>AtIndex:
和<key>AtIndexes:
消息的某种组合,转换为创建它的键值编码合规对象。如果原始对象也实现了名称为get<Key>:range:
的可选方法,代理对象也会在适当的时候使用该方法。实际上,与键值编码兼容对象一起工作的代理对象允许基础属性表现得像NSArray
一样,即使它不是- 如果找到了其中的第一个和其他两个中的至少一个,请创建一个响应所有
NSArray
方法的集合代理对象,并返回该对象。否则,请继续第3步。
- 如果找到了其中的第一个和其他两个中的至少一个,请创建一个响应所有
-
如果没有找到上面的几种方法,则会同时查找
countOf <Key>,enumeratorOf<Key>和memberOf<Key>
这三个方法- 如果找到了所有三种方法,请创建一个响应所有
NSSet
方法的集合代理对象,并返回该对象。否则,请继续第4步。
- 如果找到了所有三种方法,请创建一个响应所有
如果还没有找到,检查类方法InstanceVariablesDirectly是否YES,依次搜索_<key>,_is<Key>,<key>或is<Key>的实例变量,如果搜到,直接获取实例变量的值,进入【第五步】
-
根据搜索到的属性值的类型,返回不同的结果
如果是对象指针,则直接返回结果如果是NSNumber支持的标量类型,则将其存储在NSNumber实例中并返回它
如果是是NSNumber不支持的标量类型,请转换为NSValue对象并返回该对象
-
如果上面5步的方法均失败,系统会执行该对象的valueForUndefinedKey:方法,默认抛出NSUndefinedKeyException类型的异常
KVC中keyPath实现
@interface Infor()
@property (nonatomic,copy)NSString * height;
@end
@implementation Infor
@end
@interface People()
@property (nonatomic,copy) NSString* name;
@property (nonatomic,strong) Infor* infor;
@property (nonatomic,assign) NSInteger age;
@end
@implementation People
@end
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
People* people1 = [People new];
Infor* infor1 = [Infor new];
infor1.height = @"180";
people1.infor = infor1;
NSString * he = people1.infor.height;
NSString * he1 = [people1 valueForKeyPath:@"infor.height"];
NSLog(@"height1:%@ height2:%@",he,he1);
[people1 setValue:@"177" forKeyPath:@"infor.height"];
he = people1.infor.height;
he1 = [people1 valueForKeyPath:@"infor.height"];
NSLog(@"height1:%@ height2:%@",he,he1);
}
//[10:08:48.535] -[ViewController viewDidLoad] [第44行] height1:180 height2:180
//[10:08:48.536] -[ViewController viewDidLoad] [第48行] height1:177 height2:177
通过代码得知,如果是复杂的数据类型,一层一层解析比较麻烦,如果只是需要其中的一个或者几个变量,就可以通过key
进行直接获取,层级关系通过.
来进行链接,要保证键值的正确性
,不然就会报错
KVC自定义实现
自定义完整代码