mirror of
https://github.com/zhigang1992/RestKit.git
synced 2026-04-02 22:42:45 +08:00
3d0f0ab39e
RKTableController provides a flexible, integrated system for driving iOS table views using the RestKit object mapping engine. Local domain objects can be mapped into table cells within a collection or presented for editing as part of a form. There are three flavors of table controllers available: * Static Tables: RKTableController can be used to render simple static tables that are composed of RKTableItems presented in RKTableSections. Table items can quickly be built and added to a table without a backing model or can have content object mapped into them for presentation. * Network Tables: RKTableController can also render a table with the results of a network load. The typical use case here is to have RestKit retrieve a JSON/XML payload from your remote system and then render the content into a table. * Core Data Tables: RKFetchedResultsTableController can efficiently drive a table view using objects pulled from a Core Data managed object context. Typical use-cases here are for the presentation of large collections that are pulled from a remote system, offering offline access, or speeding up a UI by using Core Data as a fast local cache. RKTableController supports a number of bells and whistles including integrated searching/filtering and pull to refresh.
113 lines
3.5 KiB
Objective-C
113 lines
3.5 KiB
Objective-C
//
|
|
// RKDynamicObjectMapping.m
|
|
// RestKit
|
|
//
|
|
// Created by Blake Watters on 7/28/11.
|
|
// Copyright 2011 Two Toasters
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//
|
|
|
|
#import "RKDynamicObjectMapping.h"
|
|
#import "RKDynamicObjectMappingMatcher.h"
|
|
#import "RKLog.h"
|
|
|
|
// Set Logging Component
|
|
#undef RKLogComponent
|
|
#define RKLogComponent lcl_cRestKitObjectMapping
|
|
|
|
|
|
@implementation RKDynamicObjectMapping
|
|
|
|
@synthesize delegate = _delegate;
|
|
@synthesize objectMappingForDataBlock = _objectMappingForDataBlock;
|
|
@synthesize forceCollectionMapping = _forceCollectionMapping;
|
|
|
|
+ (RKDynamicObjectMapping*)dynamicMapping {
|
|
return [[self new] autorelease];
|
|
}
|
|
|
|
#if NS_BLOCKS_AVAILABLE
|
|
|
|
+ (RKDynamicObjectMapping *)dynamicMappingUsingBlock:(void(^)(RKDynamicObjectMapping *))block {
|
|
RKDynamicObjectMapping* mapping = [self dynamicMapping];
|
|
block(mapping);
|
|
return mapping;
|
|
}
|
|
|
|
+ (RKDynamicObjectMapping*)dynamicMappingWithBlock:(void(^)(RKDynamicObjectMapping*))block {
|
|
return [self dynamicMappingUsingBlock:block];
|
|
}
|
|
|
|
#endif
|
|
|
|
- (id)init {
|
|
self = [super init];
|
|
if (self) {
|
|
_matchers = [NSMutableArray new];
|
|
}
|
|
|
|
return self;
|
|
}
|
|
|
|
- (void)dealloc {
|
|
[_matchers release];
|
|
[super dealloc];
|
|
}
|
|
|
|
- (void)setObjectMapping:(RKObjectMapping*)objectMapping whenValueOfKeyPath:(NSString*)keyPath isEqualTo:(id)value {
|
|
RKLogDebug(@"Adding dynamic object mapping for key '%@' with value '%@' to destination class: %@", keyPath, value, NSStringFromClass(objectMapping.objectClass));
|
|
RKDynamicObjectMappingMatcher* matcher = [[RKDynamicObjectMappingMatcher alloc] initWithKey:keyPath value:value objectMapping:objectMapping];
|
|
[_matchers addObject:matcher];
|
|
[matcher release];
|
|
}
|
|
|
|
- (RKObjectMapping*)objectMappingForDictionary:(NSDictionary*)data {
|
|
NSAssert([data isKindOfClass:[NSDictionary class]], @"Dynamic object mapping can only be performed on NSDictionary mappables, got %@", NSStringFromClass([data class]));
|
|
RKObjectMapping* mapping = nil;
|
|
|
|
RKLogTrace(@"Performing dynamic object mapping for mappable data: %@", data);
|
|
|
|
// Consult the declarative matchers first
|
|
for (RKDynamicObjectMappingMatcher* matcher in _matchers) {
|
|
if ([matcher isMatchForData:data]) {
|
|
RKLogTrace(@"Found declarative match for data: %@.", [matcher matchDescription]);
|
|
return matcher.objectMapping;
|
|
}
|
|
}
|
|
|
|
// Otherwise consult the delegates
|
|
if (self.delegate) {
|
|
mapping = [self.delegate objectMappingForData:data];
|
|
if (mapping) {
|
|
RKLogTrace(@"Found dynamic delegate match. Delegate = %@", self.delegate);
|
|
return mapping;
|
|
}
|
|
}
|
|
|
|
if (self.objectMappingForDataBlock) {
|
|
mapping = self.objectMappingForDataBlock(data);
|
|
if (mapping) {
|
|
RKLogTrace(@"Found dynamic delegateBlock match. objectMappingForDataBlock = %@", self.objectMappingForDataBlock);
|
|
}
|
|
}
|
|
|
|
return mapping;
|
|
}
|
|
|
|
@end
|
|
|
|
// Compatibility alias...
|
|
@implementation RKObjectDynamicMapping
|
|
@end
|