mutableArrayValueForKey 的 KVC 搜索模式是什么？

Question

我试图更好地理解 Cocoa 的键值编码（KVC）机制。我已阅读 Apple 的 键值编程指南 但我对某些 KVC 方法如何搜索密钥仍然有点困惑。特别是，mutableArrayValueForKey：。

下面我将解释我如何理解 valueForKey: KVC“getters” 的工作原理。然后我将回答有关 mutableArrayValueForKey 的问题。

---

有七种不同的“getter”KVC 方法：

- (id)valueForKey:(NSString *)key;
- (id)valueForKeyPath:(NSString *)keyPath;
- (NSDictionary *)dictionaryWithValuesForKeys:(NSArray *)keys;
- (NSMutableArray *)mutableArrayValueForKey:(NSString *)key;
- (NSMutableArray *)mutableArrayValueForKeyPath:(NSString *)keyPath;
- (NSMutableSet *)mutableSetValueForKey:(NSString *)key;
- (NSMutableSet *)mutableSetValueForKeyPath:(NSString *)keyPath;

在属性内搜索值（名为 myKey）时，Apple 文档指出 valueForKey: 搜索如下：

1. 尝试 -getMyKey、-myKey 和 -isMyKey（按该顺序）在接收器内

2. 如果未找到，它会尝试这些有序的，以-许多吸气剂（NSArray）：

   // 必需：
   - (NSUInteger)countOfMyKey；
   
   // 至少需要一个：
   - (id)objectInMyKeyAtIndex:(NSUInteger)索引；
   - (NSArray *)myKeyAtIndexes:(NSIndexSet *)索引；
   
   // 可选（提高性能）：
   - (void)getMyKey:(KeyClass **)缓冲区范围:(NSRange)inRange;
   

3. 接下来，它会尝试这些无序的、一对多的 g​​etter (NSSet)：

   - (NSUInteger)countOfMyKey;
   - (NSEnumerator *)enumeratorOfMyKey;
   - (KeyClass *)memberOfMyKey:(KeyClass *)anObject;
   

4. 接下来，它尝试直接访问实例变量，假设 YES 返回为 YES >accessInstanceVariablesDirectly，按此顺序：_myKey、_isMyKey、myKey、isMyKey。

5. 最后，它放弃并调用接收类的 - (id)valueForUndefinedKey:(NSString *)key 方法。通常这里会引发错误。

---

我的问题是，mutableArrayValueForKey的搜索顺序模式是什么？

Apple 的文档声明了这一点：

有序的访问器搜索模式 收藏

默认搜索模式 mutableArrayValueForKey：如下 如下：

搜索接收者的类别 名称匹配的方法对 模式 -insertObject:inAtIndex: 和-removeObjectFromAtIndex： （对应NSMutableArray 原始方法 插入对象：atIndex：和 分别删除ObjectAtIndex：），或 匹配模式的方法 -insert:atIndexes: 和 -removeAtIndexes: （对应于 NSMutableArrayinsertObjects:atIndexes: 和removeObjectsAtIndexes: 方法）。 如果至少一种插入方法和 至少找到一种去除方法 每个 NSMutableArray 消息发送到 集合代理对象将 导致某种组合 -insertObject:inAtIndex:、-removeObjectFromAtIndex:、-insert:atIndexes: 和 -removeAtIndexes：发送到原始接收者的消息 mutableArrayValueForKey:. ...等等...

这对我来说毫无意义，因为它正在讨论“setter”之类的方法。 mutableArrayValueForKey： 返回一个 NSMutableArray。上面列出的所有方法都返回 void，并且用于编辑 NSMutableArray，而不是获取它。示例：

- (void)insertMyKey:(KeyClass *)keyObject inMyKeyAtIndex:(NSUInteger)index;
- (void)removeObjectFromMyKeyAtIndex:(NSUInteger)index;

知道 Apple 在他们的文档中试图说什么，或者这是否可能是一个错误？

我的理论是，在搜索检索 KVC 值时，mutableArrayValueForKey: 可能会采用与 valueForKey: 类似的路径。我只是不确定那到底是什么路。

感谢您提供的任何帮助！ :)

Answer 1

从调用 mutableArrayValueForKey: 返回的 NSMutableArray 实际上是 NSMutableArray 的私有子类，它覆盖了普通的数组方法，例如 -count< /code>、-objectAtIndex:、-insertObject:atIndex: 等，并在从中检索数组的对象上调用相应的 KVC 方法。它基本上充当操作对象的多对多关系的代理，并且您不必担心自己创建或返回它。一个简单的用法示例：

Playlist* aPlaylist;
Track* aTrack;
NSMutableArray* mutableTracks = [aPlaylist mutableArrayValueForKey:@"tracks"];
[mutableTracks insertObject:aTrack atIndex:0];

这段代码将一个曲目添加到播放列表的开头。如果 Playlist 类为其“曲目”关系实现 KVC 方法，则在可变数组上调用方法将导致在底层对象上调用适当的方法。因此，在此示例中，当您对数组调用 insertObject:atIndex: 时，数组将依次对播放列表对象调用 insertObjectInTracks:atIndex:，并添加曲目到播放列表的曲目数组。

现在，在这个示例中，您当然可以直接调用 insertObjectInTracks:atIndex:，但是使用 mutableArrayValueForKey: 可以带来一些好处。

• 数组包装器隐藏了底层 KVC 方法的实现细节。实现整个方法列表并不严格要求符合 KVC。 Playlist 类可以只实现 -tracks 和 -setTracks:，上面的代码仍然有效。在这种情况下，可变数组代理将创建一个新数组，并在开头插入对象，而不是调用 insertObjectInTracks:atIndex:，然后只需调用 setTracks:播放列表对象。这显然效率较低，因此通常建议实现 KVC 方法的完整列表。
• 在这种情况下，您可以使用变量代替键的常量字符串，使用 mutableArrayValueForKey: 允许您操纵关系，而无需知道必须调用的方法的确切名称。只要该对象对于您正在使用的密钥来说符合 KVC，一切都会“正常工作”。
• 它还允许您使用 NSMutableArray 本身实现的任何方法，例如您可以使用在数组中搜索对象、对数组进行排序等的方法，而无需重写特殊版本来处理 KVC东西。