iOS —— KVC

一、介绍

KVC全称是Key Value Coding（键值编码），是可以通过对象属性名称（Key）直接对属性值（value）编码（coding）“编码”可以理解为“赋值及访问”。而不需要调用明确的存取方法。这样就可以在运行时动态在访问和修改对象的属性，而不是在编译时确定。KVC的优势是在没有访问器(setter、getter)方法的类中，此时点语法无法使用。KVC提供了一种间接访问其属性方法或成员变量的机制，可以通过字符串来访问对应的属性方法或成员变量。

KVC的定义都是对NSObject的扩展来实现的，Objective-c中有个显式的NSKeyValueCoding类别名，所以对于所有继承了NSObject在类型，都能使用KVC。

二、原理

1、赋值

// 赋值 
- (void)setValue:(nullable id)value forKey:(NSString *)key;
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath;
//没有找到key的异常处理
-(void)setValue:(id)value forUndefinedKey:(NSString *)key

• 存取器(setter方法)匹配：先寻找与setKey同名的方法。找到直接赋值。[self setProperty:@”value”]。

• 实例变量匹配：寻找与key，_isKey，_key，isKey同名的实例变量，直接赋值。property = value或_property = value等。

• 找不到,就会直接报错 setValue:forUndefinedKey:报找不到的错误。

• 备注：+ (BOOL)accessInstanceVariablesDirectly方法可以更改查找方式，默认返回为yes，

  默认返回YES，表示如果没有找到Set<Key>方法的话，会按照_key，_iskey，key，iskey的顺序搜索成员，

  如果返回NO，只查找属性，不查找成员变量。找不到,就会直接报错 setValue:forUndefinedKey:报找不到的错误。

2、取值

- (nullable id)valueForKeyPath:(NSString *)keyPath;
- (nullable id)valueForKey:(NSString *)key;
//取值异常
-(id)valueForUndefinedKey:(NSString *)key

1. 访问器(getter方法)匹配：先寻找与key，isKey， getKey (实测还有_key)同名的方法。

2. 实例变量匹配：寻找与key， _key，isKey，_isKey同名的实例变量。

3. 如果还没有找到的话，调用valueForUndefinedKey：。

若value值为BOOL或Int等值类型时，KVC可以自动的将数值或结构体型的数据打包或解包成NSNumber或NSValue对象，以达到适配的目的。

三、简单使用

//作者类
#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface Author : NSObject
//姓名
@property (nonatomic,copy)NSString *name;
//地址
@property (nonatomic,copy)NSString *address;
@end

NS_ASSUME_NONNULL_END

//书类
#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN
@class Author;
@interface Book : NSObject

//书名
@property (nonatomic,copy)NSString *bookName;
//作者
@property (nonatomic,strong)Author *author;

@end

NS_ASSUME_NONNULL_END

使用
    Book *book=[[Book alloc]init];
    book.author=[[Author alloc]init];
    
    //赋值
    [book setValue:@"iOS开发" forKey:@"bookName"];
    //取值
    NSString *bookName=[book valueForKey:@"bookName"];
    NSLog(@"bookName=%@",bookName);
    
    //keyPath方式
    [book setValue:@"哈哈" forKeyPath:@"author.name"];
    [book setValue:@"北京市朝阳区" forKeyPath:@"author.address"];
    
    NSString *name=[book valueForKeyPath:@"author.name"];
    NSString *address=[book valueForKeyPath:@"author.address"];
    NSLog(@"%@ %@",name,address);

四、不存在的key及nil值处理

1、不存在的key

我们可以考虑重写setValue: forUndefinedKey:方法与valueForUndefinedKey:方法

- (void)setValue:(id)value forUndefinedKey:(NSString *)key {

    NSLog(@"您设置的key：[%@]不存在", key);
    NSLog(@"您设置的value为：[%@]", value);

}

- (id)valueForUndefinedKey:(NSString *)key {

    NSLog(@"您访问的key:[%@]不存在", key);
    return nil;

}

2、nil值处理

当程序尝试为某个属性设置nil值时，如果该属性并不接受nil值，那么程序将会自动执行该对象的setNilValueForKey:方法。我们同样可以重写这个方法:
- (void)setNilValueForKey:(NSString *)key {
    //对不能接受nil的属性进行处理
    if ([key isEqualToString:@"price"]) {
        //对应你具体的业务来处理
        price = 0;
    }else {
        [super setNilValueForKey:key];
    }
}

五、实际应用

1、访问私有属性

对于类里的私有属性，Objective-C是无法直接访问的，但是KVC是可以的。

@interface Book : NSObject
{
    NSString * owner;
}
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    Book *book = [Book new];
    
    // 这种访问方式，会直接报错。因为owner是私有属性。
    // book.owner = @"哈哈"; 
    
    // 利用KVC访问到私有变量
    [book setValue:@"哈哈" forKey:@"owner"];
    NSLog([book valueForKey:@"owner"]); // 输出 哈哈
}
@end

 

2、修改一些控件的内部属性

在开发中，我们常常需要对一些控件的某些属性做修改，但是很多UI控件都由很多内部UI控件组合而成的，系统并没有提供这访问这些控件的API，这样我们就无法正常地访问和修改这些控件的样式。但是，KVC可以帮我们解决大部分这种类型的问题。

3、结合Runtime打造字典转model