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.
119 lines
4.0 KiB
Objective-C
119 lines
4.0 KiB
Objective-C
//
|
|
// RKDynamicObjectMapping.h
|
|
// RestKit
|
|
//
|
|
// Created by Blake Watters on 7/28/11.
|
|
// Copyright 2011 RestKit
|
|
//
|
|
// 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 "RKObjectMappingDefinition.h"
|
|
#import "RKObjectMapping.h"
|
|
|
|
/**
|
|
Return the appropriate object mapping given a mappable data
|
|
*/
|
|
@protocol RKDynamicObjectMappingDelegate <NSObject>
|
|
|
|
@required
|
|
- (RKObjectMapping*)objectMappingForData:(id)data;
|
|
|
|
@end
|
|
|
|
#ifdef NS_BLOCKS_AVAILABLE
|
|
typedef RKObjectMapping*(^RKDynamicObjectMappingDelegateBlock)(id);
|
|
#endif
|
|
|
|
/**
|
|
Defines a dynamic object mapping that determines the appropriate concrete
|
|
object mapping to apply at mapping time. This allows you to map very similar payloads
|
|
differently depending on the type of data contained therein.
|
|
*/
|
|
@interface RKDynamicObjectMapping : NSObject <RKObjectMappingDefinition> {
|
|
NSMutableArray *_matchers;
|
|
id<RKDynamicObjectMappingDelegate> _delegate;
|
|
#ifdef NS_BLOCKS_AVAILABLE
|
|
RKDynamicObjectMappingDelegateBlock _objectMappingForDataBlock;
|
|
#endif
|
|
BOOL _forceCollectionMapping;
|
|
}
|
|
|
|
/**
|
|
A delegate to call back to determine the appropriate concrete object mapping
|
|
to apply to the mappable data.
|
|
|
|
@see RKDynamicObjectMappingDelegate
|
|
*/
|
|
@property (nonatomic, assign) id<RKDynamicObjectMappingDelegate> delegate;
|
|
|
|
#ifdef NS_BLOCKS_AVAILABLE
|
|
/**
|
|
A block to invoke to determine the appropriate concrete object mapping
|
|
to apply to the mappable data.
|
|
*/
|
|
@property (nonatomic, copy) RKDynamicObjectMappingDelegateBlock objectMappingForDataBlock;
|
|
#endif
|
|
|
|
/**
|
|
When YES, an NSDictionary encountered by RKObjectMapper will be treated as a collection
|
|
rather than as a single mappable entity. This is used to perform sub-keypath mapping wherein
|
|
the keys of the dictionary are part of the mappable data.
|
|
*/
|
|
@property (nonatomic, assign) BOOL forceCollectionMapping;
|
|
|
|
/**
|
|
Return a new auto-released dynamic object mapping
|
|
*/
|
|
+ (RKDynamicObjectMapping *)dynamicMapping;
|
|
|
|
#if NS_BLOCKS_AVAILABLE
|
|
|
|
/**
|
|
Return a new auto-released dynamic object mapping after yielding it to the block for configuration
|
|
*/
|
|
+ (RKDynamicObjectMapping *)dynamicMappingUsingBlock:(void(^)(RKDynamicObjectMapping *))block;
|
|
+ (RKDynamicObjectMapping *)dynamicMappingWithBlock:(void(^)(RKDynamicObjectMapping *))block DEPRECATED_ATTRIBUTE;
|
|
|
|
#endif
|
|
|
|
/**
|
|
Defines a dynamic mapping rule stating that when the value of the key property matches the specified
|
|
value, the objectMapping should be used.
|
|
|
|
For example, suppose that we have a JSON fragment for a person that we want to map differently based on
|
|
the gender of the person. When the gender is 'male', we want to use the Boy class and when then the gender
|
|
is 'female' we want to use the Girl class. We might define our dynamic mapping like so:
|
|
|
|
RKDynamicObjectMapping* mapping = [RKDynamicObjectMapping dynamicMapping];
|
|
[mapping setObjectMapping:boyMapping whenValueOfKeyPath:@"gender" isEqualTo:@"male"];
|
|
[mapping setObjectMapping:boyMapping whenValueOfKeyPath:@"gender" isEqualTo:@"female"];
|
|
*/
|
|
- (void)setObjectMapping:(RKObjectMapping *)objectMapping whenValueOfKeyPath:(NSString *)keyPath isEqualTo:(id)value;
|
|
|
|
/**
|
|
Invoked by the RKObjectMapper and RKObjectMappingOperation to determine the appropriate RKObjectMapping to use
|
|
when mapping the specified dictionary of mappable data.
|
|
*/
|
|
- (RKObjectMapping *)objectMappingForDictionary:(NSDictionary *)dictionary;
|
|
|
|
@end
|
|
|
|
/**
|
|
Define an alias for the old class name for compatibility
|
|
|
|
@deprecated
|
|
*/
|
|
@interface RKObjectDynamicMapping : RKDynamicObjectMapping
|
|
@end
|