KVC(键值编码,Key-value coding),可以通过key直接给对象的属性赋值或者获取属性值,这样我们可以在运行时动态的修改或获取对象的属性值.
1.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来设值
2.KVC中setValue:(id)value forKey:(NSString *)key
的执行顺序
- 1.先调用set<key>方法,通过setter方法完成设置,如果没有找到set<key>方法,KVC会调用
+(BOOL)accessInstanceVariablesDirectly
方法,如果返回NO
就调用- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key;
,如果返回YES
则继续检查. - 2.检查是否有_<key>的成员变量存在,如果有就赋值.
- 3.如果既没有set<key>方法,又没有_<key>成员变量,那么KVC就查找有没有_is<key>的成员变量,如果有就赋值
- 4.如果既没有set<key>方法和_<key>成员变量,又没有_is<key>的成员变量,那么KVC就继续查找有没有is<key>的成员变量,如果有就赋值
- 5.如果上述的成员变量和方法都不存在,就调用
- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key;
方法,开发者可以重写这个方法,默认是抛出异常.
3.KVC中的- (nullable id)valueForKey:(NSString *)key
- 1.首先查找-get<Key>, -<key>, or -is<Key>方法,如果结果是一个对象,就直接返回,如果是被NSNumber支持的类型,就转换成NSNumber类型并返回.
- 2.如果上诉方法未找到,就查找-countOf<Key>, -indexIn<Key>OfObject:, -objectIn<Key>AtIndex:,-<key>AtIndexes:
- 3.如果上诉方法未找到,就查找-countOf<Key> and -objectIn<Key>AtIndex:
4.KVC中valueForKeyPath
- 1.先查看-get<Key>, -<key>, or -is<Key>,如果这些方法存在,就执行.如果结果是一个指针类型的变量,就直接返回,如果是被
NSNumber
支持的类型,就返回NSNumber
. - 2.如果上述方法未找到,就查找-countOf<Key>, -indexIn<Key>OfObject:, -objectIn<Key>AtIndex:, -<key>AtIndexes:方法,如果能找到count方法,index方法和另外两个方法中的任一个,就返回一个集合(包含NSOrderedSet的所有方法).
- 3.如果上诉方法也未找到,就查找-countOf<Key>, -objectIn<Key>AtIndex:和-<key>AtIndexes:
5.KVC中的KeyPath
正在整理
6.KVC中的- (BOOL)validateValue:(inout id _Nullable * _Nonnull)ioValue forKey:(NSString *)inKey error:(out NSError **)outError;
方法
这个方法默认会去调用类中的-(BOOL)validate<key>:(id *)value error:(out NSError * _Nullable __autoreleasing *)outError
方法,如果有这个方法就调用,没有的话直接返回YES
// 在ViewController.m中
// 1.创建Person对象,Person中有一个属性为name
Person *p = [[Person alloc] init];
p.name = @"王亚龙";
// 2.调用方法,这个方法默认会去Person中查找-(BOOL)validateName:(id *)value error:(out NSError * _Nullable __autoreleasing *)outError方法
[p validateValue:&value forKey:@"name" error:&error];
// 在Person.m中
// 实现方法,在方法中可以做一些判断
-(BOOL)validateName:(id *)value error:(out NSError * _Nullable __autoreleasing *)outError
{
NSString *myName = *value;
if ([myName isEqualToString:@"wang"]) {
return YES;
}
return NO;
}
当开发者需要验证能不能用KVC设定某个值时,可以调用
- (BOOL)validateValue:(inout id _Nullable * _Nonnull)ioValue forKey:(NSString *)inKey error:(out NSError **)outError;
去验证,如果实现了-(BOOL)validate<key>:(id *)value error:(out NSError * _Nullable __autoreleasing *)outError
就会调用,需要注意的是,KVC在设值时不会自动去验证,需要开发者手动去验证.