集合属性操作
根据KVO的实现原理,是在运行时生成新的子类并重写其setter方法,在其内容发生改变时发送消息。但这只是对属性直接进行赋值会触发,如果属性是容器对象,对容器对象进行add或remove操作,则不会调用KVO的方法。可以通过KVC对应的API来配合使用,使容器对象内部发生改变时也能触发KVO。
在进行容器对象操作时,先调用下面方法通过key或者keyPath获取集合对象,然后再对容器对象进行add或remove等操作时,就会触发KVO的消息通知了。
-(NSMutableArray*)mutableArrayValueForKey:(NSString*)key;-(NSMutableOrderedSet*)mutableOrderedSetValueForKey:(NSString*)keyAPI_AVAILABLE(macos(10.7),ios(5.0),watchos(2.0),tvos(9.0));-(NSMutableSet*)mutableSetValueForKey:(NSString*)key;
keyPath方法:
-(NSMutableArray*)mutableArrayValueForKeyPath:(NSString*)keyPath;-(NSMutableOrderedSet*)mutableOrderedSetValueForKeyPath:(NSString*)keyPathAPI_AVAILABLE(macos(10.7),ios(5.0),watchos(2.0),tvos(9.0));-(NSMutableSet*)mutableSetValueForKeyPath:(NSString*)keyPath;
集合运算符
KVC提供的valueForKeyPath:方法非常强大,可以通过该方法对集合对象进行“深入”操作,在其keyPath中嵌套集合运算符,例如求一个数组中对象某个属性的count。(集合对象主要指NSArray和NSSet,但不包括NSDictionary)
集合运算符格式
上面表达式主要分为三部分,left部分是要操作的集合对象,如果调用KVC的对象本来就是集合对象,则left可以为空。中间部分是表达式,表达式一般以@符号开头。后面是进行运算的属性。
集合运算符主要分为三类:
集合操作符:处理集合包含的对象,并根据操作符的不同返回不同的类型,返回值以NSNumber为主。
数组操作符:根据操作符的条件,将符合条件的对象包含在数组中返回。
嵌套操作符:处理集合对象中嵌套其他集合对象的情况,返回结果也是一个集合对象。
example
下面是为了方便模拟KVC操作,而创建的测试代码。定义Transaction类为模型类,类中包含三种类型的属性。并定义BankAccount类,其中包含一个数组,下面的代码示例就都是操作这个数组的,并且数组包含所有Transaction对象。
@interfaceTransaction:NSObject@property(nonatomic,strong)NSString*payee;@property(nonatomic,strong)NSNumber*amount;@property(nonatomic,strong)NSDate*date;@end
@interfaceBankAccount:NSObject@property(nonatomic,strong)NSArray*transactions;@end
集合操作符
集合操作符处理NSArray和NSSet及其子类这样的集合对象,并根据不同的操作符返回不同类型的对象,返回值一般都是NSNumber。
@avg用来计算集合中right keyPath指定的属性的平均值。
NSNumber*transactionAverage = [self.transactions valueForKeyPath:@"@avg.amount"];
@count用来计算集合的总数。
NSNumber*numberOfTransactions = [self.transactions valueForKeyPath:@"@count"];
备注:@count操作符比较特殊,它不需要写right keyPath,即使写了也会被忽略。
@sum用来计算集合中right keyPath指定的属性的总和。
NSNumber*amountSum = [self.transactions valueForKeyPath:@"@sum.amount"];
@max用来查找集合中right keyPath指定的属性的最大值。
NSDate*latestDate = [self.transactions valueForKeyPath:@"@max.date"];
@min用来查找集合中right keyPath指定的属性的最小值。
NSDate*earliestDate = [self.transactions valueForKeyPath:@"@min.date"];
备注:@max和@min在进行判断时,都是通过调用compare:方法进行判断,所以可以通过重写该方法对判断过程进行控制。
数组操作符
@unionOfObjects将集合对象中,所有payee对象放在一个数组中并返回。
NSArray*payees = [self.transactions valueForKeyPath:@"@unionOfObjects.payee"];
@distinctUnionOfObjects将集合对象中,所有payee对象放在一个数组中,并将数组进行去重后返回。
NSArray*distinctPayees = [self.transactions valueForKeyPath:@"@distinctUnionOfObjects.payee"];
注意:以上两个方法中,如果操作的属性为nil,在添加到数组中时会导致Crash。
嵌套操作符
由于嵌套操作符是需要对嵌套的集合对象进行操作,所以新建一个arrayOfArrays对象,其中包含两个数组,数组中存储的都是Transaction类型对象。
NSArray*moreTransactions = ....;NSArray*arrayOfArrays = @[self.transactions, moreTransactions];
@unionOfArrays是用来操作集合内部的集合对象,将所有right keyPath对应的对象放在一个数组中返回。
NSArray*collectedPayees = [arrayOfArrays valueForKeyPath:@"@unionOfArrays.payee"];
@distinctUnionOfArrays是用来操作集合内部的集合对象,将所有right keyPath对应的对象放在一个数组中,并进行排重。
NSArray*collectedDistinctPayees = [arrayOfArrays valueForKeyPath:@"@distinctUnionOfArrays.payee"];
@distinctUnionOfSets是用来操作集合内部的集合对象,将所有right keyPath对应的对象放在一个set中,并进行排重。
NSSet*collectedPayees = [arrayOfArrays valueForKeyPath:@"@distinctUnionOfSets.payee"];
小技巧
如果在集合对象中操作的属性,本来就是NSNumber类型,则可以像下面这样,直接用self代表值自身。
NSArray *array= @[@(productA.price), @(productB.price), @(productC.price), @(productD.price)];NSNumber *avg = [arrayvalueForKeyPath:@"@avg.self"];
属性验证
在调用KVC时可以先进行验证,验证通过下面两个方法进行,支持key和keyPath两种方式。验证方法默认实现返回YES,可以通过重写对应的方法修改验证逻辑。
验证方法需要我们手动调用,并不会在进行KVC的过程中自动调用。
- (BOOL)validateValue:(inoutid_Nullable * _Nonnull)ioValue forKey:(NSString*)inKey error:(outNSError**)outError;- (BOOL)validateValue:(inoutid_Nullable * _Nonnull)ioValue forKeyPath:(NSString*)inKeyPath error:(outNSError**)outError;
下面是使用验证方法的例子。在validateValue方法的内部实现中,如果传入的value或key有问题,可以通过返回NO来表示错误,并设置NSError对象。
Person *person = [[Person alloc] init];NSError*error;NSString*name =@"John";if(![person validateValue:&name forKey:@"name"error:&error]) {NSLog(@"%@", error);}
单独验证
KVC还支持对单独属性做验证,可以通过定义validate<Key>:error:格式的方法,并在方法内部实现验证代码。在编写KVC验证代码的时候,应该先查找属性有没有自定义validate方法,然后再查找validateValue:方法,如果有则调用自己实现的方法,如果两个方法都没有实现则默认返回YES。
- (BOOL)validateName:(id*)ioValue error:(NSError* __autoreleasing *)outError{if((*ioValue ==nil) || ([(NSString*)*ioValue length] <2)) {if(outError !=NULL) { *outError = [NSErrorerrorWithDomain:PersonErrorDomain code:PersonInvalidNameCode userInfo:@{NSLocalizedDescriptionKey:@"Name too short"}]; }returnNO; }returnYES;}
我觉得KVC应该支持validateValue自动验证,在调用setValue或getValue时自动进行验证,如果不符合验证规则,就调用失败。如果外界使用的地方都先调用一次validateValue的话,这是很麻烦的。当然也有解决方法,可以通过Method Swizzling方法hook住setValue和getValue方法。
NSMutableArray搜索模式
这是mutableArrayValueForKey:的默认实现,给一个key当做输入参数。在接收访问器调用的对象中,返回一个名为key的可变代理数组,这个代理数组就是用来响应外界KVO的对象,通过下面的步骤进行查找:
查找一对方法insertObject:in<Key>AtIndex:和removeObjectFrom<Key>AtIndex:(相当于NSMutableArray的原始方法insertObject:atIndex:和removeObjectAtIndex:)或者方法名是insert<Key>:atIndexes:和remove<Key>AtIndexes:(相当于NSMutableArray的原始方法insertObjects:atIndexes:和removeObjectsAtIndexes:)。
如果找到最少一个insert方法和最少一个remove方法,则返回一个代理对象,来响应发送给NSMutableArray的组合消息insertObject:in<Key>AtIndex:、removeObjectFrom<Key>AtIndex:、insert<Key>:atIndexes:,和remove<Key>AtIndexes:消息。
当对象接收一个mutableArrayValueForKey:消息并实现可选替换方法,例如replaceObjectIn<Key>AtIndex:withObject:或replace<Key>AtIndexes:with<Key>:方法,代理对象会在适当的情况下使用它们,以获得最佳性能。
如果对象没有可变数组方法,查找一个替代方法,命名格式为set<Key>:。在这种情况下,向mutableArrayValueForKey:的原始响应者发送一个set<Key>:消息,来返回一个代理对象来响应NSMutableArray事件。
提示:
这一步描述的机制远不如上一步有效,因为它可能重复创建新的集合对象,而不是修改现有的对象。因此,在自己设计的KVC时应该尽量避免它。
如果没有可变数组的方法,也没有找到访问器,但接受响应的类accessInstanceVariablesDirectly属性返回YES,则查找一个名为_<key>或<key>的实例变量。
按照这个顺序,如果找到实例变量,则返回一个代理对象。改对象将接收所有NSMutableArray发送过来的消息,通常是NSMutableArray或其子类。
如果所有情况都失败,则返回一个可变的集合代理对象。当它接收NSMutableArray消息时,发送一个setValue:forUndefinedKey:消息给接收mutableArrayValueForKey:消息的原始对象。
这个setValue:forUndefinedKey:的默认实现是提出一个NSUndefinedKeyException异常,但是子类可以重写这个实现。
作者:刘小壮
链接:https://www.jianshu.com/p/1d39bc610a5b
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。
网友评论