1. 簡(jiǎn)介

KVC 即鍵值編碼，KVC 是由 NSKeyValueCoding 非正式協(xié)議啟用的一種機(jī)制，對(duì)象采用該協(xié)議來(lái)間接訪問(wèn)其屬性案糙。即可以通過(guò)一個(gè)字符串key來(lái)訪問(wèn)某個(gè)屬性，這種間接訪問(wèn)機(jī)制補(bǔ)充了實(shí)例變量及其相關(guān)的訪問(wèn)器方法所提供的直接訪問(wèn)。

2. 相關(guān) API

主要有下面 4 個(gè)常用的方法：

• 通過(guò)key 設(shè)值/取值

//直接通過(guò)Key來(lái)取值
- (nullable id)valueForKey:(NSString *)key;

//通過(guò)Key來(lái)設(shè)值
- (void)setValue:(nullable id)value forKey:(NSString *)key;

• 通過(guò)keyPath 設(shè)值/取值

//通過(guò)KeyPath來(lái)取值
- (nullable id)valueForKeyPath:(NSString *)keyPath; 

//通過(guò)KeyPath來(lái)設(shè)值                 
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath;  

還有其他的一些方法：

//默認(rèn)返回YES奥吩，表示如果沒(méi)有找到Set<Key>方法的話，會(huì)按照_key翅雏，_iskey圈驼，key，iskey的順序搜索成員望几，設(shè)置成NO就不這樣搜索
+ (BOOL)accessInstanceVariablesDirectly;

//KVC提供屬性值正確性驗(yàn)證的API绩脆，它可以用來(lái)檢查set的值是否正確、為不正確的值做一個(gè)替換值或者拒絕設(shè)置新值并返回錯(cuò)誤原因。
- (BOOL)validateValue:(inout id __nullable * __nonnull)ioValue forKey:(NSString *)inKey error:(out NSError **)outError;

//這是集合操作的API靴迫，里面還有一系列這樣的API惕味，如果屬性是一個(gè)NSMutableArray，那么可以用這個(gè)方法來(lái)返回玉锌。
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;

//如果Key不存在名挥，且KVC無(wú)法搜索到任何和Key有關(guān)的字段或者屬性，則會(huì)調(diào)用這個(gè)方法主守，默認(rèn)是拋出異常禀倔。
- (nullable id)valueForUndefinedKey:(NSString *)key;

//和上一個(gè)方法一樣，但這個(gè)方法是設(shè)值参淫。
- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key;

//如果你在SetValue方法時(shí)面給Value傳nil救湖，則會(huì)調(diào)用這個(gè)方法
- (void)setNilValueForKey:(NSString *)key;

//輸入一組key,返回該組key對(duì)應(yīng)的Value，再轉(zhuǎn)成字典返回涎才，用于將Model轉(zhuǎn)到字典鞋既。
- (NSDictionary<NSString *, id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;

3. 底層原理

3.1 KVC 賦值底層原理

在日常開(kāi)發(fā)中，針對(duì)對(duì)象屬性的賦值耍铜，一般有以下兩種方式：

• 通過(guò) setter方法賦值
• 通過(guò)KVC 鍵值編碼的相關(guān)API 賦值

Person *person = [[Person alloc] init];
// 1邑闺、一般setter 方法
person.name = @"哈哈";
// 2、KVC方式
[person setValue:@"嘻嘻" forKey:@"name"]; 

下面針對(duì)使用最多的KVC設(shè)值方法：setValue:forKey棕兼，來(lái)進(jìn)行其底層原理的探索陡舅。
在這里，我們通過(guò)Key-Value Coding Programming Guide蘋(píng)果官方文檔來(lái)研究程储，針對(duì)設(shè)值流程蹭沛，有以下說(shuō)明：

當(dāng)調(diào)用 setValue:forKey:設(shè)值屬性 value 時(shí)，其底層的執(zhí)行流程為：

[第一步]
首先查找是否有這三種setter 方法章鲤，并且查找順序?yàn)?code>set<Key>: -> _set<Key> -> setIs<Key>

• 如果實(shí)現(xiàn)了其中任意一個(gè) setter方法摊灭，則直接設(shè)置成員變量的value( 注意：key 是指成員變量名，首字母大小寫(xiě)需要符合KVC 的命名規(guī)范)
• 如果沒(méi)有败徊，則進(jìn)入下一步

