天天看点

iOS底层探索之KVC

前言

iOS

的面试中,

KVC

几乎是必问的面试题之一,那么到底什么是

KVC

KVC

的原理是什么呢?

iOS底层探索之KVC

KVC

又称

键值编码

Key-Value-Coding

),在

iOS

开发中是一个比较常见的技术点,相信很多开发人员都使用过

KVC

,其主要的两个方法就是如下两个,分别对应设置值和取值:

- (void)setValue:(nullable id)value forKey:(NSString *)key;
- (nullable id)valueForKey:(NSString *)key;

           

1. KVC简介

我们日常的开发也是经常用到,如下:

// 访问对象属性, 我们可以直接通过setter/getter方法, 或者通过成员变量直接进行访问操作.
JPStudent *stu = [[JPStudent alloc] init];
stu.name      = @"RENO"; // setter
NSString *name   = stu.name; // getter
person->nickName = @"瑞诺"; // 直接访问成员

// kvc 间接访问
[stu setValue:@"卡卡西" forKey:@"name"];
NSString *name2 = [stu valueForKey:@"name"];
           
除了纯代码开发中经常使用到

KVC

,在

Xib

storyboard

中也可以使用,如下图:
iOS底层探索之KVC

Xib

storyboard

当中的使用,和代码是类似的,设置键值,键是

KeyPath

,还有值的的类型

Type

,再设置值

Value

1.1 KCV官方文档

  • Key-Value Coding Programming Guide
    iOS底层探索之KVC
键值编码是由

NSKeyValueCoding

非正式协议

启用的一种机制,对象采用该机制来提供对其

属性

间接访问

。当对象符合键值编码时,其属性可通过字符串参数通过简洁、统一的消息传递接口进行寻址。这种间接访问机制补充了实例变量及其相关访问​​器方法提供的直接访问。
  • NSKeyValueCoding
    iOS底层探索之KVC
一种可以通过名称或键间接访问对象属性的机制,访问对象值的基本方法是,它设置由指定键标识的属性的值,和,它返回由指定键标识的属性的值。因此,可以以一致的方式访问对象的所有属性。

setValue(_:forKey:)value(forKey:)

默认实现依赖于通常由对象实现的访问器方法(或者在需要时直接访问实例变量)

1.2 常用KVC 方式

其中

KVC

中最为基础的两个

API

就是

setValue: forKey:

valueForKey:

,分别是根据

Key

设置值 和取出值,其用法如上面例子所示。此外,还有其他的一些使用方式。

KVC - 集合类型

例如:需要修改数组里面的值,

person.array[0] = @"100"

person.array = @[@"1",@"2",@"3"];
           
  • 搞一个新的数组 - KVC 赋值就OK
// 第一种:搞一个新的数组 - KVC 赋值就OK
    NSArray *array = [person valueForKey:@"array"];
    array = @[@"100",@"2",@"3"];
    [person setValue:array forKey:@"array"];
    NSLog(@"%@",[person valueForKey:@"array"]);
           
iOS底层探索之KVC
  • 第二种使用

    mutableArrayValueForKey

// 第二种
    NSMutableArray *mArray = [person mutableArrayValueForKey:@"array"];
    mArray[0] = @"200";
    NSLog(@"%@",[person valueForKey:@"array"]);
           
iOS底层探索之KVC
  • mutableArrayValueForKey
/* 
   Given a key that identifies an _ordered_ to-many relationship, return a mutable 
   array that provides read-write access to the related objects. Objects added to the
   mutable array will become related to the receiver, and objects removed from the 
   mutable array will become unrelated.
*/
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;

           
在对象包含一个数据变量时,如果调用该方法,会得到一个可变数组,通过修改该数组中的元素,使得原数组也发生变更,即使原数组是不可变数组。

数组

@[@"1", @"2", @"3"]

,是不可变数组,原本是不可以被修改,但是通过调用该方法,得到的是一个可变的数组,并修改其中的值后,发现原数组也变改变了,如上图所示。

在平时我们使用

NSArray

数组的时候,用到最多的就是

objectAtIndex:

,根据下标进行取值。但是在查看

