【iOS】KVC总结

#key

如下声明了一个 BankAccount 类：

1
@interface BankAccount : NSObject
2
@property (nonatomic) NSNumber* currentBalance;              // An attribute
3
@property (nonatomic) Person* owner;                         // A to-one relation
4
@property (nonatomic) NSArray< Transaction* >* transactions; // A to-many relation
5
@end

对于 BankAccount 的实例对象 myAccout。我们可以使用 setter 方法为 current 属性赋值，这是直接的，但是缺乏灵活性。

1
[myAccount setCurrentBalance:@(100.0)];
2

3
//听过KVC间接为currentBalance属性赋值，通过其键key设置
4
[myAccount setValue:@(100.0) forKey:@"currentBalance"];
5
### KeyPath
6

7

8
KVC还支持 多级访问 ，keyPath用法和点语法相同。例如：我们想对myAccount的owner属性的address属性的street赋值，其keyPath为**owner.address.street**.
9

10

11
```objective-c
12
[myAccount setValue:@"地址" forKeyPath:@"owner.address.street"];
13
### 多值操作
14

15

16
给定一组key，获得一组value，以字典形式返回。该方法为数组中每个Key调用 valueForKey：  方法
17

18

19
```objective-c
20
- (NSDictionary<NSString *,id> *)dictionaryWithValuesForKeys:(NSArray<NSString *> *)keys;

将指定字典中的值设置到消息接收者的属性中，使用字典的 Key 标识属性。默认实现是为每个键值对调用 setValue:forKey

1
- (void)setValuesForKeysWithDictionary:(NSDictionary<NSString *,id> *)keyedValues;

可能还是有同学不明白。我再来解释一下：

dictionaryWithValuesforKeys 是将对象转化为字典。

1
Person *p = [[Person alloc] init];
2
p.name = @"吴桐";
3
p.age = 19;
4
p.city = @"西安";
5

6
NSDictionary *info = [p dictionaryWithValuesForKeys:@[@"name", @"age"]];
7
NSLog(@"%@", info);

你传入了一个键名数组，方法会按照顺序读取对象对应的属性值。

返回的字典中：key 是字符串（属性名），value 是属性的值

setValuesForKeysWithDictionary 是将字典转化为对象

1
NSDictionary *dict = @{
2
    @"name": @"吴桐",
3
    @"age": @19,
4
    @"city": @"西安"
5
};
6

7
Person *p = [[Person alloc] init];
8
[p setValuesForKeysWithDictionary:dict];
9

10
NSLog(@"%@ - %ld - %@", p.name, (long)p.age, p.city);

系统会遍历 dict 的所有键，调用 setValue：forKey：给对象属性赋值，只要字典的键名与属性名匹配，就能成功设置。

dictionaryWithValuesForKeys: 是 “导出” 对象属性到字典。 setValuesForKeysWithDictionary: 是 “导入” 字典数据到对象。

二者方向相反，但底层都是通过 KVC 的 forKey: / forKeyPath: 实现的. 在开发中： 从网络获取 JSON 并转模型 [p setValuesForKeysWithDictionary

]; 将模型转为字典方便保存 / 上传 [p dictionaryWithValuesForKeys:@[@“name”, @“age”, @“city”]];

#访问集合属性

我们可以像访问其它对象一样使用 valueForKey: 或 setValue:forKey: 方法来获取或设置集合对象（主要指 NSArray 和 NSSet）。但是，当我们要操作集合对象的内容，比如添加或者删除元素时，通过 KVC 的可变代理方法获取集合代理对象是最有效的。

根据 KVO 的实现原理，是在运行时动态生成子类并 重写 setter 方法来达到可以通知所有观察者对象的目的，因此我们对集合对象进行操作是不会触发 KVO 的。

当我们要使用 KVO 监听集合对象变化时，需要通过 KVC 的可变代理方法获取集合代理对象，然后对代理对象进行操作。

当代理对象的内部对象发生改变时，会触发 KVO 的监听方法。

KVC 提供了三种不同的代理对象访问的代理方法，每种都有 Key 和 KeyPath 两种方法。

mutableArrayValueForKey: 和 mutableArrayValueForKeyPath: 返回 NSMutableArray 对象的代理对象。

mutableSetValueForKey: 和 mutableSetValueForKeyPath: 返回 NSMutableSet 对象的代理对象。

mutableOrderedSetValueForKey: 和 mutableOrderedSetValueForKeyPath: 返回 NSMutableOrderedSet 对象的代理对象。

这些返回的不是实际集合本身，而是一个特殊的 “代理对象”：

・ 当你在这个代理对象上调用 addObject:、removeObject: 等操作时，

它内部会自动帮你调用

willChangeValueForKey: 和 didChangeValueForKey:，

让 KVO 能检测到变化。