[第二步]
如果沒(méi)有第一步中的三個(gè)簡(jiǎn)單的 setter 方法帚呼，則查找accessInstanceVariablesDirectly是否返回YES

• 如果返回YES，則查找間接訪問(wèn)的實(shí)例變量進(jìn)行賦值皱蹦，查找順序?yàn)? _<key> -> _is<Key> -> <key> -> is<Key>煤杀，如果找到其中任意一個(gè)實(shí)例變量，則賦值沪哺，如果都沒(méi)有沈自，則進(jìn)入下一步
• 如果返回NO，則進(jìn)入下一步

[第三步]
如果 setter 方法或者實(shí)例變量都沒(méi)有找到辜妓，系統(tǒng)會(huì)執(zhí)行該對(duì)象的setValue：forUndefinedKey:方法枯途，默認(rèn)拋出NSUndefinedKeyException類(lèi)型的異常忌怎。

注意：我們實(shí)現(xiàn)setValue：forUndefinedKey:這個(gè)方法之后，哪怕沒(méi)有任何操作酪夷，也不會(huì)引發(fā)崩潰了榴啸。

綜上所述，KVC通過(guò)setValue:forKey:方法設(shè)值的流程以設(shè)置LGPerson的對(duì)象person的屬性name為例晚岭，如下圖所示:

image.png

3.2 KVC取值底層原理

同樣的鸥印，我們可以通過(guò)官方文檔分析KVC取值的底層原理
當(dāng)調(diào)用valueForKey：時(shí)，其底層的執(zhí)行流程如下：
[第一步]
首先查找getter方法坦报，按照get<Key> -> <key> -> is<Key> -> _<key>的方法順序查找

• 如果找到库说，則進(jìn)入 [第五步]
• 如果沒(méi)找到，則進(jìn)入下一步

[第二步]
如果第一步中的getter方法沒(méi)有找到燎竖，KVC會(huì)查找countOf <Key>和objectIn <Key> AtIndex :和<key> AtIndexes :

• 如果找到 countOf<Key> 和其他兩個(gè)方法中的任意一個(gè)璃弄，則會(huì)創(chuàng)建一個(gè)響應(yīng)所有 NSArray 方法的集合代理對(duì)象要销，并返回該對(duì)象构回，即 NSKeyValueArray，是NSArray的子類(lèi)疏咐。代理對(duì)象隨后將接收到的所有 NSArray 消息轉(zhuǎn)換為countOf<Key>纤掸，objectIn<Key> AtIndex：和<key>AtIndexes：消息的某種組合，用來(lái)創(chuàng)建鍵值編碼對(duì)象浑塞。如果原始對(duì)象還實(shí)現(xiàn)了一個(gè)名為get<Key>：range：之類(lèi)的可選方法借跪，則代理對(duì)象也將在適當(dāng)時(shí)使用該方法（注意：方法名的命名規(guī)則要符合KVC的標(biāo)準(zhǔn)命名方法，包括方法簽名酌壕。）
• 如果沒(méi)有找到這三個(gè)訪問(wèn)數(shù)組的方法掏愁，則進(jìn)入下一步

[第三步]
如果沒(méi)有找到上面的幾種方法，則會(huì)同時(shí)查找countOf <Key>卵牍，enumeratorOf<Key>和memberOf<Key>這三個(gè)方法

• 如果這三個(gè)方法都找到果港，則會(huì)創(chuàng)建一個(gè)響應(yīng)所有NSSet方法的集合代理對(duì)象，并返回該對(duì)象糊昙，此代理對(duì)象隨后將其收到的所有NSSet消息轉(zhuǎn)換為countOf<Key>辛掠，enumeratorOf<Key>和memberOf<Key>：消息的某種組合，用于創(chuàng)建它的對(duì)象
• 如果還是沒(méi)有找到释牺，則進(jìn)入下一步

[第四步]
如果還沒(méi)有找到萝衩，檢查類(lèi)方法accessInstanceVariablesDirectly是否YES，依次搜索_<key>没咙，_is<Key>猩谊，<key>或is<Key>的實(shí)例變量