KVC

的定义时可以发现,

NSArray

NSMutableArray

也有

valueForKey

的方法,如下代码所示:
**@interface** NSArray<ObjectType>(NSKeyValueCoding)
/* Return an array containing the results of invoking -valueForKey: 
on each of the receiver's elements. The returned array will contain 
NSNull elements for each instance of -valueForKey: returning nil.*/

- (**id**)valueForKey:(NSString *)key;

/* Invoke -setValue:forKey: on each of the receiver's elements.*/

- (**void**)setValue:(**nullable** **id**)value forKey:(NSString *)key;
@end

           

结构体类型

typedef struct {
    float x, y, z;
} ThreeFloats;

ThreeFloats floats = {1.,2.,3.};
    NSValue *value     = [NSValue valueWithBytes:&floats objCType:@encode(ThreeFloats)];
    [person setValue:value forKey:@"threeFloats"];
    NSValue *value1    = [person valueForKey:@"threeFloats"];

           

聚合操作符

#pragma mark - 聚合操作符
// @avg、@count、@max、@min、@sum
- (void)aggregationOperator{
    NSMutableArray *personArray = [NSMutableArray array];
    for (int i = 0; i < 6; i++) {
        JPStudent *p = [JPStudent new];
        NSDictionary* dict = @{
                               @"name":@"Tom",
                               @"age":@(18+i),
                               @"nick":@"Cat",
                               @"length":@(175 + 2*arc4random_uniform(6)),
                               };
        [p setValuesForKeysWithDictionary:dict];
        [personArray addObject:p];
    }
    NSLog(@"%@", [personArray valueForKey:@"length"]);
    
    /// 平均身高
    float avg = [[personArray valueForKeyPath:@"@avg.length"] floatValue];
    NSLog(@"%f", avg);
    
    int count = [[personArray valueForKeyPath:@"@count.length"] intValue];
    NSLog(@"%d", count);
    
    int sum = [[personArray valueForKeyPath:@"@sum.length"] intValue];
    NSLog(@"%d", sum);
    
    int max = [[personArray valueForKeyPath:@"@max.length"] intValue];
    NSLog(@"%d", max);
    
    int min = [[personArray valueForKeyPath:@"@min.length"] intValue];
    NSLog(@"%d", min);
}

           

字典类型

#pragma mark - 字典操作

- (void)dictionaryTest{
    
    NSDictionary* dict = @{
                           @"name":@"Cooci",
                           @"nick":@"KC",
                           @"subject":@"iOS",
                           @"age":@18,
                           @"length":@180
                           };
    JPStudent *p = [[JPStudent alloc] init];
    // 字典转模型
    [p setValuesForKeysWithDictionary:dict];
    NSLog(@"%@",p);
    // 键数组转模型到字典
    NSArray *array = @[@"name",@"age"];
    NSDictionary *dic = [p dictionaryWithValuesForKeys:array];
    NSLog(@"%@",dic);
}
           

2. KVC 设值 setValue:forKey

KVC

的设值是怎么样的呢?在官方文档中的说明如下图:
iOS底层探索之KVC

大致的意思是:

  • 默认实现的

    setValue:forKey:

    给定的

    key

    value

    参数作为输入,设置的属性

    key

    的值为

    value

    ,对象内接接受到,使用以下的步骤:
  • 按顺序 查找名为

    set<Key>:

    或者第一个访问器为

    _set<Key>

    名称的,如果找到,则使用输入值(或根据需要展开的值)调用它并完成。
  • 如果没有找到简单的访问器,如果类方法

    accessInstanceVariablesDirectly

    返回

    YES

    ,则继续寻找名称类似

    _<key>

    _is<Key>

    <key>

    ,或者

    is<Key>

    的一个实例变量,按照这个顺序查找,如果找到,直接使用输入值(或解包值)设置变量并完成。
  • 找不到访问器或实例变量后,调用

    setValue:forUndefinedKey:

    默认情况下,这会引发异常,但

    NSObject

    的子类可能会提供特定于键的行为。

[stu setValue:@"RENO" forKey:@"name"]