1
@interface Person : NSObject
2
@property (nonatomic, strong) NSMutableArray *friends;
3
@end
4

5
@implementation Person
6
- (instancetype)init {
7
    if (self = [super init]) {
8
        _friends = [NSMutableArray array];
9
    }
10
    return self;
11
}
12
@end

1
Person *p = [[Person alloc] init];
2
[p addObserver:self
3
    forKeyPath:@"friends"
4
       options:NSKeyValueObservingOptionNew | NSKeyValueObservingOptionOld
5
       context:nil];

1
[p.friends addObject : @"Tommy"];

1
NSMutableArray *proxyArray = [p mutableArrayValueForKey:@"friends"];
2
[proxyArray addObject:@"Tommy"];

1
friends changed:
2
old = ()
3
new = (Tommy)

1
+--------------------------+
2
|  Person (被观察者)       |
3
|  friends = NSMutableArray|
4
+--------------------------+
5
            ▲
6
            | 调用 mutableArrayValueForKey:
7
            |
8
   返回一个代理对象 (NSKeyValueMutableArray)
9
            |
10
     当你调用 add/remove 等操作时
11
            ↓
12
 willChangeValueForKey:@"friends"
13
 [friends addObject:...]
14
 didChangeValueForKey:@"friends"
15
            ↓
16
       通知 KVO 观察者

#聚合运算符

1
// 计算上表中 amount 的平均值。
2
NSNumber *transactionAverage = [self.transactions valueForKeyPath:@"@avg.amount"];
3
// transactionAverage 格式化的结果为 $ 456.54。
4
#### @count
5

6

7
计算集合中的元素个数，以NSNumber实例返回。
8

9

10
```objective-c
11
// 计算 transactions 集合中的元素个数。
12
NSNumber *numberOfTransactions = [self.transactions valueForKeyPath:@"@count"];
13
// numberOfTransactions 的值为 13。

1
// 计算上表中 amount 的总和。
2
NSNumber *amountSum = [self.transactions valueForKeyPath:@"@sum.amount"];
3
// amountSum 的结果为 $ 5935.00。
4
#### @max / @min
5

6

7
**返回集合中右键路径制定的属性的最小值或最大值**
8

9

10
```objective-c
11
// 获取日期的最大值。
12
NSDate *latestDate = [self.transactions valueForKeyPath:@"@max.date"];
13
// latestDate 的值为 Jul 15, 2016.
14

15

16
// 获取日期的最小值。
17
NSDate *earliestDate = [self.transactions valueForKeyPath:@"@min.date"];
18
// earliestDate 的值为 Dec 1, 2015.

#数组运算符

根据符合运算符的条件，将符合条件的对象以一个 NSArray 实例返回。

1
// 获取集合中的所有 payee 对象。
2
NSArray *payees = [self.transactions valueForKeyPath:@"@unionOfObjects.payee"];
3
// payees 数组包含以下字符串：Green Power, Green Power, Green Power, Car Loan, Car Loan, Car Loan, General Cable, General Cable, General Cable, Mortgage, Mortgage, Mortgage, Animal Hospital。
4
#### @distinctUnionOfObjects
5

6

7
读取数组中每个元素的右键路径指定的属性，放在一个NSArray实例中，将数组进行去重后返回。
8

9

10
```objective-c
11
// 获取集合中的所有不同的 payee 对象。
12
NSArray *distinctPayees = [self.transactions valueForKeyPath:@"@distinctUnionOfObjects.payee"];
13
// distinctPayees 数组包含以下字符串：Car Loan, General Cable, Animal Hospital, Green Power, Mortgage。

#嵌套运算符

处理集合对象中嵌套其他集合对象的情况，并根据运算符返回一个 NSArray 或 NSSet 实例。

如下 moreTransactions 是装着 transaction 对象的数组，arrayOfArrays 数组中嵌套了 self.transactions 和 moreTransactions 两个数组。

1
NSArray* moreTransactions = @[<# transaction data #>];
2
NSArray* arrayOfArrays = @[self.transactions, moreTransactions];
3
#### @unionOfArrays
4

5

6
读取集合中的每个集合中的每个元素的右键路径的制定的属性，放在一个NSArray实例中返回。
7

8

9
```objective-c
10
// 获取 arrayOfArrays 集合中的每个集合中的所有 payee 对象。
11
NSArray *collectedPayees = [arrayOfArrays valueForKeyPath:@"@unionOfArrays.payee"];
12
// collectedPayees 数组包含以下字符串：Green Power, Green Power, Green Power, Car Loan, Car Loan, Car Loan, General Cable, General Cable, General Cable, Mortgage, Mortgage, Mortgage, Animal Hospital, General Cable - Cottage, General Cable - Cottage, General Cable - Cottage, Second Mortgage, Second Mortgage, Second Mortgage, Hobby Shop.
13
#### distinctUnionOfArrays
14

15

