RKObjectManager* manager = [RKObjectManager managerWithBaseURL:myBaseURL];
RKObjectMapping* articleMapping = [RKObjectMapping mappingForClass:[Article class]];
[mapping mapAttributes:@"title", @"body", @"publishedAt", nil];
[manager.mappingProvider setObjectMapping:articleMapping forKeyPath:@"article"];
// Generate an inverse mapping for transforming Article -> NSMutableDictionary. 
[manager.mappingProvider setSerializationMapping:[articleMapping inverseMapping] forClass:[Article class]];`

Tasks

Configuring the Shared Manager Instance

• + sharedManager

  Return the shared instance of the object manager

• + setSharedManager:

  Set the shared instance of the object manager

Object Mapping Dispatch Queue

• + defaultMappingQueue

  Returns the global default Grand Central Dispatch queue used for object mapping operations executed by RKObjectLoaders.

• + setDefaultMappingQueue:

  Sets a new global default Grand Central Dispatch queue for use in object mapping operations executed by RKObjectLoaders.

Initializing an Object Manager

• + managerWithBaseURLString:

  Create and initialize a new object manager. If this is the first instance created it will be set as the shared instance

• – initWithBaseURL:

  Initializes a newly created object manager with a specified baseURL.

Network Integration

•   client

  The underlying HTTP client for this manager

  property
•   baseURL

  The base URL of the underlying RKClient instance. Object loader and paginator instances built through the object manager are relative to this URL.

  property
•   requestCache

  The request cache used to store and load responses for requests sent through this object manager’s underlying client object

  property
•   requestQueue

  The request queue used to dispatch asynchronous requests sent through this object manager’s underlying client object

  property
•   networkStatus

  Returns the current network status for this object manager as determined by connectivity to the remote backend system

  property
•   isOnline

  Returns YES when we are in online mode

  property
•   isOffline

  Returns YES when we are in offline mode

  property

Configuring Object Mapping

•   mappingProvider

  The Mapping Provider responsible for returning mappings for various keyPaths.

  property
•   router

  Router object responsible for generating resource paths for HTTP requests

  property
•   objectStore

  A Core Data backed object store for persisting objects that have been fetched from the Web

  property
•   mappingQueue

  The Grand Dispatch Queue to use when performing expensive object mapping operations within RKObjectLoader instances created through this object manager

  property
•   serializationMIMEType

  The Default MIME Type to be used in object serialization.

  property
•   acceptMIMEType

  The value for the HTTP Accept header to specify the preferred format for retrieved data

  property

Building Object Loaders

• – objectLoaderClass

  Returns the class of object loader instances built through the manager. When Core Data has been configured, instances of RKManagedObjectLoader will be emitted by the manager. Otherwise RKObjectLoader is used.

• – loaderWithResourcePath:

  Creates and returns an RKObjectLoader or RKManagedObjectLoader instance targeting the specified resourcePath.

• – loaderWithURL:

  Creates and returns an RKObjectLoader or RKManagedObjectLoader instance targeting the specified URL.

• – loaderForObject:method:

  Creates and returns an RKObjectLoader or RKManagedObjectLoader instance for an object instance.

• – paginatorWithResourcePathPattern:

  Creates and returns an RKObjectPaginator instance targeting the specified resource path pattern.

• – loadObjectsAtResourcePath:delegate:

  Create and send an asynchronous GET request to load the objects at the resource path and call back the delegate with the loaded objects. Remote objects will be mapped to local objects by consulting the keyPath registrations set on the mapping provider.

Mappable Object Loaders

• – getObject:delegate:

  Fetch the data for a mappable object by performing an HTTP GET.

• – postObject:delegate:

  Create a remote mappable model by POSTing the attributes to the remote resource and loading the resulting objects from the payload

• – putObject:delegate:

  Update a remote mappable model by PUTing the attributes to the remote resource and loading the resulting objects from the payload

• – deleteObject:delegate:

  Delete the remote instance of a mappable model by performing an HTTP DELETE on the remote resource

• – loadObjectsAtResourcePath:usingBlock:

  Load the objects at the specified resource path and perform object mapping on the response payload. Prior to sending the object loader, the block will be invoked to allow you to configure the object loader as you see fit. This can be used to change the response type, set custom parameters, choose an object mapping, etc.

• – getObject:usingBlock:

  GET a remote object instance and yield the object loader to the block before sending

• – postObject:usingBlock:

  POST a remote object instance and yield the object loader to the block before sending

• – putObject:usingBlock:

  PUT a remote object instance and yield the object loader to the block before sending

• – deleteObject:usingBlock:

  DELETE a remote object instance and yield the object loader to the block before sending

Other Methods

• – configureObjectLoader:

  Configure an object loader before it is utilized

RKTableController Methods

• – tableControllerForTableViewController:

  Creates and returns a table controller object capable of loading remote object representations into a UITableView using the RestKit object mapping engine for a given table view controller.

• – tableControllerWithTableView:forViewController:

  Creates and returns a table controller object capable of loading remote object representations into a UITableView using the RestKit object mapping engine for a given table view and view controller.

• – fetchedResultsTableControllerForTableViewController:

  Creates and returns a fetched results table controller object capable of loading remote object representations stored in Core Data into a UITableView using the RestKit object mapping engine for a given table view controller.

• – fetchedResultsTableControllerWithTableView:forViewController:

  Creates and returns a table controller object capable of loading remote object representations stored in Core Data into a UITableView using the RestKit object mapping engine for a given table view and view controller.

- (void)loadObjectUsingBlockExample {
    [[RKObjectManager sharedManager] loadObjectsAtResourcePath:@"/monkeys.json" usingBlock:^(RKObjectLoader* loader) {
        loader.objectMapping = [[RKObjectManager sharedManager].mappingProvider objectMappingForClass:[Monkey class]];
    }];
}