Core Data 是位於 SQLite 之上的強大持久化層,它隱藏了 SQL 的複雜性,讓我們能用操作物件的方式操作資料庫。Core Data 會把資料表的每一列轉換成 Objective-C 物件(即「托管物件」,managed object),因此即使完全不懂 SQL 也能完成資料存取。
在 MVC 設計模式中,Core Data 屬於模型層。一般需要在裝置上儲存結構化資料時,工程師會在 SQLite 與序列化( NSCoding 歸檔)之間做選擇,而 Core Data 可以視為兩者的混合體:它擁有 SQL 的強大查詢能力,使用起來卻和序列化一樣簡單,而且不需要手動維護「屬性名稱 ↔ 資料庫欄位名稱」的對應關係。
托管物件(Managed Object):要存入資料庫的物件表示,可視為 SQL 的一筆紀錄。它包含若干欄位,與應用程式中物件的屬性相互對應。建立後必須先托管到「托管物件上下文中」,才能進一步存入資料庫。
托管物件上下文(Managed Object Context):包含所有已準備提交的托管物件。新增、修改、刪除都在這一層進行,它相當於應用程式與資料庫之間的緩衝區,只有呼叫 save: 才會真正落盤。
托管物件模型/資料表(Managed Object Model):描述資料庫的 schema,供上下文與資料庫互動時使用。其中包含多個實體描述(NSEntityDescription),每個實體對應一個資料表。
首先確認已把 CoreData.framework 加入專案,接著新增模型檔:New File > Core Data > Data Model,命名為 CDJournal.xcdatamodel。以下我們做一個簡單的流水帳程式。
打開表編輯器,新增一個名為 Entry 的實體,並為它加入屬性並指定型別(例如 title、body 為 String,creationDate 為 Date)。若有多個實體之間的關聯(例如一個 Author 對應多個 Entry),可透過拖放建立關係,性質類似 SQL 的外鍵。

定義完實體後,必須產生對應的類別:選取 Entry 實體,選擇選單 Editor > Create NSManagedObject Subclass,點擊 Create。完成後專案中會多出 Entry.h 與 Entry.m,這就是實體的物件表示。

在 AppDelegate.h 中宣告三個必要物件:
#import <UIKit/UIKit.h> #import <CoreData/CoreData.h> @interface AppDelegate : UIResponder <UIApplicationDelegate> @property (strong, nonatomic) UIWindow *window; @property (strong, nonatomic) NSManagedObjectModel *managedObjectModel; // 資料模型 @property (strong, nonatomic) NSManagedObjectContext *managedObjectContext; // 上下文 @property (strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator; // 持久化協調器 @end
接著在 .m 中實作三個 getter:
- (NSManagedObjectModel *)managedObjectModel {
if (managedObjectModel != nil) return managedObjectModel;
managedObjectModel = [[NSManagedObjectModel mergedModelFromBundles:nil] retain];
return managedObjectModel;
}
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
if (persistentStoreCoordinator != nil) return persistentStoreCoordinator;
NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
NSUserDomainMask, YES) lastObject];
// Core Data 基於 SQLite,DB 檔名需與 xcdatamodel 同名
NSURL *storeUrl = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"CDJournal.sqlite"]];
NSError *error = nil;
persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc]
initWithManagedObjectModel:[self managedObjectModel]];
if (![persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType
configuration:nil
URL:storeUrl
options:nil
error:&error]) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
}
return persistentStoreCoordinator;
}
- (NSManagedObjectContext *)managedObjectContext {
if (managedObjectContext != nil) return managedObjectContext;
NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
if (coordinator != nil) {
managedObjectContext = [[NSManagedObjectContext alloc] init];
[managedObjectContext setPersistentStoreCoordinator:coordinator];
}
return managedObjectContext;
}
為避免 App 被切到背景時遺失未儲存的資料,別忘了實作 termination 時的保存:
- (void)applicationWillTerminate:(UIApplication *)application {
NSError *error;
if (managedObjectContext != nil) {
if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
}
}
}
hasChanges 用來檢查是否有未儲存的變更,有的話才執行 save,可避免不必要的寫入。
在 ViewController.h 中宣告兩個輸入框與三個 action:
@interface ViewController : UIViewController @property (retain, nonatomic) IBOutlet UITextField *titleTextField; @property (retain, nonatomic) IBOutlet UITextField *contentTextField; @property (strong, nonatomic) AppDelegate *myDelegate; @property (strong, nonatomic) NSMutableArray *entries; - (IBAction)addToDB:(id)sender; // 新增 - (IBAction)queryFromDB:(id)sender; // 查詢 - (IBAction)backgroundTapped:(id)sender; // 收起鍵盤 @end
新增——用 NSEntityDescription 建立托管物件,賦值後呼叫 save:
- (IBAction)addToDB:(id)sender {
Entry *entry = (Entry *)[NSEntityDescription
insertNewObjectForEntityForName:@"Entry"
inManagedObjectContext:self.myDelegate.managedObjectContext];
[entry setTitle:self.titleTextField.text];
[entry setBody:self.contentTextField.text];
[entry setCreationDate:[NSDate date]];
NSError *error;
if (![self.myDelegate.managedObjectContext save:&error]) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
} else {
NSLog(@"Save successful!");
}
}
查詢——建立 NSFetchRequest,指定實體與排序方式:
- (IBAction)queryFromDB:(id)sender {
NSFetchRequest *request = [[NSFetchRequest alloc] init];
NSEntityDescription *entity = [NSEntityDescription entityForName:@"Entry"
inManagedObjectContext:self.myDelegate.managedObjectContext];
[request setEntity:entity];
// 依建立時間倒序排列
NSSortDescriptor *sort = [[NSSortDescriptor alloc] initWithKey:@"creationDate" ascending:NO];
[request setSortDescriptors:@[sort]];
NSError *error = nil;
NSArray *result = [self.myDelegate.managedObjectContext executeFetchRequest:request error:&error];
if (result == nil) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
}
self.entries = [result mutableCopy];
NSLog(@"The count of entry: %lu", (unsigned long)[self.entries count]);
for (Entry *entry in self.entries) {
NSLog(@"Title:%@ --- Content:%@ --- Date:%@",
entry.title, entry.body, entry.creationDate);
}
}
修改——直接對托管物件重新賦值,再 save 即可,Core Data 會自動偵測差異:
- (void)updateEntry:(Entry *)entry {
[entry setTitle:self.titleTextField.text];
[entry setBody:self.contentTextField.text];
[entry setCreationDate:[NSDate date]];
NSError *error;
if (![self.myDelegate.managedObjectContext save:&error]) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
}
}
刪除——呼叫 deleteObject 後 save:
- (void)deleteEntry:(Entry *)entry {
[self.myDelegate.managedObjectContext deleteObject:entry];
[self.entries removeObject:entry];
NSError *error;
if (![self.myDelegate.managedObjectContext save:&error]) {
NSLog(@"Error: %@, %@", error, [error userInfo]);
}
}
收起鍵盤:
- (IBAction)backgroundTapped:(id)sender {
[self.titleTextField resignFirstResponder];
[self.contentTextField resignFirstResponder];
}
填入資料後點擊 Add,新增成功:

多加幾筆資料後點擊 Query,主控台便會印出查詢結果:

相較於直接操作 SQLite,Core Data 的最大優勢在於:資料模型的變更由工具管理、查詢以物件語法表達、並免費獲得 undo/redo 與 parent-child context 的能力。代價則是抽象層較厚,除錯時需要理解 faulting 與 batch fetch 等機制。