Class

NSIncrementalStore

An abstract superclass defining the API through which Core Data communicates with a store.

Declaration

@interface NSIncrementalStore : NSPersistentStore

Overview

You use this interface to create persistent stores that load and save data incrementally, allowing for the management of large and/or shared datasets.

Subclassing Notes

Methods to Override

In a subclass of NSIncrementalStore, you must override the following methods to provide behavior appropriate for your store:

You can also optionally override the following methods:

There is no need to override the methods that you must otherwise override for a subclass of NSPersistentStore.

Methods that Should Not Be Overridden

In a subclass of NSIncrementalStore, you should not override the following methods:

Topics

Manipulating Managed Objects

- executeRequest:withContext:error:

Returns a value as appropriate for the given request, or nil if the request cannot be completed.

- newValuesForObjectWithID:withContext:error:

Returns an incremental store node encapsulating the persistent external values of the object with a given object ID.

- newValueForRelationship:forObjectWithID:withContext:error:

Returns the relationship for the given relationship of the object with a given object ID.

- obtainPermanentIDsForObjects:error:

Returns an array containing the object IDs for a given array of newly-inserted objects.

- newObjectIDForEntity:referenceObject:

Returns a new object ID that uses given data as the key.

- referenceObjectForObjectID:

Returns the reference data used to construct a given object ID.

Responding to Context Changes

- managedObjectContextDidRegisterObjectsWithIDs:

Indicates that objects identified by a given array of object IDs are in use in a managed object context.

- managedObjectContextDidUnregisterObjectsWithIDs:

Indicates that objects identified by a given array of object IDs are no longer being used by a managed object context.

Accessing Metadata

+ identifierForNewStoreAtURL:

Returns the identifier for the store at a given URL.

- loadMetadata:

Loads the metadata for the store.

Relationships

Inherits From

See Also

Store Coordination

NSPersistentStoreCoordinator

A coordinator that uses the model to help contexts and persistent stores communicate.

NSPersistentStore

The abstract base class for all Core Data persistent stores.

NSPersistentStoreDescription

A description object used to create and load a persistent store.

NSPersistentStoreRequest

Criteria used to retrieve data from or save data to a persistent store.

NSPersistentStoreResult

The abstract base class for results returned from a persistent store coordinator.

NSPersistentStoreAsynchronousResult

A concrete class used to represent the results of an asynchronous request.

NSSaveChangesRequest

An encapsulation of a collection of changes to be made by an object store in response to a save operation on a managed object context.

NSAtomicStore

An abstract superclass that you subclass to create a Core Data atomic store.

NSAtomicStoreCacheNode

A concrete class that you use to represent basic nodes in a Core Data atomic store.

NSIncrementalStoreNode

A concrete class used to represent basic nodes in a Core Data incremental store.