kylefang/RestKit
1
0
Fork 0
mirror of https://github.com/zhigang1992/RestKit.git synced 2026-04-28 12:45:33 +08:00
Code Issues Packages Projects Releases Wiki Activity

Updated polymorphic mapping to use valueForKeyPath. Slight updates to the documentation. refs #105

Browse Source
This commit is contained in:
Blake Watters
2011-07-30 16:18:14 -04:00
parent 670234b775
commit eab35ef3f7
5 changed files with 23 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
Docs/Object Mapping.md
View File

@@ -651,8 +651,8 @@ RKObjectPolymorphicMapping* polymorphicMapping = [RKObjectPolymorphicMapping pol
[[RKObjectManager sharedManager].mappingProvider setMapping:polymorphicMapping forKeyPath:@"people"];
// Configure the polymorphic mapping via matchers
[polymorphicMapping setObjectMapping:boyMapping whenValueOfKey:@"type" isEqualTo:@"Boy"];
[polymorphicMapping setObjectMapping:girlMapping whenValueOfKey:@"type" isEqualTo:@"Girl"];
[polymorphicMapping setObjectMapping:boyMapping whenValueOfKeyPath:@"type" isEqualTo:@"Boy"];
[polymorphicMapping setObjectMapping:girlMapping whenValueOfKeyPath:@"type" isEqualTo:@"Girl"];
// Configure the polymorphic mapping via a delegate
polymorphicMapping.delegate = self;
@@ -684,6 +684,12 @@ polymorphicMapping.delegateBlock = ^ RKObjectMapping* (id mappableData) {
};
```
Notable within this code are the calls to `setObjectMapping:whenValueOfKeyPath:isEqualTo:`. This is the declarative
matcher form of polymorphic configuration. When you use these matchers, RestKit will invoke `valueForKeyPath:` on your
mappable data and then attempt to compare the resulting value with the value provided in the invocation. If you have
a simple string or numeric value that can be used to differentiate your mappings, then you don't need to use the
delegate or block callbacks at all to perform polymorphic mapping.
That's all there is to it. RestKit will invoke the polymorphic mapping with the data and apply whatever object
mapping is returned to that data. You can even decline the mapping of individual elements by returning a nil mapping.
This can be useful to filter out unwanted information deep within an object graph.