Discussion

The main queue context is available for usage on the main queue to drive user interface needs. The context is created with the NSMainQueueConcurrencyType and as such may be messaged directly from the main thread. The context is a child context of the persistentStoreManagedObjectContext and can persist changes up to the parent via a save.

Discussion

The managed object cache is used to accelerate intensive Core Data operations by caching managed objects by one or more attributes.

Default: An instance of RKFetchRequestManagedObjectCache.

Discussion

The persistent store context is created with the NSPrivateQueueConcurrencyType and as such must be interacted with using [NSManagedObjectContext performBlock:] or [NSManagedObjectContext performBlockAndWait:]. This context typically serves as the parent context for scratch contexts or main queue contexts for interacting with the user interface. Created by the invocation of createManagedObjectContexts.

Discussion

A search indexer is instantiated when search indexing is added to an entity in the receiver’s managed object model.

Discussion

This method provides support for migrating persistent stores in which the source and destination models have been mutated after being loaded from the model archive on disk, such as when the RestKit managed object searching support is used. In a situation where the persistent store has been created with a dynamically modified managed object model. Core Data is unable to infer the mapping model because the metadata of the persistent store does not agree with that of the managed object model due to the dynamic modifications. In order to perform a migration, one must load the appropriate source model, apply the dynamic changes appropriate for that model, then infer a mapping model from the modified model. This method assists in this process by accepting a source store and a destination model as arguments and searching through all models in the .momd package and yielding each model to the given configuration block for processing. After the block is invoked, the metadata of the store is checked for compatibility with the modified managed object model to identify the source store. Once the source store is found, a mapping model is inferred and the migration proceeds. The migration is done against a copy of the given persistent store and if successful, the migrated store is moved to replace the original store.

To understand how this is used, consider the following example: Given a managed object model containing two entities ‘Article’ and ‘Tag’, the user wishes to configure managed object search indexing on the models and wishes to be able to migrate existing persistent stores across versions. The migration configuration would look something like this:

 NSURL *storeURL = [RKApplicationDataDirectory() stringByAppendingPathComponent:@"MyStore.sqlite"];
 NSURL *modelURL = [[RKTestFixture fixtureBundle] URLForResource:@"VersionedModel" withExtension:@"momd"];
 BOOL success = [RKManagedObjectStore migratePersistentStoreOfType:NSSQLiteStoreType atURL:storeURL toModelAtURL:modelURL error:&error configuringModelsWithBlock:^(NSManagedObjectModel *model, NSURL *sourceURL) {
    // Examine each model and configure search indexing appropriately based on the versionIdentifiers configured in the model
    if ([[model versionIdentifiers] isEqualToSet:[NSSet setWithObject:@"1.0"]]) {
        NSEntityDescription *articleEntity = [[model entitiesByName] objectForKey:@"Article"];
        NSEntityDescription *tagEntity = [[model entitiesByName] objectForKey:@"Tag"];
        [RKSearchIndexer addSearchIndexingToEntity:articleEntity onAttributes:@[ @"title" ]];
        [RKSearchIndexer addSearchIndexingToEntity:tagEntity onAttributes:@[ @"name" ]];
    } else if ([[model versionIdentifiers] isEqualToSet:[NSSet setWithObject:@"2.0"]]) {
        NSEntityDescription *articleEntity = [[model entitiesByName] objectForKey:@"Article"];
        NSEntityDescription *tagEntity = [[model entitiesByName] objectForKey:@"Tag"];
        [RKSearchIndexer addSearchIndexingToEntity:articleEntity onAttributes:@[ @"title", @"body" ]];
        [RKSearchIndexer addSearchIndexingToEntity:tagEntity onAttributes:@[ @"name" ]];
    } else if ([[model versionIdentifiers] containsObject:@"3.0"] || [[model versionIdentifiers] containsObject:@"4.0"]) {
        // We index the same attributes on v3 and v4
        NSEntityDescription *articleEntity = [[model entitiesByName] objectForKey:@"Article"];
        NSEntityDescription *tagEntity = [[model entitiesByName] objectForKey:@"Tag"];
        [RKSearchIndexer addSearchIndexingToEntity:articleEntity onAttributes:@[ @"title", @"body", @"authorName" ]];
        [RKSearchIndexer addSearchIndexingToEntity:tagEntity onAttributes:@[ @"name" ]];
    }
 }];

Discussion

This method will invoke createPersistentStore if a persistent store coordinator has not yet been created.

Discussion

Discussion

Invocation of this method will result in the entity for the given name being updated to include a new to-many relationship with the name searchWords. The receiver’s search indexer will also be instructed to begin monitoring changes to the specified entity’s searchable attributes to maintain the collection of search words. If no search indexer exists, a new

Discussion

Discussion

Discussion

NSURL *modelURL = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"MyApplication" ofType:@"momd"]];
// NOTE: Due to an iOS 5 bug, the managed object model returned is immutable.
NSManagedObjectModel *managedObjectModel = [[[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL] mutableCopy];
RKManagedObjectStore *managedObjectStore = [[RKManagedObjectStore alloc] initWithManagedObjectModel:managedObjectModel];

Discussion

The managed object model from the persistent store coordinator will be used to initialize the receiver and the given persistent store coordinator will be configured as the persistent store coordinator for the managed object store.

This initialization method provides for easy integration with an existing Core Data stack.

Discussion

NSBlockOpertation *operation = [NSBlockOperation blockOperationWithBlock:^{
    NSManagedObjectContext *managedObjectContext = [RKManagedObjectStore defaultStore].persistentStoreManagedObjectContext;
    [managedObjectContext performBlockAndWait:^{
        NSError *error = nil;
        for (NSEntityDescription *entity in [RKManagedObjectStore defaultStore].managedObjectModel) {
            NSFetchRequest *fetchRequest = [NSFetchRequest new];
            [fetchRequest setEntity:entity];
            [fetchRequest setIncludesSubentities:NO];
            NSArray *objects = [managedObjectContext executeFetchRequest:fetchRequest error:&error];
            if (! objects) RKLogWarning(@"Failed execution of fetch request %@: %@", fetchRequest, error);
            for (NSManagedObject *managedObject in objects) {
                [managedObjectContext deleteObject:managedObjectContext];
            }
        }
        BOOL success = [managedObjectContext save:&error];
        if (!success) RKLogWarning(@"Failed saving managed object context: %@", error);
        }];
}];
[operation setCompletionBlock:^{
    // Do stuff once the truncation is complete
}];
[operation start];

Discussion

This is a convenience method that is equivalent to the following example code:

RKSearchIndexer *searchIndexer = managedObjectStore.searchIndexer;
[searchIndexer startObservingManagedObjectContext:managedObjectStore.persistentStoreManagedObjectContext];

Discussion

This is a convenience method that is equivalent to the following example code:

RKSearchIndexer *searchIndexer = managedObjectStore.searchIndexer;
[searchIndexer stopObservingManagedObjectContext:managedObjectStore.persistentStoreManagedObjectContext];