CoreData 理解和編程

CoreData是對sqlite數據庫的一個封裝.

sqlite數據庫操作的基本流程是, 創建數據庫, 再通過定義一些字段來定義表格結構, 可以利用sql語句向表格中插入記錄, 刪除記錄, 修改記錄, 表格之間也可以建立聯繫.

這個過程出現了, 表格的結構(schema), 所有表格的結構和相互聯繫構成整個數據庫的模型, 數據庫存放的方式(可以是文件或者在內存), 數據庫操作, sql語句(主要是查詢), 表格裏面的記錄

下面將上面說的文字, 跟CoreData的類作個對應:

表格結構    --> NSEntityDescription
數據庫中所有表格和他們的聯繫 -->NSManagedObjectModel
數據庫存放方式 --> NSPersistentStoreCoordinator
數據庫操作 --> NSManagedObjectContext
查詢語句 --> NSFetchRequest
表格的記錄 --> NSManagedObject

可能上面的對應關係並非十分嚴格, 但確實可以幫助理解.

下面再看看CoreData的類
NSEntityDescription
NSManagedObjectModel

NSEntityDescription用來定義表格結構, 所以你就可以理解NSManagedObjectModel中的setEntities:(NSArray *)entities函數大概有什麼用了 . 通常, 定義model, 是用文件CoreData.xcdatamodel, 可以圖形化的操作. 這類似用nib來創建界面. 

建個工程, 使用coredata, 模擬器運行之後, 程序對應的document目錄出現一個CoreData.sqlite. 可以利用sqlite3命令來查看裏面的表格結構
用命令行sqlite3 CoreData.sqlite 進入
>.tables
ZEVENT        Z_METADATA    Z_PRIMARYKEY
可以看到有表格ZEVENT, 對應的CoreData.xcdatamodel文件有名字叫Event的Entity

>.schema ZEVENT
CREATE TABLE ZEVENT ( Z_PK INTEGER PRIMARY KEY, Z_ENT INTEGER, Z_OPT INTEGER, ZTIMESTAMP TIMESTAMP );
對應的Event中有屬性timeStamp, 可以看到, 相應的ZEVENT表格中有字段TIMESTAMP

> select * from ZEVENT
1|1|1|306295807.974966
2|1|1|306295810.981875
3|1|1|306295811.982537
這表格有三個記錄, 可以用來初始化三個NSManagedObject, 修改了NSManagedObject, save之後也修改了表格記錄

你可以在CoreData.xcdatamodel添加新的entity, 之後用sqlit3命令來查看數據庫的變化

NSPersistentStoreCoordinator
這個類的對象通常用NSManagedObjectModel的對象來初始化, 這個類抽象出不同的存放方式, 最經常用的是NSSQLiteStoreType. 

NSManagedObjectContext
這個類的對象又用NSPersistentStoreCoordinator的對象來初始化, 它裏面有些方法來添加, 刪除NSManagedObject

NSFetchRequest
通常用NSEntityDescription來構造查詢, 也就指定查詢那個表格, 另外可以指定排序.

在CoreData的設計中, 下一層有相應的屬性指向上一層, 所以NSManagedObject有屬性得到NSEntityDescription, NSEntityDescription有屬性得到NSManagedObjectModel.

CoreData編程使用
1：導入CoreData的framework

2：AppDelegate類的頭文件中
#import <CoreData/CoreData.h>
 
@property (nonatomic, retain, readonly) NSManagedObjectModel *managedObjectModel;
@property (nonatomic, retain, readonly) NSManagedObjectContext *managedObjectContext;
@property (nonatomic, retain, readonly) NSPersistentStoreCoordinator *persistentStoreCoordinator;
@property (nonatomic, readonly) NSString *applicationDocumentsDirectory;

3：在AppDelegate的實現文件中
@synthesize managedObjectModel;
@synthesize managedObjectContext;
@synthesize persistentStoreCoordinator;
@synthesize applicationDocumentsDirectory;

- (void)dealloc
{
    [_window release];
    [_tabBarController release];
    [managedObjectModel release];
    [managedObjectContext release];
    [persistentStoreCoordinator release];
    [applicationDocumentsDirectory release];
    [super dealloc];
}
- (NSManagedObjectContext *)managedObjectContext
{
    if (managedObjectContext != nil) {
        return managedObjectContext;
    }
    
    NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
    if (coordinator != nil) {
        managedObjectContext = [[NSManagedObjectContext alloc] init];
        [managedObjectContext setPersistentStoreCoordinator:coordinator];
    }
    
    return managedObjectContext;
}