为例,可以得出以下结论:

优先通过

setter

方法,进行属性设置,调用顺序是:

  • setName

  • _setName

  • setIsName

如果以上方法均未找到,并且

accessInstanceVariablesDirectly

返回

YES

,则通过成员变量进行设置,顺序是:

  • _name

  • _isName

  • name

  • isName

大家可自己通过代码进行验证,这里不再进行代码演示了,这里需要重点说下

accessInstanceVariablesDirectly

重写

+ (BOOL)accessInstanceVariablesDirectly

方法让其返回

NO

,这样的话,如果

KVC

没有找到

set<Key>

_set<Key>

setIs<Key>

相关方法时,会直接用

setValue:forUndefinedKey:

方法。

那么下面用代码来体验一把。

  • JPPerson.h
NS_ASSUME_NONNULL_BEGIN

@interface JPPerson : NSObject{
    @public
        NSString *_isName;
       NSString *name;
      NSString *isName;
    NSString *_name;

}
@end

NS_ASSUME_NONNULL_END
           
  • JPPerson.m
#pragma mark - 关闭或开启实例变量赋值
+ (BOOL)accessInstanceVariablesDirectly{
    return NO;
}
-(id)valueForUndefinedKey:(NSString *)key{
	 NSLog(@"异常信息打印,该key不存在%@",key);
	 return nil;
}
-(void)setValue:(id)value forUndefinedKey:(NSString *)key{
	  NSLog(@"设值异常打印,该key不存在%@",key);
}

//MARK: - setKey. 的流程分析
//- (void)setName:(NSString *)name{
//    NSLog(@"%s - %@",__func__,name);
//}

//- (void)_setName:(NSString *)name{
//    NSLog(@"%s - %@",__func__,name);
//}

//- (void)setIsName:(NSString *)name{
//    NSLog(@"%s - %@",__func__,name);
//}

// 没有调用
//- (void)_setIsName:(NSString *)name{
//    NSLog(@"%s - %@",__func__,name);
//}
           
  • main,m调用
LGPerson* person = [LGPerson new];
	[person setValue:@"NewName" forKey:@"name"];
	NSString* name = [person valueForKey:@"name"];
	NSLog(@"value for key : %@",name);

	NSLog(@"_name:%@",person->_name);
	NSLog(@"_isName:%@",person->_isName);
	NSLog(@"name:%@",person->name);
	NSLog(@"isName:%@",person->isName);
           
  • 控制台打印信息如下:
2021-08-02 13:08:46.060908+0800 002-KVC取值&赋值过程[9684:199214] 设值异常打印,该key不存在name
2021-08-02 13:08:46.061885+0800 002-KVC取值&赋值过程[9684:199214] 异常打印,该key不存在name
2021-08-02 13:08:46.062117+0800 002-KVC取值&赋值过程[9684:199214] value for key : (null)
2021-08-02 13:08:46.062344+0800 002-KVC取值&赋值过程[9684:199214] _name:(null)
2021-08-02 13:08:46.062480+0800 002-KVC取值&赋值过程[9684:199214] _isName:(null)
2021-08-02 13:08:46.062597+0800 002-KVC取值&赋值过程[9684:199214] name:(null)
2021-08-02 13:08:46.062699+0800 002-KVC取值&赋值过程[9684:199214] isName:(null)
2021-08-02 13:08:46.391636+0800 002-KVC取值&赋值过程[9684:199214] 异常打印,该key不存在name
2021-08-02 13:08:46.391807+0800 002-KVC取值&赋值过程[9684:199214] 取值:(null)
           
这说明了重写

+(BOOL)accessInstanceVariablesDirectly

方法让其返回

NO

后,

KVC

找不到

set<Key>

等方法后,不再去找

<Key>

系列成员变量,而是直接调用

setValue:forUndefinedKey:

方法。

3. KVC取值 valueForKey

上面分析完

KVC设值

,现在分析下

KVC取值

,当调用

valueForKey:

的代码时,

OC

底层的执行机制又是怎样的呢?官方文档的说明如下:
iOS底层探索之KVC

