Core Data 是 iOS 上進行資料持久化的首選方案。這篇文章把它的組成元件、依賴關係,以及從建置、建模到增查的完整流程一次講清楚。
這些元件的依賴關係可參考下圖:

要留意一個與直接操作 SQLite 的差異:Core Data 只能取出整個實體記錄後再分解,才能拿到單一屬性值。
整體分三步:建立資料上下文、建立資料模型、建立持久化儲存助理。
新增專案時選擇 Blank Application,並勾選 Use Core Data:

勾選之後,AppDelegate 中會自動產生相關程式碼:
@property (readonly, strong, nonatomic) NSManagedObjectContext *managedObjectContext; @property (readonly, strong, nonatomic) NSManagedObjectModel *managedObjectModel; @property (readonly, strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator; - (void)saveContext; - (NSURL *)applicationDocumentsDirectory;
其中 saveContext 負責把資料存回持久層,applicationDocumentsDirectory 則回傳 App 沙盒的 Documents 目錄路徑,例如 /var/mobile/Applications/5FG80A45-DFB5-4087-A1B1-41342A977E21/Documents/。
App 即將終止時記得存回:
- (void)applicationWillTerminate:(UIApplication *)application {
[self saveContext];
}
- (void)saveContext {
NSError *error = nil;
NSManagedObjectContext *managedObjectContext = self.managedObjectContext;
if (managedObjectContext != nil) {
if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
}
}
- (NSURL *)applicationDocumentsDirectory {
return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
}
資料上下文初始化之後,必須綁上持久化儲存助理:
- (NSManagedObjectContext *)managedObjectContext {
if (__managedObjectContext != nil) {
return __managedObjectContext;
}
NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
if (coordinator != nil) {
__managedObjectContext = [[NSManagedObjectContext alloc] init];
[__managedObjectContext setPersistentStoreCoordinator:coordinator];
}
return __managedObjectContext;
}
資料模型必須依賴 .momd 的路徑,而 .momd 是由 .xcdatamodeld 編譯而來:
- (NSManagedObjectModel *)managedObjectModel {
if (__managedObjectModel != nil) {
return __managedObjectModel;
}
NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"TestApp" withExtension:@"momd"];
__managedObjectModel = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
return __managedObjectModel;
}
持久化儲存助理要依賴 NSManagedObjectModel,接著指定儲存型別(預設 NSSQLiteStoreType)、路徑與檔名:
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
if (__persistentStoreCoordinator != nil) {
return __persistentStoreCoordinator;
}
NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@"TestApp.sqlite"];
NSError *error = nil;
__persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:[self managedObjectModel]];
if (![__persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:nil error:&error]) {
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
return __persistentStoreCoordinator;
}
除此之外,專案還會產生 .xcdatamodeld 檔、自動連結 CoreData.framework,並在 .pch 預編譯碼頭檔中匯入:
#import <CoreData/CoreData.h>
新增實體:選取 .xcdatamodel 檔,在編輯器底部工具列點 Add Entity,再於右側欄命名。

新增屬性:選取實體後點 Add Attribute,命名並設定 Attribute Type。

建立關係:點 Add Relationship,命名後把 destination 指向另一個實體。

建立反向關係:在另一個實體建立關係並命名,目標指向先前的實體,並在 Inverse 欄位選回先前那條關係。

設定刪除規則:兩條關係都選 Cascade(關聯模式),這樣其中一筆資料被刪除時,另一端的資料也會一起消失。

切換 Editor Style 按鈕可以換一種檢視方式:

在 AppDelegate.m 的 application:didFinishLaunchingWithOptions: 中呼叫自訂方法:
- (void)insertCoreData {
NSManagedObjectContext *context = [self managedObjectContext];
NSManagedObject *contactInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactInfo" inManagedObjectContext:context];
[contactInfo setValue:@"name B" forKey:@"name"];
[contactInfo setValue:@"birthday B" forKey:@"birthday"];
[contactInfo setValue:@"age B" forKey:@"age"];
NSManagedObject *contactDetailInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactDetailInfo" inManagedObjectContext:context];
[contactDetailInfo setValue:@"address B" forKey:@"address"];
[contactDetailInfo setValue:@"name B" forKey:@"name"];
[contactDetailInfo setValue:@"telephone B" forKey:@"telephone"];
// 建立雙向關聯
[contactDetailInfo setValue:contactInfo forKey:@"info"];
[contactInfo setValue:contactDetailInfo forKey:@"details"];
NSError *error;
if (![context save:&error]) {
NSLog(@"不能保存:%@", [error localizedDescription]);
}
}
流程是:取得上下文 → 用 insertNewObjectForEntityForName 建立兩筆記錄 → 對編輯器中定義的屬性賦值。此時資料只存在記憶體,呼叫 save 之後才真正落地。
- (void)dataFetchRequest {
NSManagedObjectContext *context = [self managedObjectContext];
NSFetchRequest *fetchRequest = [[[NSFetchRequest alloc] init] autorelease];
NSEntityDescription *entity = [NSEntityDescription entityForName:@"ContactInfo" inManagedObjectContext:context];
[fetchRequest setEntity:entity];
NSError *error;
NSArray *fetchedObjects = [context executeFetchRequest:fetchRequest error:&error];
for (NSManagedObject *info in fetchedObjects) {
NSLog(@"name:%@", [info valueForKey:@"name"]);
NSLog(@"age:%@", [info valueForKey:@"age"]);
NSLog(@"birthday:%@", [info valueForKey:@"birthday"]);
NSManagedObject *details = [info valueForKey:@"details"];
NSLog(@"address:%@", [details valueForKey:@"address"]);
NSLog(@"telephone:%@", [details valueForKey:@"telephone"]);
}
}
fetchRequest 是 SQL 查詢的包裝類,必須用 setEntity 指定要查的實體;entityForName 會回傳該實體結構的指標。執行 executeFetchRequest:error: 後,成功時會拿到對應的記錄陣列。你也可以透過 NSManagedObject 上的關聯屬性,直接跳到另一筆記錄取欄位。
為每個實體產生 NSManagedObject 子類,之後就能用強型別的屬性存取,比 Key-Value 更安全也更易讀。在模型編輯器中選取實體,透過 File → New → File... → Core Data → NSManagedObject subclass 產生同名類別。

#import <Foundation/Foundation.h> #import <CoreData/CoreData.h> @class ContactDetailInfo; @interface ContactInfo : NSManagedObject @property (nonatomic, retain) NSString *age; @property (nonatomic, retain) NSString *birthday; @property (nonatomic, retain) NSString *name; @property (nonatomic, retain) ContactDetailInfo *details; @end
#import "ContactInfo.h" #import "ContactDetailInfo.h" @implementation ContactInfo @dynamic age; @dynamic birthday; @dynamic name; @dynamic details; @end
這裡的 @dynamic 是告訴編譯器不要理會這些存取器,讓編譯通過;真正的 getter 與 setter 由 Core Data 在執行期動態產生。
#import <Foundation/Foundation.h> #import <CoreData/CoreData.h> @class ContactInfo; @interface ContactDetailInfo : NSManagedObject @property (nonatomic, retain) NSString *address; @property (nonatomic, retain) NSString *name; @property (nonatomic, retain) NSString *telephone; @property (nonatomic, retain) ContactInfo *info; @end
#import "ContactDetailInfo.h" #import "ContactInfo.h" @implementation ContactDetailInfo @dynamic address; @dynamic name; @dynamic telephone; @dynamic info; @end
產生之後,模型編輯器右側欄的 Class 欄位會變成具體類別名稱:

原本 Key-Value 風格的程式碼就可以改寫成:
- (void)insertCoreData {
NSManagedObjectContext *context = [self managedObjectContext];
ContactInfo *contactInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactInfo" inManagedObjectContext:context];
contactInfo.name = @"name B";
contactInfo.birthday = @"birthday B";
contactInfo.age = @"age B";
ContactDetailInfo *contactDetailInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactDetailInfo" inManagedObjectContext:context];
contactDetailInfo.address = @"address B";
contactDetailInfo.name = @"name B";
contactDetailInfo.telephone = @"telephone B";
contactDetailInfo.info = contactInfo;
contactInfo.details = contactDetailInfo;
NSError *error;
if (![context save:&error]) {
NSLog(@"不能保存:%@", [error localizedDescription]);
}
}
- (void)dataFetchRequest {
NSManagedObjectContext *context = [self managedObjectContext];
NSFetchRequest *fetchRequest = [[[NSFetchRequest alloc] init] autorelease];
NSEntityDescription *entity = [NSEntityDescription entityForName:@"ContactInfo" inManagedObjectContext:context];
[fetchRequest setEntity:entity];
NSError *error;
NSArray *fetchedObjects = [context executeFetchRequest:fetchRequest error:&error];
for (ContactInfo *info in fetchedObjects) {
NSLog(@"name:%@", info.name);
NSLog(@"age:%@", info.age);
NSLog(@"birthday:%@", info.birthday);
ContactDetailInfo *details = info.details;
NSLog(@"address:%@", details.address);
NSLog(@"telephone:%@", details.telephone);
}
}
想看 Core Data 實際送出的 SQL,可以在 Edit Scheme → Run → Arguments 分頁加入參數:-com.apple.CoreData.SQLDebug 1。
使用 SQLite 儲存時,資料表名稱是「Z」加上實體名稱大寫,一個實體對應一張表;欄位名稱則是「Z」加上屬性名稱大寫。