• 如果找到了，直接獲取實(shí)例變量的值祭刚，進(jìn)入下一步
• 如果還沒(méi)找到牌捷，進(jìn)入[第六步]

[第五步]
根據(jù)搜索到的成員變量的值的類(lèi)型队塘，返回不同的結(jié)果：

• 如果是對(duì)象指針，則直接返回結(jié)果
• 如果是NSNumber支持的標(biāo)量類(lèi)型宜鸯，則將其存儲(chǔ)在NSNumber實(shí)例中并返回它
• 如果是是NSNumber不支持的標(biāo)量類(lèi)型憔古，轉(zhuǎn)換為NSValue對(duì)象并返回該對(duì)象

[第六步]
如果上面5步的方法均失敗，系統(tǒng)會(huì)執(zhí)行該對(duì)象的valueForUndefinedKey:方法淋袖，默認(rèn)拋出NSUndefinedKeyException類(lèi)型的異常

綜上所述鸿市，KVC通過(guò) valueForKey：方法取值的流程以設(shè)置LGPerson的對(duì)象person的屬性name為例，如下圖所示：

image.png

4.自定義 KVC

原理：通過(guò)給 NSObject 添加分類(lèi)CJLKVC即碗，實(shí)現(xiàn)自定義的cjl_setValue:forKey:和cjl_valueForKey:方法焰情，根據(jù)蘋(píng)果官方文檔提供的查找規(guī)則進(jìn)行實(shí)現(xiàn)：

@interface NSObject (KVC)

//設(shè)值
- (void)customSetValue:(nullable id)value forKey:(NSString *)key;
//取值
- (nullable id)customValueForKey:(NSString *)key;

@end

4.1 自定義 KVC 設(shè)值

自定義KVC設(shè)置流程，主要分為以下幾個(gè)步驟：

• 1剥懒、判斷key非空
• 2内舟、查找setter方法，順序是：setXXX初橘、_setXXX验游、 setIsXXX
• 3、判斷是否響應(yīng)accessInstanceVariablesDirectly方法保檐，即是否訪問(wèn)實(shí)例變量耕蝉，
  返回YES，繼續(xù)下一步設(shè)值夜只，
  如果是NO垒在，則崩潰
• 4、間接訪問(wèn)變量賦值（只會(huì)走一次）扔亥，順序是：_key场躯、_isKey、key旅挤、isKey
  • 4.1 定義一個(gè)收集實(shí)例變量的可變數(shù)組
  • 4.2 通過(guò)class_getInstanceVariable方法踢关，獲取相應(yīng)的 ivar
  • 4.3 通過(guò)object_setIvar方法，對(duì)相應(yīng)的ivar設(shè)置值
• 5 谦铃、如果找不到相關(guān)實(shí)例變量耘成，則拋出異常

//設(shè)值
- (void)customSetValue:(nullable id)value forKey:(NSString *)key{
    
//    1、判斷key 是否存在
    if (key == nil || key.length == 0) return;
    
//    2驹闰、找setter方法瘪菌，順序是：setXXX、_setXXX嘹朗、 setIsXXX
    // key 要大寫(xiě)
    NSString *Key = key.capitalizedString;
    // key 要大寫(xiě)
    NSString *setKey = [NSString stringWithFormat:@"set%@:", Key];
    NSString *_setKey = [NSString stringWithFormat:@"_set%@:", Key];
    NSString *setIsKey = [NSString stringWithFormat:@"setIs%@:", Key];
    
    if ([self performSelectorWithMethodName:setKey value:value]) {
        NSLog(@"*************%@*************", setKey);
        return;
    }else if([self performSelectorWithMethodName:_setKey value:value]){
        NSLog(@"*************%@*************", _setKey);
        return;
    }else if([self performSelectorWithMethodName:setIsKey value:value]){
        NSLog(@"*************%@*************", setIsKey);
        return;
    }
    
    
//    3师妙、判斷是否響應(yīng)`accessInstanceVariablesDirectly`方法，即間接訪問(wèn)實(shí)例變量屹培，返回YES默穴，繼續(xù)下一步設(shè)值怔檩，如果是NO，則崩潰
    if (![self.class accessInstanceVariablesDirectly]) {
        @throw [NSException exceptionWithName:@"CJLUnKnownKeyException" reason:[NSString stringWithFormat:@"****[%@ valueForUndefinedKey:]: this class is not key value coding-compliant for the key name.****",self] userInfo:nil];
    }
    
//    4蓄诽、間接訪問(wèn)變量賦值薛训，順序?yàn)椋篲key、_isKey仑氛、key乙埃、isKey
    // 4.1 定義一個(gè)收集實(shí)例變量的可變數(shù)組
    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 獲取相應(yīng)的 ivar
        Ivar ivar = class_getInstanceVariable([self class], _key.UTF8String);
        // 4.3 對(duì)相應(yīng)的 ivar 設(shè)置值
        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:@"CJLUnknownKeyException" reason:[NSString stringWithFormat:@"****[%@ %@]: this class is not key value coding-compliant for the key name.****",self,NSStringFromSelector(_cmd)] userInfo:nil];
    
}

