# EOSharedEditingContext class documentation

Generated at 2026-02-03 22:13:20 +0000
Software documentation for the EOSharedEditingContext class
EOControl/EOSharedEditingContext.h

Immutable Enterprise Objects can be shared among EOEditingContexts via EOSharedEditingContext. Normally EOs belong to a specific EOEditingContext and this editing context tracks the changes of this object. Yet sometimes immutable objects are often referenced by many objects and they would have to fetched and tracked within many EOEditingContexts. EOSharedEditingContext is intended to address this by supplying an shared context for immutable objects which can be shared among instances of EOEditingContext. An EO that is registered with an EOSharedEditingContext may not be contained in an other EOEditingContext which uses the EOSharedEditingContext.

The only valid way to modify an object that is contained in a shared context is by changing it in an unreladed EOEditingContext (i.e. one which does not use the EOSharedEditingContext), commit those changes to the object store which would post a EOObjectsChangedInStoreNotification which in turn will cause the EOSharedEditingContext to invalidate an subsequently refetch the values of the EO from its object store.

Objects are fetched with [-objectsWithFetchSpecification:] or [-bindObjectsWithFetchSpecification:toName:] into an EOSharedEditingContext. If the later method is used, the objects can be later retrieved via -objectsByEntityNameAndFetchSpecificationName.

Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
defaultSharedEditingContext
Returns the current default shared editing context. This method will create one if none currently exists. The first time this method implicitly creates a shared editing context it will post a `EODefaultSharedEditingContextWasInitializedNotification` .
setDefaultSharedEditingContext:
context
Explicity sets the default shared editing context. If CONTEXT is not an EOSharedEditingContext this method raises an NSInternalInconsistency exception.
bindObjectsWithFetchSpecification:
fetchSpec
toName:
name
Invokes [-objectsWithFetchSpecification:] and registers the objects to be retrieved with [-objectsByEntityName] and -objectsByEntityNameAndFetchSpecificationName;
deleteObject:
object
Raises an NSInternalInconsistencyException since a shared editing context may not delete objects.
deletedObjects
Returns an empty array since a shared editing context may not delete objects.
faultForGlobalID:
globalID
editingContext:
context
Returns the fault of the superclass implementation but insures that the returned object is valid in autoreleased in the current autorelease pool of the calling thread.
hasChanges
Always returns `NO` since a shared editing context may not have changes.
insertObject:
object
Raises an NSInternalInconsistencyException since a shared editing context may not delete objects.
insertedObjects
Returns an empty array since a shared editing context may not insert objects.
lockForReading
Increases the recievers lock count for reading.
objectForGlobalID:
globalID
Returns the object of the superclass implementation but insures that the returned object is valid in autoreleased in the current autorelease pool of the calling thread.
objectWillChange:
object
Raises an NSInternalInconsistencyException since objects in a shared editing context may not be modified.
objectsByEntityName
Returns all object currently maintained the the EOSharedEditingContext in an NSDictionary associated with the corresponding entity name.
objectsByEntityNameAndFetchSpecificationName
Returns all object currently maintained the the EOSharedEditingContext in an NSDictionary associated with the corresponding name supplied by previous [-bindObjectsWithFetchSpecification:toName:] each containing a dictionary in which the objects are assicated with the entity name.
objectsWithFetchSpecification:
fetchSpec
editingContext:
context
Fetches the objects with the FETCHSPEC and registers them for retrieval with -objectsByEntityName .
refaultObject:
object
withGlobalID:
globalID
editingContext:
context
This method is invoked if the objects have been modified in an unrelated EOEditingContext and therefor needs to be invalidated and refetched here.
registeredObjects
Returns the registered objects of the superclass implementation but insures that that the returned objects are valid in autoreleased in the current autorelease pool of the calling thread.
reset
Overriden to do nothing.
retrieveReaderLocks
Retrieve suspended reader lock count.
saveChanges
Raises an NSInternalInconsistencyException since objects in a shared editing context may not be modified.
setSharedEditingContext:
sharedContext
Raises an NSInternalInconsistencyException unless SHAREDCONTEXT is `nil`.
setUndoManager:
undoManager
Raises an NSInternalInconsistencyException unless SHAREDCONTEXT is `nil`.
sharedEditingContext
EOSharedEditingContexts cannot have shared editing contexts. This methos allways returns `nil`.
suspendReaderLocks
Suspends the reader lock count until retrieveReaderLocks is called.
tryLockForReading
Attempts to increases the recievers lock count for reading. Returns `NO` if the lock cannot be retrieved.
unlockForReading
Decreases the recievers lock count for reading.
updatedObjects
Returns an empty array since a shared editing context may not insert objects.
validateChangesForSave
Overriden to do nothing.
EOSharedEditingContext variables

Description forthcoming.
Description forthcoming.