dailyLearning -- KVC

一、KVC是什么?

Key-Value-Coding, 即键值编码. 它是一种不通过存取方法, 而是通过属性名称字符串间接访问属性的机制.是指在 iOS 开发中,允许开发者通过 字符串键和键路径直接访问或赋值对象属性.

在Cocoa中是以被万物之源NSObject类实现的 NSKeyValueCoding 非正式协议的形式被定义为基础框架的一部分. 从协议的角度来说, KVC本质上是定义了一套让我们去遵守和实现的方法. 所以对于所有继承了NSObject的类型, 也就是几乎所有的Objective-C对象都能使用KVC.KVO 就是基于 KVC 实现的关键技术之一.

二、KVC主要方法

  1. KVC定义了一种按名称访问对象属性的机制,支持这种访问的主要方法是:
//直接通过Key来取值
- (nullable id)valueForKey:(NSString *)key;      
//通过Key来设值                    
- (void)setValue:(nullable id)value forKey:(NSString *)key;          
//通过KeyPath来取值
- (nullable id)valueForKeyPath:(NSString *)keyPath; 
 //通过KeyPath来设值                 
- (void)setValue:(nullable id)value forKeyPath:(NSString *)keyPath; 

前边两个方法用到的Key较容易理解, 就是要访问的属性名称对应的字符串.
后面两个方法用到的KeyPath是一个被点操作符隔开的用于访问对象的指定属性的字符串序列.
比如:

[person setValue:@100 forKeyPath:@"account.balance"];

将会访问消息接收对象(person)所包含的 account 属性中的 balance 属性, 并赋值 100.
其实KeyPath说白了就是我们平时使用点操作访问某个对象的属性时所写的那个字符串.

  1. 当然NSKeyValueCoding类别中还有其他的一些方法:
//默认返回YES, 表示如果没有找到Set<Key>方法的话, 会按照_key, _iskey, key, iskey的顺序搜索成员, 设置成NO就不这样搜索
+ (BOOL)accessInstanceVariablesDirectly;

//KVC提供属性值正确性验证的API, 它可以用来检查set的值是否正确, 为不正确的值做一个替换值或者拒绝设置新值并返回错误原因.
- (BOOL)validateValue:(inout id __nullable * __nonnull)ioValue forKey:(NSString *)inKey error:(out NSError **)outError;

//这是集合操作的API, 里面还有一系列这样的API, 如果属性是一个NSMutableArray, 那么可以用这个方法来返回
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;

//如果Key不存在, 且没有KVC无法搜索到任何和Key有关的字段或者属性, 则会调用这个方法, 默认是抛出异常
- (nullable id)valueForUndefinedKey:(NSString *)key;

//和上一个方法一样, 但这个方法是设值
- (void)setValue:(nullable id)value forUndefinedKey:(NSString *)key;

//如果你在SetValue方法时面给Value传nil, 则会调用这个方法
- (void)setNilValueForKey:(NSString *)key;

//输入一组key,返回该组key对应的Value, 再转成字典返回,用于将Model转到字典
- (NSDictionary<NSString *, id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;

三、KVC是如何通过 key 来访问对象属性的?

KVC 在某种程度上提供了替代存取方法(访问器方法)的方案.不过存取方法终究是个好东西, 以至于只要有可能, KVC 也尽可能先尝试使用存取方法访问属性. 当 KVC 访问属性时, 其内部做了很多事.

  • setValue:forKey:搜索方式
    1、首先搜索setKey:方法.(key指成员变量名,首字母大写)
    2、上面的setter方法没找到, 如果类方法 accessInstanceVariablesDirectly 返回 YES(NSKeyValueCodingCatogery中实现的类方法, 默认实现为返回YES). 那么按 _key, _isKey, key, iskey 的顺序搜索成员名.
    3、如果没有找到成员变量,调用 setValue: forUndefinedKey:默认抛出异常.
  • valueForKey:的搜索方式
    1、首先按 getKey, key, isKey 的顺序查找 getter 方法, 找到直接调用. 如果是 BOOL、int 等数据类型,会做NSNumber的转换.
    2、上面的 getter 没找到, 查找countOfKey、objectInKeyAtindex、KeyAtindexes 格式的方法. 如果 countOfKey 和另外两个方法中的一个找到, 那么就会返回一个可以响应 NSArray 所有方法的代理集合的 NSArray 消息方法.
    3、还没找到, 查找countOfKey、enumeratorOfKey、memberOfKey 格式的方法. 如果这三个方法都找到, 那么就返回一个可以响应 NSSet 所有方法的代理集合.
    4、还是没找到, 如果类方法 accessInstanceVariablesDirectly 返回 YES. 那么按 _key, _isKey, key, iskey 的顺序搜索成员名.
    5、再没找到, 调用 valueForUndefinedKey: 默认抛出异常.

当然, 如果开发者想让这个类禁用 KVC 里,那么重写 + (BOOL)accessInstanceVariablesDirectly 方法让其返回 NO 即可,这样的话如果 KVC 没有找到 set<Key>:属性名时,会直接用 setValue:forUndefinedKey:方法。

四、KVC异常处理

需要注意的是:

  • value 赋值为 nil
    如果给 value 赋值一个 nil,KVC 会调用 setNilValueForKey: 方法。这个方法默认是抛出异常,所以一般而言最好还是重写这个方法。
  • key 书写错误
    一旦使用 KVC 你的编译器无法检查出错误, 即不会对设置的键、键路径进行错误检查. 所以, 如果不小心书写了错误的 key, KVC 会调用setValueForKey: 方法. 这个方法默认是抛出异常, 将会直接导致程序崩溃, 所以一般而言最好还是重写这个方法.

参考:
NSKeyValueObserving Protocol Reference
Apple developer

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,496评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,407评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,632评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,180评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,198评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,165评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,052评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,910评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,324评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,424评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,017评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2 353

推荐阅读更多精彩内容

  • KVC(Key-value coding)键值编码,单看这个名字可能不太好理解。其实翻译一下就很简单了,就是指iO...
    黑暗中的孤影阅读 49,721评论 74 441
  • KVC(Key-value coding)键值编码,单看这个名字可能不太好理解。其实翻译一下就很简单了,就是指iO...
    朽木自雕也阅读 1,558评论 6 1
  • 简介 KVC(Key-value coding)键值编码,翻译一下就是指iOS的开发中,可以允许开发者通过Key名...
    6ffd6634d577阅读 1,308评论 1 9
  • KVC(Key-value coding)键值编码,单看这个名字可能不太好理解。其实翻译一下就很简单了,就是指iO...
    Fendouzhe阅读 674评论 0 6
  • 感恩2017,我的变化太大了! 感恩所有我遇见的,与我同行的,当时让我误会却给我很多反思和力量的人! 感恩身边陪伴...
    lolipop很慢阅读 260评论 0 0