简述：对私有变量进行赋值。
- 在系统框架 Foundation 中 NSKeyValueCoding.h 有更多的一些方法。
- KVC具体应用场景：有待细究（还望告知）
单个类KVC 赋值基础数据。
- 赋值：setValue: forKey:
- 获取：valueForKey:
例如有一个 Person 的类，包含一些私有属性。
@interface Person ()
{
// 大致包含以下几类数据
NSString *_name;
NSNumber *_age;
NSArray *_colors;
NSDictionary *_family;
NSMutableDictionary *_works;
NSOrderedSet *_aOrderSet;
NSSet *_aSet;
NSMutableArray *_aMuArray;
NSMutableSet *_aMuSet;
NSMutableOrderedSet *_aMuOrderSet;
}
@end
在其他调用时可以使用KVC，进行赋值，以及获取。类似的不重复举例。
Person *aPerson = [[Person alloc] init];
// NSString
[aPerson setValue:@"村长" forKey:@"_name"];
NSString *value_name = [aPerson valueForKey:@"name"];
NSLog(@"%@",value_name);
// NSNumber
[aPerson setValue:@12 forKey:@"_age"];
NSNumber *value_age = [aPerson valueForKey:@"_age"];
NSLog(@"%@",value_age);
// NSArray
[aPerson setValue:@[[UIColor redColor],[UIColor grayColor]] forKey:@"_colors"];
NSArray *value_colors = [aPerson valueForKey:@"_colors"];
self.view.backgroundColor = value_colors[0];
// NSMutableArray
NSMutableArray *muarr = [NSMutableArray array];
[muarr addObject:@"one"];
[muarr addObject:@"two"];
[aPerson setValue:muarr forKey:@"_aMuArray"];
NSMutableArray *value_muArr = [aPerson mutableArrayValueForKey:@"_aMuArray"];
NSLog(@"%@",value_muArr);
[value_muArr addObject:@"three"];
NSLog(@"%@",value_muArr);
系统还封装了 KVC 开关 以及 检查
- 如果对某个类，不允许使用KVC，可以通过设置 accessInstanceVariablesDirectly 控制。
// 在该类的内部，重写此方法，外部使用KVC时，禁用没有写set get 方法的属性值。
// 注意：对于 @property 定义的属性可以 KVC
+ (BOOL)accessInstanceVariablesDirectly{
return NO;
}
- 赋值检查
// 在类的内部，进行检查，不符合要求 返回NO ，提供外部参考。
- (BOOL)validateValue:(inout id _Nullable __autoreleasing *)ioValue forKey:(NSString *)inKey error:(out NSError * _Nullable __autoreleasing *)outError{
if ([inKey isEqualToString:@"colors"] && [*ioValue isKindOfClass:[NSArray class]]) {
return YES;
} else {
return NO;
}
}
// 外部 使用时，先判断是否符合要求，再使用KVC。
NSError *error;
NSString *apoint = @"name";
if ([aPerson validateValue:&apoint forKey:@"_colors" error:&error]) {
NSLog(@"可以赋值 apoint");
[aPerson setValue:apoint forKey:@"_colors"];
} else {
NSLog(@"不可以赋值 apoint");
NSLog(@"%@",error.debugDescription);
}
多重嵌套类 KVC
- 赋值：setValue: forKeyPath:
- 获取：valueForKeyPath:
例如：有一个Person 类，拥有一个 Cat 类。
@interface Person ()
@property (nonatomic, strong) Cat *mycat;
@end
Cat 类具有属性 name
@interface Cat ()
@property (nonatomic, strong) NSString *name;
@end
外部使用时
Person *aPerson = [[Person alloc] init];
Cat *acat = [[Cat alloc] init];
// 链接关系 非常关键
[aPerson setValue:acat forKey:@"mycat"];
// 路径赋值 取值
[aPerson setValue:@"我的猫咪" forKeyPath:@"mycat.name"];
NSString *value_mycat_name = [aPerson valueForKeyPath:@"mycat.name"];
NSLog(@"%@",value_mycat_name);
其他 还有重写 未定义的 key ，nil Value 的key 等 几个方法。
- 简单了解重写
// 多 定义了一个 key 用于存 一些外部传入没有的key
@property (nonatomic, strong) NSString *undefineKey;
// 重写 取 没有定义key 时 返回
- (nullable id)valueForUndefinedKey:(NSString *)key{
return [self valueForKey:self.undefineKey];
}
// 重写 赋值没有定义的key时，赋值
- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key{
[self setValue:value forKeyPath:self.undefineKey];
}
// 重写 赋值为nil 时 ，修改赋值
- (void)setNilValueForKey:(NSString *)key{
[self setValue:@"" forKeyPath:key];
}
其他
- 剩余一些方法 例如 ：
setValuesForKeysWithDictionary 等。待开拓
FOUNDATION_EXPORT NSString *const NSUndefinedKeyException;
FOUNDATION_EXPORT NSString *const NSAverageKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSCountKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSDistinctUnionOfArraysKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSDistinctUnionOfObjectsKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSDistinctUnionOfSetsKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSMaximumKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSMinimumKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSSumKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSUnionOfArraysKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSUnionOfObjectsKeyValueOperator;
FOUNDATION_EXPORT NSString *const NSUnionOfSetsKeyValueOperator;
@interface NSObject(NSKeyValueCoding)
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;
- (NSMutableOrderedSet *)mutableOrderedSetValueForKey:(NSString *)key NS_AVAILABLE(10_7, 5_0);
- (NSMutableSet *)mutableSetValueForKey:(NSString *)key;
- (nullable id)valueForKeyPath:(NSString *)keyPath;
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath;
- (BOOL)validateValue:(inout id __nullable * __nonnull)ioValue forKeyPath:(NSString *)inKeyPath error:(out NSError **)outError;
- (NSMutableArray *)mutableArrayValueForKeyPath:(NSString *)keyPath;
- (NSMutableOrderedSet *)mutableOrderedSetValueForKeyPath:(NSString *)keyPath NS_AVAILABLE(10_7, 5_0);
- (NSMutableSet *)mutableSetValueForKeyPath:(NSString *)keyPath;
- (NSDictionary<NSString *, id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;
- (void)setValuesForKeysWithDictionary:(NSDictionary<NSString *, id> *)keyedValues;
@end
@interface NSArray<ObjectType>(NSKeyValueCoding)
- (id)valueForKey:(NSString *)key;
- (void)setValue:(nullable id)value forKey:(NSString *)key;
@end
@interface NSDictionary<KeyType, ObjectType>(NSKeyValueCoding)
- (nullable ObjectType)valueForKey:(NSString *)key;
@end
@interface NSMutableDictionary<KeyType, ObjectType>(NSKeyValueCoding)
- (void)setValue:(nullable ObjectType)value forKey:(NSString *)key;
@end
@interface NSOrderedSet<ObjectType>(NSKeyValueCoding)
- (id)valueForKey:(NSString *)key NS_AVAILABLE(10_7, 5_0);
- (void)setValue:(nullable id)value forKey:(NSString *)key NS_AVAILABLE(10_7, 5_0);
@end
@interface NSSet<ObjectType>(NSKeyValueCoding)
- (id)valueForKey:(NSString *)key;
- (void)setValue:(nullable id)value forKey:(NSString *)key;
@end