16
读取集合中的每个集合中的每个元素的右键路径制定的属性，放在一个 NSArray 实例中，将数组去重后返回，用法与上相似。
17

18

19
#### @distinctUnionOfSets
20

21

22
读取集合中的每个集合中的每个元素的右键路径指定的属性，放在一个NSSet实例中，去重后返回。
23

24

25
```objective-c
26
NSSet *collectedDistinctPayees = [setOfSets valueForKeyPath:@"@distinctUnionOfSets.payee"];

注意： - 在使用嵌套运算符时，valueForKeyPath

，将集合中的 array 和 set 添加进去再进行操作。如果集合中有非集合元素，会导致 Crash。 - 使用 unionOfArrays 或 distinctUnionOfArrays 运算符，消息接收者应该是 arrayOfArrays 类型，即 NSArray * arrayOfArrays;；使用 distinctUnionOfSets 运算符，消息接收者应该是 setOfSets 或者 arrayOfSets 类型。否则会发生异常。 - 在使用嵌套运算符时，如果有任何操作的对象为 nil， 则 valueForKeyPath

。

1
NSArray *array = @[@1, @2, @3, @4, @5];
2
    NSNumber *sum = [array valueForKeyPath:@"@sum.self"];
3
    NSLog(@"%d",[sum intValue]);

#set（设值）

** 当调用 setValue:forKey

【第一步】首先查找是否有这三种 setter 方法，按照查找顺序为set< Key>：-> _set< Key> -> setIs< Key>

• 如果有其中任意一个 setter 方法，则直接设置属性的 value（主注意：key 是指成员变量名，首字符大小写需要符合 KVC 的命名规范）

• 如果都没有，则进入【第二步】

【第二步】：如果没有第一步中的三个简单的 setter 方法，则查找accessInstanceVariablesDirectly是否返回 YES，

• 如果返回 YES，则查找间接访问的实例变量进行赋值，查找顺序为：_ -> _is -> -> is

• 如果找到其中任意一个实例变量，则赋值

• 如果都没有，则进入【第三步】

• 如果返回 NO，则进入【第三步】

【第三步】如果 setter 方法 或者 实例变量都没有找到，系统会执行该对象的 setValue：forUndefinedKey

#get（取值）

当调用 **valueForKey：** 时，其底层的执行流程如下

• 【第一步】首先查找 getter 方法，按照 get -> -> is -> _ 的方法顺序查找，

• 如果找到，则进入【第五步】

• 如果没有找到，则进入【第二步】

• 【第二步】如果第一步中的 getter 方法没有找到，KVC 会查找 countOf 和 objectIn AtIndex

  AtIndexes :

• 如果找到 countOf 和其他两个中的一个，则会创建一个响应所有 NSArray 方法的集合代理对象，并返回该对象，即NSKeyValueArray，是 NSArray 的子类。代理对象随后将接收到的所有 NSArray 消息转换为 **countOf ，objectIn AtIndex：和 AtIndexes：** 消息的某种组合，用来创建键值编码对象。如果原始对象还实现了一个名为 get ：range：之类的可选方法，则代理对象也将在适当时使用该方法（注意：方法名的命名规则要符合 KVC 的标准命名方法，包括方法签名。）

• 如果没有找到这三个访问数组的，请继续进入【第三步】

• 【第三步】如果没有找到上面的几种方法，则会同时查找countOf ，enumeratorOf 和 memberOf 这三个方法

• 如果这三个方法都找到，则会创建一个响应所有 NSSet 方法的集合代理对象，并返回该对象，此代理对象随后将其收到的所有 NSSet 消息转换为 **countOf ，enumeratorOf 和 memberOf ：** 消息的某种组合，用于创建它的对象

• 如果还是没有找到，则进入【第四步】

• 【第四步】如果还没有找到，检查类方法InstanceVariablesDirectly是否 YES，依次搜索_ ，_is ， 或 is 的实例变量

• 如果搜到，直接获取实例变量的值，进入【第五步】

• 【第五步】根据搜索到的属性值的类型，返回不同的结果

• 如果是对象指针，则直接返回结果

• 如果是 NSNumber 支持的标量类型，则将其存储在 NSNumber 实例中并返回它

• 如果是是 NSNumber 不支持的标量类型，请转换为 NSValue 对象并返回该对象

• 【第六步】如果上面 5 步的方法均失败，系统会执行该对象的 valueForUndefinedKey

  ，默认抛出 NSUndefinedKeyException 类型的异常

#Q：通过 KVC 修改属性会触发 KVO 吗？

会，通过 KVC 修改成员变量值也会触发 KVO。

#Q：通过 KVC 键值编码技术是否会破坏面向对象的编程方法，或者说违背面向对象的编程思想呢？

valueForKey: 和 setValue:forKey

原文发布于 CSDN：【iOS】KVC 总结