1  /* Copyright(c)2008 Dan Knapp
  2  
  3  Permission is hereby granted, free of charge, to any person obtaining a copy of
  4  this software and associated documentation files(the "Software"), to deal in the
  5  Software without restriction, including without limitation the rights to use,
  6  copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
  7  Software, and to permit persons to whom the Software is furnished to do so,
  8  subject to the following conditions:
  9  
 10  The above copyright notice and this permission notice shall be included in all
 11  copies or substantial portions of the Software.
 12  
 13  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 14  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 15  FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 16  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 17  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 18  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
 19  #import <CoreData/CoreDataExports.h>
 20  #import <Foundation/NSDate.h>
 21  #import <Foundation/NSLock.h>
 22  #import <Foundation/NSObject.h>
 23  #import <Foundation/NSString.h>
 24  
 25  @class NSSet, NSMutableSet, NSNotification, NSUndoManager, NSMapTable;
 26  @class NSManagedObject, NSManagedObjectID, NSFetchRequest, NSPersistentStore,
 27          NSPersistentStoreCoordinator;
 28  
 29  COREDATA_EXPORT NSString *const NSManagedObjectContextWillSaveNotification;
 30  COREDATA_EXPORT NSString *const NSManagedObjectContextDidSaveNotification;
 31  
 32  COREDATA_EXPORT NSString *const NSInsertedObjectsKey;
 33  COREDATA_EXPORT NSString *const NSUpdatedObjectsKey;
 34  COREDATA_EXPORT NSString *const NSDeletedObjectsKey;
 35  COREDATA_EXPORT NSString *const NSRefreshedObjectsKey;
 36  COREDATA_EXPORT NSString *const NSInvalidatedObjectsKey;
 37  COREDATA_EXPORT NSString *const NSInvalidatedAllObjectsKey;
 38  COREDATA_EXPORT NSString *const NSPersistentStoreSaveConflictsErrorKey;
 39  
 40  @interface NSManagedObjectContext : NSObject <NSLocking> {
 41      NSLock *_lock;
 42      NSPersistentStoreCoordinator *_storeCoordinator;
 43      NSUndoManager *_undoManager;
 44      BOOL _retainsRegisteredObjects;
 45      BOOL _propagatesDeletesAtEndOfEvent;
 46      NSTimeInterval _stalenessInterval;
 47      id _mergePolicy;
 48  
 49      NSMutableSet *_registeredObjects;
 50  
 51      NSMutableSet *_insertedObjects;
 52      NSMutableSet *_updatedObjects;
 53      NSMutableSet *_deletedObjects;
 54  
 55      NSMapTable *_objectIdToObject;
 56  
 57      BOOL _hasChanges;
 58  
 59      //
 60      BOOL _requestedProcessPendingChanges;
 61  }
 62  
 63  - (NSPersistentStoreCoordinator *) persistentStoreCoordinator;
 64  - (NSUndoManager *) undoManager;
 65  - (BOOL) retainsRegisteredObjects;
 66  - (BOOL) propagatesDeletesAtEndOfEvent;
 67  - (NSTimeInterval) stalenessInterval;
 68  - (id) mergePolicy;
 69  
 70  - (void) setPersistentStoreCoordinator: (NSPersistentStoreCoordinator *) value;
 71  - (void) setUndoManager: (NSUndoManager *) value;
 72  - (void) setRetainsRegisteredObjects: (BOOL) value;
 73  - (void) setPropagatesDeletesAtEndOfEvent: (BOOL) value;
 74  - (void) setStalenessInterval: (NSTimeInterval) value;
 75  - (void) setMergePolicy: (id) value;
 76  
 77  - (NSSet *) registeredObjects;
 78  - (NSSet *) insertedObjects;
 79  - (NSSet *) updatedObjects;
 80  - (NSSet *) deletedObjects;
 81  
 82  - (BOOL) hasChanges;
 83  
 84  - (void) lock;
 85  - (void) unlock;
 86  - (BOOL) tryLock;
 87  
 88  - (void) undo;
 89  - (void) redo;
 90  - (void) reset;
 91  - (void) rollback;
 92  
 93  - (NSManagedObject *) objectRegisteredForID: (NSManagedObjectID *) objectID;
 94  
 95  - (NSManagedObject *) objectWithID: (NSManagedObjectID *) objectID;
 96  
 97  - (NSArray *) executeFetchRequest: (NSFetchRequest *) request
 98                              error: (NSError **) error;
 99  - (NSUInteger) countForFetchRequest: (NSFetchRequest *) request
100                                error: (NSError **) error;
101  
102  - (void) insertObject: (NSManagedObject *) object;
103  - (void) deleteObject: (NSManagedObject *) object;
104  
105  - (void) assignObject: object toPersistentStore: (NSPersistentStore *) store;
106  
107  - (void) detectConflictsForObject: (NSManagedObject *) object;
108  
109  - (void) refreshObject: (NSManagedObject *) object mergeChanges: (BOOL) flag;
110  
111  - (void) processPendingChanges;
112  
113  - (BOOL) obtainPermanentIDsForObjects: (NSArray *) objects
114                                  error: (NSError **) error;
115  - (BOOL) save: (NSError **) error;
116  - (void) mergeChangesFromContextDidSaveNotification:
117          (NSNotification *) notification;
118  
119  - (BOOL) commitEditing;
120  - (void) commitEditingWithDelegate: (id) delegate
121                   didCommitSelector: (SEL) didCommitSelector
122                         contextInfo: (void *) contextInfo;
123  - (void) discardEditing;
124  - (void) objectDidBeginEditing: (id) editor;
125  - (void) objectDidEndEditing: (id) editor;
126  
127  @end