// // 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)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)delegate { RKObjectLoader *loader = [self loaderWithResourcePath:resourcePath]; loader.delegate = delegate; loader.method = RKRequestMethodGET; [loader send]; } ///////////////////////////////////////////////////////////// #pragma mark - Object Instance Loaders - (void)getObject:(id)object delegate:(id)delegate { RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodGET]; loader.delegate = delegate; [loader send]; } - (void)postObject:(id)object delegate:(id)delegate { RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodPOST]; loader.delegate = delegate; [loader send]; } - (void)putObject:(id)object delegate:(id)delegate { RKObjectLoader *loader = [self loaderForObject:object method:RKRequestMethodPUT]; loader.delegate = delegate; [loader send]; } - (void)deleteObject:(id)object delegate:(id)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)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)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)object usingBlock:(void(^)(RKObjectLoader *))block { [self sendObject:object method:RKRequestMethodGET usingBlock:block]; } - (void)postObject:(id)object usingBlock:(void(^)(RKObjectLoader *))block { [self sendObject:object method:RKRequestMethodPOST usingBlock:block]; } - (void)putObject:(id)object usingBlock:(void(^)(RKObjectLoader *))block { [self sendObject:object method:RKRequestMethodPUT usingBlock:block]; } - (void)deleteObject:(id)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)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id)delegate { [self sendObject:object method:RKRequestMethodGET usingBlock:^(RKObjectLoader *loader) { loader.delegate = delegate; loader.objectMapping = objectMapping; }]; } - (void)postObject:(id)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id)delegate { [self sendObject:object method:RKRequestMethodPOST usingBlock:^(RKObjectLoader *loader) { loader.delegate = delegate; loader.objectMapping = objectMapping; }]; } - (void)putObject:(id)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id)delegate { [self sendObject:object method:RKRequestMethodPUT usingBlock:^(RKObjectLoader *loader) { loader.delegate = delegate; loader.objectMapping = objectMapping; }]; } - (void)deleteObject:(id)object mapResponseWith:(RKObjectMapping *)objectMapping delegate:(id)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)delegate { RKObjectLoader* loader = [self loaderWithResourcePath:resourcePath]; loader.delegate = delegate; return loader; } - (RKObjectLoader*)objectLoaderForObject:(id)object method:(RKRequestMethod)method delegate:(id)delegate { RKObjectLoader *loader = [self loaderForObject:object method:method]; loader.delegate = delegate; return loader; } - (void)loadObjectsAtResourcePath:(NSString *)resourcePath objectMapping:(RKObjectMapping *)objectMapping delegate:(id)delegate { RKObjectLoader *loader = [self loaderWithResourcePath:resourcePath]; loader.delegate = delegate; loader.method = RKRequestMethodGET; loader.objectMapping = objectMapping; [loader send]; } @end