[Accessor Search Implementation Details]
Key-value coding attempts to use accessor methods to get and set values, before resorting to directly accessing the instance variable.
Key-value coding 优先使用accessor methods走获取与设置数据,之后再使直接访问instance variable.
[Accessor Search Patterns for Simple Attributes]
Default Search Pattern for setValue:forKey:
When the default implementation of setValue:forKey:
is
invoked for a property the following search pattern is used:
-
The receiver’s class is searched for an accessor method whose name matches the pattern
set<Key>:
. -
If no accessor is found, and the receiver’s class method
accessInstanceVariablesDirectly
returnsYES
, the receiver is searched for an instance variable whose name matches the pattern_<key>
,_is<Key>
,<key>
, oris<Key>
, in that order. -
If a matching accessor or instance variable is located, it is used to set the value.
-
If no appropriate accessor or instance variable is found,
setValue:forUndefinedKey:
is invoked for the receiver.
Default Search Pattern for valueForKey:
When the default implementation of valueForKey:
is
invoked on a receiver, the following search pattern is used:
-
Searches the class of the receiver for an accessor method whose name matches the pattern
get<Key>
,<key>
, oris<Key>
, in that order. If such a method is found it is invoked. -
Otherwise (no simple accessor method is found), searches the class of the receiver for methods whose names match the patterns
countOf<Key>
andobjectIn<Key>AtIndex:
(corresponding to the primitive methods defined by theNSArray
class) and<key>AtIndexes:
(corresponding to theNSArray
methodobjectsAtIndexes:
).If the
countOf<Key>
method and at least one of the other two possible methods are found, a collection proxy object that responds to allNSArray
methods is returned. EachNSArray
message sent to the collection proxy object will result in some combination ofcountOf<Key>
,objectIn<Key>AtIndex:
, and<key>AtIndexes:
messages being sent to the original receiver ofvalueForKey:
. If the class of the receiver also implements an optional method whose name matches the patternget<Key>:range:
that method will be used when appropriate for best performance. -
Otherwise (no simple accessor method or set of array access methods is found), searches the class of the receiver for a threesome of methods whose names match the patterns
countOf<Key>
,enumeratorOf<Key>
, andmemberOf<Key>:
(corresponding to the primitive methods defined by theNSSet
class).If all three methods are found, a collection proxy object that responds to all
NSSet
methods is returned. EachNSSet
message sent to the collection proxy object will result in some combination ofcountOf<Key>
,enumeratorOf<Key>
, andmemberOf<Key>:
messages being sent to the original receiver ofvalueForKey:
. -
Otherwise (no simple accessor method or set of collection access methods is found), if the receiver‘s class method
accessInstanceVariablesDirectly
returnsYES
, the class of the receiver is searched for an instance variable whose name matches the pattern_<key>
,_is<Key>
,<key>
, oris<Key>
, in that order. If such an instance variable is found, the value of the instance variable in the receiver is returned. If the type of the result is one of the scalar types supported byNSNumber
conversion is done and anNSNumber
is returned. Otherwise, conversion is done and anNSValue
is returned. Results of arbitrary types are converted toNSValue
objects, not justNSPoint
,NSRange
,NSRect
, andNSSize
types. -
If none of the above situations occurs, returns a result the default implementation invokes
valueForUndefinedKey:
.