4.2 自定義 KVC 取值

取值的自定義代碼如下锯岖，分為以下幾步

• 1介袜、判斷key非空

• 2、查找相應(yīng)方法出吹，順序是：get<Key>遇伞、 <key>、 countOf<Key>捶牢、 objectIn<Key>AtIndex

• 3鸠珠、判斷是否能夠直接賦值實(shí)例變量，即判斷是否響應(yīng)accessInstanceVariablesDirectly方法叫确，間接訪問(wèn)成員變量跳芳，

  返回YES，繼續(xù)下一步取值

  如果是NO竹勉，則崩潰

• 4、間接訪問(wèn)實(shí)例變量娄琉，順序是：_<key> _is<Key> <key> is<Key>

  • 4.1 定義一個(gè)收集實(shí)例變量的可變數(shù)組

  • 4.2 通過(guò)class_getInstanceVariable方法次乓，獲取相應(yīng)的 ivar

  • 4.3 通過(guò)object_getIvar方法，返回相應(yīng)的ivar 的值

//取值
- (nullable id)cjl_valueForKey:(NSString *)key{
    
//    1孽水、判斷非空
    if (key == nil || key.length == 0) {
        return nil;
    }
    
//    2票腰、找到相關(guān)方法：get<Key> <key> countOf<Key>  objectIn<Key>AtIndex
    // key 要大寫(xiě)
    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)];
    }
    //集合類(lèi)型
    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、判斷是否響應(yīng)`accessInstanceVariablesDirectly`方法女气，即間接訪問(wèn)實(shí)例變量杏慰，返回YES炼鞠，繼續(xù)下一步設(shè)值谒主，如果是NO霎肯，則崩潰
    if (![self.class accessInstanceVariablesDirectly]) {
        @throw [NSException exceptionWithName:@"CJLUnKnownKeyException" reason:[NSString stringWithFormat:@"****[%@ valueForUndefinedKey:]: this class is not key value coding-compliant for the key name.****",self] userInfo:nil];
    }
    
//    4.找相關(guān)實(shí)例變量進(jìn)行賦值，順序?yàn)椋篲<key>搂捧、 _is<Key>允跑、 <key>、 is<Key>
    // 4.1 定義一個(gè)收集實(shí)例變量的可變數(shù)組
    NSMutableArray *mArray = [self getIvarListName];
    // 例如：_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 @"";
    
    return @"";
}

5. 使用 keyPath

在日常開(kāi)發(fā)中，一個(gè)類(lèi)的成員變量有可能是自定義類(lèi)或者其他的復(fù)雜數(shù)據(jù)類(lèi)型术荤，一般的操作是瓣戚，我們可以先通過(guò)KVC獲取該屬性焦读，然后再通過(guò)KVC獲取自定義類(lèi)的屬性矗晃，就是比較麻煩张症，還有另一種比較簡(jiǎn)便的方法，就是使用KeyPath脖捻，涉及以下兩個(gè)方法：setValue:forKeyPath: 和 valueForKeyPath:

//通過(guò)KeyPath來(lái)取值
- (nullable id)valueForKeyPath:(NSString *)keyPath;                  

//通過(guò)KeyPath來(lái)設(shè)值
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath;  

比如以下的案例：

//Person類(lèi)
@interface Person : NSObject
@property (nonatomic, copy)   NSString          *age;
@property (nonatomic, strong) Student         *student;
@end

