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

Creating Persistent Stores

NSPersistentStore

The abstract base class for all Core Data persistent stores.

NSPersistentStoreDescription

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

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.

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.

NSIncrementalStoreNode

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

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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software