1.2 初始化Core Data棧(Core Data Programming Guide翻譯)
這是蘋果官方文檔 Core Data Programming Guide 的渣翻譯。
Core Data棧是一個框架對象集合,這個集用以作為Core Data初始化的一部分和應用中的對象和外部數據的中間層。Core Data棧會處理所有外部存儲數據的交互,因此你可以集中精力在業務邏輯上。這個棧由3部分構成:托管對象上下文(NSManagedObjectContext,以下稱MOC),持久化存儲協調器(NSPersistentStoreCoordinator,以下稱PSC),托管對象模型(NSManagedObjectModel,以下稱MOM),稍后在本章節會詳細討論。
在訪問應用數據之前你要初始化Core Data棧。棧的初始化準備好了Core Data數據請求和數據的創建。這里有一個Core Data棧的創建例子。
代碼3-1 Core Data棧的創建例子
OBJECTIVE-C
@interface MyDataController : NSObject
@property (strong) NSManagedObjectContext *managedObjectContext;
- (void)initializeCoreData;
@end
@implementation MyDataController
- (id)init
{
self = [super init];
if (!self) return nil;
[self initializeCoreData];
return self;
}
- (void)initializeCoreData
{
NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"DataModel" withExtension:@"momd"];
NSManagedObjectModel *mom = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
NSAssert(mom != nil, @"Error initializing Managed Object Model");
NSPersistentStoreCoordinator *psc = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:mom];
NSManagedObjectContext *moc = [[NSManagedObjectContext alloc] initWithConcurrencyType:NSMainQueueConcurrencyType];
[moc setPersistentStoreCoordinator:psc];
[self setManagedObjectContext:moc];
NSFileManager *fileManager = [NSFileManager defaultManager];
NSURL *documentsURL = [[fileManager URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
NSURL *storeURL = [documentsURL URLByAppendingPathComponent:@"DataModel.sqlite"];
dispatch_async(dispatch_get_global_queue( DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^(void) {
NSError *error = nil;
NSPersistentStoreCoordinator *psc = [[self managedObjectContext] persistentStoreCoordinator];
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:options error:&error];
NSAssert(store != nil, @"Error initializing PSC: %@\n%@", [error localizedDescription], [error userInfo]);
});
}
SWIFT
import UIKit
import CoreData
class DataController: NSObject {
var managedObjectContext: NSManagedObjectContext
init() {
// This resource is the same name as your xcdatamodeld contained in your project.
guard let modelURL = NSBundle.mainBundle().URLForResource("DataModel", withExtension:"momd") else {
fatalError("Error loading model from bundle")
}
// The managed object model for the application. It is a fatal error for the application not to be able to find and load its model.
guard let mom = NSManagedObjectModel(contentsOfURL: modelURL) else {
fatalError("Error initializing mom from: \(modelURL)")
}
let psc = NSPersistentStoreCoordinator(managedObjectModel: mom)
managedObjectContext = NSManagedObjectContext(concurrencyType: .MainQueueConcurrencyType)
managedObjectContext.persistentStoreCoordinator = psc
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_BACKGROUND, 0)) {
let urls = NSFileManager.defaultManager().URLsForDirectory(.DocumentDirectory, inDomains: .UserDomainMask)
let docURL = urls[urls.endIndex-1]
/* The directory the application uses to store the Core Data store file.
This code uses a file named "DataModel.sqlite" in the application's documents directory.
*/
let storeURL = docURL.URLByAppendingPathComponent("DataModel.sqlite")
do {
try psc.addPersistentStoreWithType(NSSQLiteStoreType, configuration: nil, URL: storeURL, options: nil)
} catch {
fatalError("Error migrating store: \(error)")
}
}
}
}
這個例子創建了一個控制器對象,表示應用的持久化層。這個控制器調用了默認的“init”進行初始化。作為“init”調用的一部分,“initializeCoreData”方法會被調用,之后它進行了Core Data棧的創建。
NSManagedObjectModel
NSManagedObjectModel實例描述了Core Data棧將要訪問的數據。在Core Data棧的創建中,NSManagedObjectModel(MOM)作為Core Data棧創建的第一步,被加載到了內存中。上面的源碼中使用了一個已知的NSManagedObjectModel文件名(這里是DataModel.momd)解析了一個從應用bundle中的NSURL。當這個NSManagedObjectModel被初始化,NSPersistentStoreCoordinator對象會被構建出來。
NSPersistentStoreCoordinator
NSPersistentStoreCoordinator位于Core Data棧的中間。這個協調器負責實例化在模型中定義的Entity。它會創建了模型中的Entity,和在持久化存儲(NSPersistentStore)中查詢已經存在的實例。持久化存儲可以是硬盤或者內存。基于應用的結構,雖然不常見,但是可以允許存在多個持久化存儲被NSPersistentStoreCoordinator管理。
基于NSManagedObjectModel定義了數據結構,NSPersistentStoreCoordinator會從持久化數據中實例化對象,并向下傳遞給發出請求的NSManagedObjectContext。NSPersistentStoreCoordinator還會驗證數據和NSManagedObjectModel中的定義的一致性。
NSManagedObjectContext
托管對象上下文(NSManagedObjectContext)是應用中交互最多的對象,因此是暴露給整個應用的。可以想象MOC為一個智能的草稿板。當你在持久化存儲中抓取了一個對象,你就提取了一個臨時拷貝到了組織了一個對象圖(或者對象圖的集合)的草稿板中。你可以任意修改這個對象。直到執行了save操作,否則持久化存儲被會被修改。
所有托管對象(MO)必須在MOC中注冊。你可以使用MOC在對象圖中添加或者刪除對象。這個MOC會跟蹤任何你做的修改,無論是個別的對象字段還是對象之間的關系。利用修改追蹤,MOC提供了撤銷(undo)和重做(redo)功能。它也保證了你修改了對象之間的關系,對象圖也能同步。
如果你選擇對修改進行save操作,MOC會驗證你的對象是在合法狀態。如果是,修改會被保存到持久化存儲中,新創建的對象會被作為新紀錄插入,刪除對象會刪除對應的記錄。
如果沒有Core Data,你需要手動寫方法來實現數據的歸檔和讀檔、保持跟蹤模型數據、和撤銷管理器交互進行撤銷操作。在Core Data框架中,主要通過MOC,大部分這些功能都會自動提供。