//Student類(lèi)
@interface Student : NSObject
@property (nonatomic, copy)   NSString          *name;
@end

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        Person *person = [[Person alloc] init];
        Student *student = [Student alloc];
        student.name    = @"CJL";
        person.student     = student;
        //根據(jù)kvc - keyPath路由修改student的subject屬性的值
        [person setValue:@"嘻嘻" forKeyPath:@"student.name"];
        NSLog(@"%@",[person valueForKeyPath:@"student.name"]);
    }
    return 0;
}

//*************打印結(jié)果*************
2020-10-27 09:55:08.512833+0800 001-KVC簡(jiǎn)介[58089:6301894] 改變前：CJL
2020-10-27 09:55:08.512929+0800 001-KVC簡(jiǎn)介[58089:6301894] 改變后：嘻嘻

6.使用場(chǎng)景

6.1 動(dòng)態(tài)設(shè)值和取值

• 常用的可以通過(guò)setValue:forKey: 和valueForKey:
• 也可以通過(guò)路由的方式setValue:forKeyPath:和 valueForKeyPath:

6.2 通過(guò)KVC訪問(wèn)和修改私有變量

在日常開(kāi)發(fā)中，對(duì)于類(lèi)的私有屬性摩疑，在外部定義的對(duì)象未荒，是無(wú)法直接訪問(wèn)私有屬性的片排，但是對(duì)于KVC而言，一個(gè)對(duì)象沒(méi)有自己的隱私率寡，所以可以通過(guò)KVC修改和訪問(wèn)任何私有屬性乾蛤，一般用于修改系統(tǒng)類(lèi)的私有屬性家卖。

6.3 多值操作（model和字典互轉(zhuǎn)）

model和字典的轉(zhuǎn)換可以通過(guò)下面兩個(gè)KVC的API實(shí)現(xiàn)：

//字典轉(zhuǎn)模型
- (void)setValuesForKeysWithDictionary:(NSDictionary<NSString *, id> *)keyedValues;

//模型轉(zhuǎn)字典
- (NSDictionary<NSString *, id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;

6.4 修改一些系統(tǒng)空間的內(nèi)部屬性

在日常開(kāi)發(fā)中上荡，我們知道馒闷，很多UI控件都是在其內(nèi)部由多個(gè)UI控件組合而成逛薇，這些內(nèi)部控件蘋(píng)果并沒(méi)有提供訪問(wèn)的API疏虫，但是使用KVC可以解決這個(gè)問(wèn)題议薪，常用的就是自定義tabbar、個(gè)性化UITextField中的placeHolderText

6.5 用KVC實(shí)現(xiàn)高階消息傳遞

在對(duì)容器類(lèi)使用KVC時(shí)，valueForKey:將會(huì)被傳遞給容器中的每一個(gè)對(duì)象醇锚，而不是對(duì)容器本身進(jìn)行操作恋昼，結(jié)果會(huì)被添加到返回的容器中赶促，這樣鸥滨，可以很方便的操作集合 來(lái)返回 另一個(gè)集合。

//KVC實(shí)現(xiàn)高階消息傳遞
- (void)transmitMsg{
    NSArray *arrStr = @[@"english", @"franch", @"chinese"];
    NSArray *arrCapStr = [arrStr valueForKey:@"capitalizedString"];
    
    for (NSString *str in arrCapStr) {
        NSLog(@"%@", str);
    }
    
    NSArray *arrCapStrLength = [arrCapStr valueForKeyPath:@"capitalizedString.length"];
    for (NSNumber *length in arrCapStrLength) {
        NSLog(@"%ld", (long)length.integerValue);
    }
}

//********打印結(jié)果********
2020-10-27 11:33:43.377672+0800 CJLCustom[60035:6380757] English
2020-10-27 11:33:43.377773+0800 CJLCustom[60035:6380757] Franch
2020-10-27 11:33:43.377860+0800 CJLCustom[60035:6380757] Chinese
2020-10-27 11:33:43.378233+0800 CJLCustom[60035:6380757] 7
2020-10-27 11:33:43.378327+0800 CJLCustom[60035:6380757] 6
2020-10-27 11:33:43.378417+0800 CJLCustom[60035:6380757] 7