以上翻译大概可以总结一下几个流程:

  • 1.按照

    get<Key>

    <key>

    is<Key>

    _<key>

    的顺序查找方法实现,如果找到就调用,并执行第

    5

    步;
  • 2.如果上一步中没有找到,并且是一个数组类型,则调用数组相关的方法;
  • 3.如果上一步没找到,并且是一个集合类型,则调用集合相关方法;
  • 4.如果以上都没找到,则判断

    accessInstanceVariablesDirectly

    是否为

    YES

    ,如果为

    YES

    ,则依次查找成员变量

    _<key>

    _is<Key>

    <key>

    is<Key>

    ,如果查找到则进行第

    5

    步,否则进行第

    6

  • 5.查找到值,需要对值进行处理
    • 如果检索到的值是一个对象指针,则直接返回该对象,
    • 如果是一个

      NSNumber

      标量,则将其存储在

      NSNumber

      中并返回,
    • 如果不是一个

      NSNumber

      标量,则存储在

      NSValue

      中并返回
  • 6.在

    1~4

    未找到的情况下,抛出异常

以上流程中有针对数组和集合的处理,而对于字典的处理并不在这一步骤中,字典的

KVC

实际上是调用自己的

setObject:forKey:

objectForKey:

方法,并不会查找自身的成员变量和属性。

  • 取值测试代码
//MARK: - valueForKey 流程分析 - get<Key>, <key>, is<Key>, or _<key>,

- (NSString *)getName{
    return NSStringFromSelector(_cmd);
}

//- (NSString *)name{
//    return NSStringFromSelector(_cmd);
//}
//
//- (NSString *)isName{
//    return NSStringFromSelector(_cmd);
//}
//
//- (NSString *)_name{
//    return NSStringFromSelector(_cmd);
//}

           
  • 测试代码如下:
person->_name = @"_name";
    person->_isName = @"_isName";
    person->name = @"name";
    person->isName = @"isName";

    NSLog(@"取值:%@",[person valueForKey:@"name"]);
           
以上代码依次注释,测试打印,如下
  • getName
    iOS底层探索之KVC
  • name
    iOS底层探索之KVC
我就不一一的去测试打印截图了,其他的都是一样的,有兴趣的可以自己去测试下!
通过打印测试,对于方法的查找次序确实是如第一步

get<Key>

<key>

is<Key>

_<key>

,并且不会调用其他的方法。
  • 验证变量的值的查找,先把方法注释调
    iOS底层探索之KVC
  • 再看看打印结果
    iOS底层探索之KVC
打印结果没有问题,通过验证发现变量的调用顺序确实如

_<key>

,

_is<Key>

,

<key>

,

is<Key>

,并且最终未找到时会抛出异常

valueForUndefinedKey:

(这里没有一一列举出所有的打印过程出来)
  • 那么注释掉一个成员变量的赋值再看看
iOS底层探索之KVC
iOS底层探索之KVC
当注释

_name

的赋值语句,但

_name

定义并未注释时,并没有因为

_name

值为

null

,就去查找

_isName

,而是直接取

_name

的空值

null

这是因为是按顺序来的,虽然

_name

的赋值注释了,但是它的定义还在,就是老大还在,老二不能上位,除非老大不在。

如下图所示:

iOS底层探索之KVC
iOS底层探索之KVC

4. 自定义KVC

我们也可以自己实现一个

非正式协议

对象采用该机制来提供对其

属性

间接访问

,自定义

KVC

,如下代码:

// KVC 自定义
@implementation NSObject (LGKVC)