- (NSManagedObjectModel *)managedObjectModel 
{
    if (managedObjectModel != nil) {
        return managedObjectModel;
    }
    
    //從本地所有xcdatamodel文件中獲得這個CoreData的數據模板
    managedObjectModel = [[NSManagedObjectModel mergedModelFromBundles:nil] retain];
    
    return managedObjectModel;
}

- (NSPersistentStoreCoordinator *)persistentStoreCoordinator 
{
    if (persistentStoreCoordinator != nil) {
        return persistentStoreCoordinator;
    }
    
    NSURL *storeUrl = [NSURL fileURLWithPath:[[self applicationDocumentsDirectory] stringByAppendingPathComponent:@"TestDB.sqlite"]];//數據庫名爲TestDB.sqlite
    
    NSError *error;
    persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:[self managedObjectModel]];
    
    
    if (![persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeUrl options:nil error:&error]) {
        NSAssert(0, @"persistentStoreCoordinator init failed!");
    }
    
    return persistentStoreCoordinator;
}

- (NSString *)applicationDocumentsDirectory
{
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *basePath = ([paths count] > 0) ? [paths objectAtIndex:0] : nil;
    return basePath;
}
- (void)applicationWillTerminate:(UIApplication *)application
{
    /*
     Called when the application is about to terminate.
     Save data if appropriate.
     See also applicationDidEnterBackground:.
     */
    NSError *error;
    if (managedObjectContext != nil) {
        if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
            NSAssert(0, @"save changes failed when terminage application!");
        }
    }
}

完成上述步驟之後，ViewController類裏面就可以訪問數據庫了。
4: 建立數據庫模型，如下選擇新建文件->Core Data->Data Model

點擊下一步輸入上面確定的數據庫名：TestDB
選中新產生的文件 TestDB.xcdatamodeld,右邊的窗口將會變成編輯data model的，如下圖點擊Add Entity之後輸入你要的表名。

完成之後它將出現在如下圖（我這裏表名是Event）。選中Event點擊上圖所示的Add Attribute就可以給表增加字段了。

當你把表和字段都建立好了之後。在new file，選擇第2張圖裏面的NSManagedObject subclass。一路next下去。編譯器將會自動給每張表生成對應的.h和 .m文件，這樣數據模型就ok了。
5：插入數據
    CLLocation *location = [locationManager location];
    
    if (!location) {
        return;
    }
    
    Event *event = (Event *)[NSEntityDescription insertNewObjectForEntityForName:@"Event" inManagedObjectContext:managedObjectContext];
    
    CLLocationCoordinate2D coordinate = [location coordinate];
    [event setLatitude:[NSNumber numberWithDouble:coordinate.latitude]];
    [event setLongitude:[NSNumber numberWithDouble:coordinate.longitude]];
    [event setCreationDate:[NSDate date]];
    
    NSError *error = nil;
    if (![managedObjectContext save:&error ]) {
        // handle error
    }
6：查詢數據：
    eventArray = [[NSMutableArray alloc] init];
    
    NSFetchRequest *request = [[NSFetchRequest alloc] init];
    NSEntityDescription *entity = [NSEntityDescription entityForName:@"Event" inManagedObjectContext:managedObjectContext];
    [request setEntity:entity];
    //查詢結果排序
   NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"creationDate" ascending:NO];
    NSArray *sortDescriptors = [[NSArray alloc] initWithObjects:sortDescriptor, nil];
    
    [request setSortDescriptors:sortDescriptors];
    [sortDescriptors release];
    [sortDescriptor release];
    
    
    NSError *error = nil;
    //NSMutableArray是一個Event對象的數組，這是有上面那條藍色語句決定的。
    NSMutableArray *mutableFetchResults = [[managedObjectContext executeFetchRequest:request error:&error] mutableCopy];
    
    if (mutableFetchResults == nil) {
        // Handle the error
    }
    
    [self setEventArray:mutableFetchResults];
    [mutableFetchResults release];
    [request release];
7：刪除數據
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath
{
    //刪除在indexPath處的managed object
    if (editingStyle == UITableViewCellEditingStyleDelete) {
        NSManagedObject *eventToDelete = [eventArray objectAtIndex:indexPath.row];
        [managedObjectContext deleteObject:eventToDelete];
    }
    
    //更新數組和table view
    [eventArray removeObjectAtIndex:indexPath.row];
    [tableView deleteRowsAtIndexPaths:[NSArray arrayWithObject:indexPath ] withRowAnimation:YES];
    
    //提交改動
    NSError *error = nil;
    if (![managedObjectContext save:&error]) {
        //handle error
    }
}
8: 忽略修改
[managedObjectContext reset];