mirror of
https://github.com/zhigang1992/RestKit.git
synced 2026-04-01 22:42:51 +08:00
365 lines
12 KiB
Objective-C
365 lines
12 KiB
Objective-C
//
|
|
// RKObjectManager.m
|
|
// RestKit
|
|
//
|
|
// Created by Jeremy Ellison on 8/14/09.
|
|
// Copyright 2009 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 "RKObjectManager.h"
|
|
#import "RKObjectSerializer.h"
|
|
#import "RKManagedObjectStore.h"
|
|
#import "RKManagedObjectLoader.h"
|
|
#import "Support.h"
|
|
#import "RKErrorMessage.h"
|
|
|
|
NSString * const RKDidEnterOfflineModeNotification = @"RKDidEnterOfflineModeNotification";
|
|
NSString * const RKDidEnterOnlineModeNotification = @"RKDidEnterOnlineModeNotification";
|
|
|
|
//////////////////////////////////
|
|
// Shared Instance
|
|
|
|
static RKObjectManager *sharedManager = nil;
|
|
|
|
///////////////////////////////////
|
|
|
|
@implementation RKObjectManager
|
|
|
|
@synthesize client = _client;
|
|
@synthesize objectStore = _objectStore;
|
|
@synthesize router = _router;
|
|
@synthesize mappingProvider = _mappingProvider;
|
|
@synthesize serializationMIMEType = _serializationMIMEType;
|
|
|
|
- (id)initWithBaseURL:(RKURL *)baseURL {
|
|
self = [super init];
|
|
if (self) {
|
|
_mappingProvider = [RKObjectMappingProvider new];
|
|
_router = [RKObjectRouter new];
|
|
_client = [[RKClient alloc] initWithBaseURL:baseURL];
|
|
_onlineState = RKObjectManagerOnlineStateUndetermined;
|
|
|
|
self.acceptMIMEType = RKMIMETypeJSON;
|
|
self.serializationMIMEType = RKMIMETypeFormURLEncoded;
|
|
|
|
// Setup default error message mappings
|
|
RKObjectMapping *errorMapping = [RKObjectMapping mappingForClass:[RKErrorMessage class]];
|
|
errorMapping.rootKeyPath = @"errors";
|
|
[errorMapping mapKeyPath:@"" toAttribute:@"errorMessage"];
|
|
_mappingProvider.errorMapping = errorMapping;
|
|
|
|
[[NSNotificationCenter defaultCenter] addObserver:self
|
|
selector:@selector(reachabilityChanged:)
|
|
name:RKReachabilityDidChangeNotification
|
|
object:_client.reachabilityObserver];
|
|
|
|
// Set shared manager if nil
|
|
if (nil == sharedManager) {
|
|
[RKObjectManager setSharedManager:self];
|
|
}
|
|
}
|
|
|
|
return self;
|
|
}
|
|
|
|
+ (RKObjectManager *)sharedManager {
|
|
return sharedManager;
|
|
}
|
|
|
|
+ (void)setSharedManager:(RKObjectManager *)manager {
|
|
[manager retain];
|
|
[sharedManager release];
|
|
sharedManager = manager;
|
|
}
|
|
|
|
+ (RKObjectManager *)managerWithBaseURLString:(NSString *)baseURLString {
|
|
return [self managerWithBaseURL:[RKURL URLWithString:baseURLString]];
|
|
}
|
|
|
|
+ (RKObjectManager *)managerWithBaseURL:(NSURL *)baseURL {
|
|
RKObjectManager *manager = [[[self alloc] initWithBaseURL:baseURL] autorelease];
|
|
return manager;
|
|
}
|
|
|
|
- (void)dealloc {
|
|
[[NSNotificationCenter defaultCenter] removeObserver:self];
|
|
|
|
[_router release];
|
|
_router = nil;
|
|
[_client release];
|
|
_client = nil;
|
|
[_objectStore release];
|
|
_objectStore = nil;
|
|
[_serializationMIMEType release];
|
|
_serializationMIMEType = nil;
|
|
[_mappingProvider release];
|
|
_mappingProvider = nil;
|
|
|
|
[super dealloc];
|
|
}
|
|
|
|
- (BOOL)isOnline {
|
|
return (_onlineState == RKObjectManagerOnlineStateConnected);
|
|
}
|
|
|
|
- (BOOL)isOffline {
|
|
return ![self isOnline];
|
|
}
|
|
|
|
- (void)reachabilityChanged:(NSNotification *)notification {
|
|
BOOL isHostReachable = [self.client.reachabilityObserver isNetworkReachable];
|
|
|
|
_onlineState = isHostReachable ? RKObjectManagerOnlineStateConnected : RKObjectManagerOnlineStateDisconnected;
|
|
|
|
if (isHostReachable) {
|
|
[[NSNotificationCenter defaultCenter] postNotificationName:RKDidEnterOnlineModeNotification object:self];
|
|
} else {
|
|
[[NSNotificationCenter defaultCenter] postNotificationName:RKDidEnterOfflineModeNotification object:self];
|
|
}
|
|
}
|
|
|
|
- (void)setAcceptMIMEType:(NSString *)MIMEType {
|
|
[_client setValue:MIMEType forHTTPHeaderField:@"Accept"];
|
|
}
|
|
|
|
- (NSString *)acceptMIMEType {
|
|
return [self.client.HTTPHeaders valueForKey:@"Accept"];
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////
|
|
#pragma mark - Object Collection Loaders
|
|
|
|
- (Class)objectLoaderClass {
|
|
Class managedObjectLoaderClass = NSClassFromString(@"RKManagedObjectLoader");
|
|
if (self.objectStore && managedObjectLoaderClass) {
|
|
return managedObjectLoaderClass;
|
|
}
|
|
|
|
return [RKObjectLoader class];
|
|
}
|
|
|
|
- (id)loaderWithResourcePath:(NSString *)resourcePath {
|
|
RKURL *URL = [self.baseURL URLByAppendingResourcePath:resourcePath];
|
|
return [self loaderWithURL:URL];
|
|
}
|
|
|
|
- (id)loaderWithURL:(RKURL *)URL {
|
|
RKObjectLoader *loader = [[self objectLoaderClass] loaderWithURL:URL mappingProvider:self.mappingProvider];
|
|
loader.configurationDelegate = self;
|
|
if ([loader isKindOfClass:[RKManagedObjectLoader class]]) {
|
|
[(RKManagedObjectLoader *)loader setObjectStore:self.objectStore];
|
|
}
|
|
[self configureObjectLoader:loader];
|
|
|
|
return loader;
|
|
}
|
|
|
|
- (NSURL *)baseURL {
|
|
return self.client.baseURL;
|
|
}
|
|
|
|
- (RKObjectPaginator *)paginatorWithResourcePathPattern:(NSString *)resourcePathPattern {
|
|
RKURL *patternURL = [[self baseURL] URLByAppendingResourcePath:resourcePathPattern];
|
|
RKObjectPaginator *paginator = [RKObjectPaginator paginatorWithPatternURL:patternURL
|
|
mappingProvider:self.mappingProvider];
|
|
paginator.configurationDelegate = self;
|
|
return paginator;
|
|
}
|
|
|
|
- (id)loaderForObject:(id<NSObject>)object method:(RKRequestMethod)method {
|
|
NSString* resourcePath = (method == RKRequestMethodInvalid) ? nil : [self.router resourcePathForObject:object method:method];
|
|
RKObjectLoader *loader = [self loaderWithResourcePath:resourcePath];
|
|
loader.method = method;
|
|
loader.sourceObject = object;
|
|
loader.serializationMIMEType = self.serializationMIMEType;
|
|
loader.serializationMapping = [self.mappingProvider serializationMappingForClass:[object class]];
|
|
|
|
RKObjectMapping *objectMapping = [self.mappingProvider objectMappingForResourcePath:resourcePath];
|
|
if (objectMapping == nil || [object isMemberOfClass:[objectMapping objectClass]]) {
|
|
loader.targetObject = object;
|
|
} else {
|
|
loader.targetObject = nil;
|
|
}
|
|
|
|
return loader;
|
|
}
|
|
|
|
- (void)loadObjectsAtResourcePath:(NSString *)resourcePath delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderWithResourcePath:resourcePath];
|
|
loader.delegate = delegate;
|
|
loader.method = RKRequestMethodGET;
|
|
|
|
[loader send];
|
|
}
|
|
|
|
/////////////////////////////////////////////////////////////
|
|
#pragma mark - Object Instance Loaders
|
|
|
|
- (void)getObject:(id<NSObject>)object delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodGET];
|
|
loader.delegate = delegate;
|
|
[loader send];
|
|
}
|
|
|
|
- (void)postObject:(id<NSObject>)object delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodPOST];
|
|
loader.delegate = delegate;
|
|
[loader send];
|
|
}
|
|
|
|
- (void)putObject:(id<NSObject>)object delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodPUT];
|
|
loader.delegate = delegate;
|
|
[loader send];
|
|
}
|
|
|
|
- (void)deleteObject:(id<NSObject>)object delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodDELETE];
|
|
loader.delegate = delegate;
|
|
[loader send];
|
|
}
|
|
|
|
#if NS_BLOCKS_AVAILABLE
|
|
|
|
#pragma mark - Block Configured Object Loaders
|
|
|
|
- (void)loadObjectsAtResourcePath:(NSString*)resourcePath usingBlock:(void(^)(RKObjectLoader *))block {
|
|
RKObjectLoader* loader = [self loaderWithResourcePath:resourcePath];
|
|
loader.method = RKRequestMethodGET;
|
|
|
|
// Yield to the block for setup
|
|
block(loader);
|
|
|
|
[loader send];
|
|
}
|
|
|
|
- (void)sendObject:(id<NSObject>)object toResourcePath:(NSString *)resourcePath usingBlock:(void(^)(RKObjectLoader*))block {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodInvalid];
|
|
loader.URL = [self.baseURL URLByAppendingResourcePath:resourcePath];
|
|
|
|
// Yield to the block for setup
|
|
block(loader);
|
|
|
|
[loader send];
|
|
}
|
|
|
|
- (void)sendObject:(id<NSObject>)object method:(RKRequestMethod)method usingBlock:(void(^)(RKObjectLoader*))block {
|
|
NSString *resourcePath = [self.router resourcePathForObject:object method:method];
|
|
[self sendObject:object toResourcePath:resourcePath usingBlock:^(RKObjectLoader *loader) {
|
|
loader.method = method;
|
|
block(loader);
|
|
}];
|
|
}
|
|
|
|
- (void)getObject:(id<NSObject>)object usingBlock:(void(^)(RKObjectLoader *))block {
|
|
[self sendObject:object method:RKRequestMethodGET usingBlock:block];
|
|
}
|
|
|
|
- (void)postObject:(id<NSObject>)object usingBlock:(void(^)(RKObjectLoader *))block {
|
|
[self sendObject:object method:RKRequestMethodPOST usingBlock:block];
|
|
}
|
|
|
|
- (void)putObject:(id<NSObject>)object usingBlock:(void(^)(RKObjectLoader *))block {
|
|
[self sendObject:object method:RKRequestMethodPUT usingBlock:block];
|
|
}
|
|
|
|
- (void)deleteObject:(id<NSObject>)object usingBlock:(void(^)(RKObjectLoader *))block {
|
|
[self sendObject:object method:RKRequestMethodDELETE usingBlock:block];
|
|
}
|
|
|
|
#endif // NS_BLOCKS_AVAILABLE
|
|
|
|
#pragma mark - Object Instance Loaders for Non-nested JSON
|
|
|
|
- (void)getObject:(id<NSObject>)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
[self sendObject:object method:RKRequestMethodGET usingBlock:^(RKObjectLoader *loader) {
|
|
loader.delegate = delegate;
|
|
loader.objectMapping = objectMapping;
|
|
}];
|
|
}
|
|
|
|
- (void)postObject:(id<NSObject>)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
[self sendObject:object method:RKRequestMethodPOST usingBlock:^(RKObjectLoader *loader) {
|
|
loader.delegate = delegate;
|
|
loader.objectMapping = objectMapping;
|
|
}];
|
|
}
|
|
|
|
- (void)putObject:(id<NSObject>)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
[self sendObject:object method:RKRequestMethodPUT usingBlock:^(RKObjectLoader *loader) {
|
|
loader.delegate = delegate;
|
|
loader.objectMapping = objectMapping;
|
|
}];
|
|
}
|
|
|
|
- (void)deleteObject:(id<NSObject>)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
[self sendObject:object method:RKRequestMethodDELETE usingBlock:^(RKObjectLoader *loader) {
|
|
loader.delegate = delegate;
|
|
loader.objectMapping = objectMapping;
|
|
}];
|
|
}
|
|
|
|
- (RKRequestCache *)requestCache {
|
|
return self.client.requestCache;
|
|
}
|
|
|
|
- (RKRequestQueue *)requestQueue {
|
|
return self.client.requestQueue;
|
|
}
|
|
|
|
#pragma mark - RKConfigrationDelegate
|
|
|
|
- (void)configureRequest:(RKRequest *)request {
|
|
[self.client configureRequest:request];
|
|
}
|
|
|
|
- (void)configureObjectLoader:(RKObjectLoader *)objectLoader {
|
|
[self configureRequest:objectLoader];
|
|
}
|
|
|
|
#pragma mark - Deprecations
|
|
|
|
+ (RKObjectManager *)objectManagerWithBaseURLString:(NSString *)baseURLString {
|
|
return [self managerWithBaseURLString:baseURLString];
|
|
}
|
|
|
|
+ (RKObjectManager *)objectManagerWithBaseURL:(NSURL *)baseURL {
|
|
return [self managerWithBaseURL:baseURL];
|
|
}
|
|
|
|
- (RKObjectLoader *)objectLoaderWithResourcePath:(NSString *)resourcePath delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader* loader = [self loaderWithResourcePath:resourcePath];
|
|
loader.delegate = delegate;
|
|
|
|
return loader;
|
|
}
|
|
|
|
- (RKObjectLoader*)objectLoaderForObject:(id<NSObject>)object method:(RKRequestMethod)method delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderForObject:object method:method];
|
|
loader.delegate = delegate;
|
|
return loader;
|
|
}
|
|
|
|
- (void)loadObjectsAtResourcePath:(NSString *)resourcePath objectMapping:(RKObjectMapping *)objectMapping delegate:(id<RKObjectLoaderDelegate>)delegate {
|
|
RKObjectLoader *loader = [self loaderWithResourcePath:resourcePath];
|
|
loader.delegate = delegate;
|
|
loader.method = RKRequestMethodGET;
|
|
loader.objectMapping = objectMapping;
|
|
|
|
[loader send];
|
|
}
|
|
|
|
@end
|