Files
RestKit/Code/UI/RKTableViewCellMappings.m
Blake Watters 3d0f0ab39e Introduced the RKTableController component for iOS.
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.
2012-02-10 16:30:54 -05:00

79 lines
2.4 KiB
Objective-C

//
// RKTableViewCellMappings.m
// RestKit
//
// Created by Blake Watters on 8/9/11.
// Copyright (c) 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 "RKTableViewCellMappings.h"
@implementation RKTableViewCellMappings
+ (id)cellMappings {
return [[self new] autorelease];
}
- (id)init {
self = [super init];
if (self) {
_cellMappings = [NSMutableDictionary new];
}
return self;
}
- (void)setCellMapping:(RKTableViewCellMapping*)cellMapping forClass:(Class)objectClass {
if ([_cellMappings objectForKey:objectClass]) {
@throw [NSException exceptionWithName:NSInvalidArgumentException
reason:[NSString stringWithFormat:@"A tableViewCell mapping has already been registered for objects of type '%@'", NSStringFromClass(objectClass)]
userInfo:nil];
}
[_cellMappings setObject:cellMapping forKey:objectClass];
if (!cellMapping.reuseIdentifier) {
cellMapping.reuseIdentifier = NSStringFromClass(objectClass);
}
}
- (RKTableViewCellMapping*)cellMappingForClass:(Class)objectClass {
// Exact match
RKTableViewCellMapping* cellMapping = [_cellMappings objectForKey:objectClass];
if (cellMapping) return cellMapping;
// Subclass match
for (Class cellClass in _cellMappings) {
if ([objectClass isSubclassOfClass:cellClass]) {
return [_cellMappings objectForKey:cellClass];
}
}
return nil;
}
- (RKTableViewCellMapping*)cellMappingForObject:(id)object {
if ([object respondsToSelector:@selector(cellMapping)]) {
// TODO: Trace logging...
// TODO: This needs unit test coverage on the did select row case...
RKTableViewCellMapping* cellMapping = [object cellMapping];
if (cellMapping) return [object cellMapping];
}
return [self cellMappingForClass:[object class]];
}
@end