// 设置
- (void)lg_setValue:(nullable id)value forKey:(NSString *)key{
    // 1: 判断什么 key
    if (key == nil || key.length == 0) {
        return;
    }

    // 2: setter set<Key>: or _set<Key>,
    // key 要大写
    NSString *Key = key.capitalizedString;

    // 拼接方法
    NSString *setKey = [NSString stringWithFormat:@"set%@:",Key];
    NSString *_setKey = [NSString stringWithFormat:@"_set%@:",Key];
    NSString *setIsKey = [NSString stringWithFormat:@"setIs%@:",Key];

    // 是否存在方法
    if ([self lg_performSelectorWithMethodName:setKey value:value]) {
        NSLog(@"*********%@**********",setKey);
        return;
    }else if ([self lg_performSelectorWithMethodName:_setKey value:value]) {
        NSLog(@"*********%@**********",_setKey);
        return;
    }else if ([self lg_performSelectorWithMethodName:setIsKey value:value]) {
        NSLog(@"*********%@**********",setIsKey);
        return;
    }

    // 3: 判断是否响应 accessInstanceVariablesDirectly 返回YES NO 奔溃
    // 3:判断是否能够直接赋值实例变量——NO
    if (![self.class accessInstanceVariablesDirectly] ) {
        @throw [NSException exceptionWithName:@"LGUnknownKeyException" reason:[NSString stringWithFormat:@"****[%@ valueForUndefinedKey:]: this class is not key value coding-compliant for the key name.****",self] userInfo:nil];

    }

    // 4: 间接变量
    // 获取 ivar -> 遍历 containsObjct -
    // 4.1 定义一个收集实例变量的可变数组
    NSMutableArray *mArray = [self getIvarListName];
    // _<key> _is<Key> <key> is<Key>
    // 拼接成员变量
    NSString *_key = [NSString stringWithFormat:@"_%@",key];
    NSString *_isKey = [NSString stringWithFormat:@"_is%@",Key];
    NSString *isKey = [NSString stringWithFormat:@"is%@",Key];

    // 是否存在对应的变量
    if ([mArray containsObject:_key]) {
        // 4.2 获取相应的 ivar
       Ivar ivar = class_getInstanceVariable([self class], _key.UTF8String);
        // 4.3 对相应的 ivar 设置值
       object_setIvar(self , ivar, value);
       return;
    }else if ([mArray containsObject:_isKey]) {
       Ivar ivar = class_getInstanceVariable([self class], _isKey.UTF8String);
       object_setIvar(self , ivar, value);
       return;
    }else if ([mArray containsObject:key]) {
       Ivar ivar = class_getInstanceVariable([self class], key.UTF8String);
       object_setIvar(self , ivar, value);
       return;
    }else if ([mArray containsObject:isKey]) {
       Ivar ivar = class_getInstanceVariable([self class], isKey.UTF8String);
       object_setIvar(self , ivar, value);
       return;
    }

    // 5:如果找不到相关实例

    @throw [NSException exceptionWithName:@"LGUnknownKeyException" reason:[NSString stringWithFormat:@"****[%@ %@]: this class is not key value coding-compliant for the key name.****",self,NSStringFromSelector(_cmd)] userInfo:nil];
}

// 取值
- (nullable id)lg_valueForKey:(NSString *)key{

    // 1:刷选key 判断非空
    if (key == nil  || key.length == 0) {
        return nil;
    }

    // 2:找到相关方法 get<Key> <key> countOf<Key>  objectIn<Key>AtIndex
    // key 要大写
    NSString *Key = key.capitalizedString;

    // 拼接方法
    NSString *getKey = [NSString stringWithFormat:@"get%@",Key];
    NSString *countOfKey = [NSString stringWithFormat:@"countOf%@",Key];
    NSString *objectInKeyAtIndex = [NSString stringWithFormat:@"objectIn%@AtIndex:",Key];

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"

    if ([self respondsToSelector:NSSelectorFromString(getKey)]) {
        return [self performSelector:NSSelectorFromString(getKey)];
    }else if ([self respondsToSelector:NSSelectorFromString(key)]){
        return [self performSelector:NSSelectorFromString(key)];
    }else if ([self respondsToSelector:NSSelectorFromString(countOfKey)]){
        if ([self respondsToSelector:NSSelectorFromString(objectInKeyAtIndex)]) {
            int num = (int)[self performSelector:NSSelectorFromString(countOfKey)];
            NSMutableArray *mArray = [NSMutableArray arrayWithCapacity:1];
            for (int i = 0; i<num-1; i++) {
                num = (int)[self performSelector:NSSelectorFromString(countOfKey)];
            }

            for (int j = 0; j<num; j++) {
                id objc = [self performSelector:NSSelectorFromString(objectInKeyAtIndex) withObject:@(num)];
                [mArray addObject:objc];
            }
            return mArray;
        }
    }
#pragma clang diagnostic pop


    // 3:判断是否能够直接赋值实例变量-YES、NO
    if (![self.class accessInstanceVariablesDirectly] ) {
        @throw [NSException exceptionWithName:@"LGUnknownKeyException" reason:[NSString stringWithFormat:@"****[%@ valueForUndefinedKey:]: this class is not key value coding-compliant for the key name.****",self] userInfo:nil];
    }

    // 4.找相关实例变量进行赋值
    // 4.1 定义一个收集实例变量的可变数组
    NSMutableArray *mArray = [self getIvarListName];

    // _<key> _is<Key> <key> is<Key>
    // _name -> _isName -> name -> isName
    NSString *_key = [NSString stringWithFormat:@"_%@",key];
    NSString *_isKey = [NSString stringWithFormat:@"_is%@",Key];
    NSString *isKey = [NSString stringWithFormat:@"is%@",Key];
    
    // 判断是否存在对应的成员变量
    if ([mArray containsObject:_key]) {
        Ivar ivar = class_getInstanceVariable([self class], _key.UTF8String);
        return object_getIvar(self, ivar);;
    }else if ([mArray containsObject:_isKey]) {
        Ivar ivar = class_getInstanceVariable([self class], _isKey.UTF8String);
        return object_getIvar(self, ivar);;
    }else if ([mArray containsObject:key]) {
        Ivar ivar = class_getInstanceVariable([self class], key.UTF8String);
        return object_getIvar(self, ivar);;
    }else if ([mArray containsObject:isKey]) {
        Ivar ivar = class_getInstanceVariable([self class], isKey.UTF8String);
        return object_getIvar(self, ivar);;
    }
    
    return @"";
}

#pragma mark **- 相关方法**

- (BOOL)lg_performSelectorWithMethodName:(NSString *)methodName value:(id)value{
    if ([self respondsToSelector:NSSelectorFromString(methodName)]) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
        [self performSelector:NSSelectorFromString(methodName) withObject:value];
#pragma clang diagnostic pop
        return YES;
    }
    return NO;
}

- (id)performSelectorWithMethodName:(NSString *)methodName{

    if ([self respondsToSelector:NSSelectorFromString(methodName)]) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
        return [self performSelector:NSSelectorFromString(methodName) ];
#pragma clang diagnostic pop
    }
    return nil;
}

- (NSMutableArray *)getIvarListName{
    NSMutableArray *mArray = [NSMutableArray arrayWithCapacity:1];
    unsigned int count = 0;
    Ivar *ivars = class_copyIvarList([self class], &count);
    for (int i = 0; i<count; i++) {
        Ivar ivar = ivars[i];
        const char *ivarNameChar = ivar_getName(ivar);
        NSString *ivarName = [NSString stringWithUTF8String:ivarNameChar];
        NSLog(@"ivarName == %@",ivarName);
        [mArray addObject:ivarName];
    }

    free(ivars);
    return mArray;
}

@end

           

5. 总结

  • KVC

    全称

    Key-Value Coding

    , 俗称键值编码,提供了一种间接访问属性的机制, 即可以通过一个

    key

    字符串访问某个属性
  • 在设值和取值的时候,如果

    key

    写错了,编译时不会报错,运行时会奔溃。
  • 设值时会先调用相关的

    set

    方法,然后在

    accessInstanceVariablesDirectly

    YES

    情况下,会赋值相应的成员变量。
  • 取值时,也会先调用相关

    get

    方法,如果没有,在

    accessInstanceVariablesDirectly

    YES

    情况下,会取相关变量的值。
  • 重写

    + (BOOL)accessInstanceVariablesDirectly

    方法让其返回

    NO

    ,这样的话,如果

    KVC

    没有找到

    set<Key>

    _set<Key>

    setIs<Key>

    相关方法时,会直接用

    setValue:forUndefinedKey:

    方法。
  • setValue取值流程如下:
    iOS底层探索之KVC