先建立一個勾選 Use Core Data 的專案,然後在 .xcdatamodeld 檔案中建立 entity 並添加屬性。


接著為 entity 之間建立關聯(relationship):

最後選擇 model 類別,讓 Xcode 產生對應的 NSManagedObject 子類。


@property 有兩個對應關鍵字:@synthesize 與 @dynamic。若兩者都不寫,預設等同 @synthesize var = _var;。
@synthesize 的語義是:如果你沒有手動實作 setter 與 getter,編譯器會自動補上這兩個方法。
@dynamic 則告訴編譯器:這個屬性的 setter 與 getter 由執行期提供,不要自動生成(唯讀屬性只需 getter)。宣告為 @dynamic 卻未提供對應方法時,編譯階段不會報錯,但程式執行到 instance.var = someVar 或讀取時,會因找不到方法而崩潰——這就是所謂的動態綁定。Core Data 正是靠這個機制,在存取屬性時自動完成與持久化儲存的對接。
這幾個方法理解其作用即可,平時不需要更動;若想完全手動建立 Core Data 也可以自己寫。
#pragma mark - Core Data stack
@synthesize managedObjectContext = _managedObjectContext;
@synthesize managedObjectModel = _managedObjectModel;
@synthesize persistentStoreCoordinator = _persistentStoreCoordinator;
// 儲存在沙盒裡的具體位置
- (NSURL *)applicationDocumentsDirectory {
return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory
inDomains:NSUserDomainMask] lastObject];
}
// 託管對象模型
- (NSManagedObjectModel *)managedObjectModel {
if (_managedObjectModel != nil) {
return _managedObjectModel;
}
NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"CoreDatatest" withExtension:@"momd"];
_managedObjectModel = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
return _managedObjectModel;
}
// 持久化存儲協調器
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
if (_persistentStoreCoordinator != nil) {
return _persistentStoreCoordinator;
}
_persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc]
initWithManagedObjectModel:[self managedObjectModel]];
NSURL *storeURL = [[self applicationDocumentsDirectory]
URLByAppendingPathComponent:@"CoreDatatest.sqlite"];
NSError *error = nil;
NSString *failureReason = @"There was an error creating or loading the application's saved data.";
if (![_persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType
configuration:nil
URL:storeURL
options:nil
error:&error]) {
NSMutableDictionary *dict = [NSMutableDictionary dictionary];
dict[NSLocalizedDescriptionKey] = @"Failed to initialize the application's saved data";
dict[NSLocalizedFailureReasonErrorKey] = failureReason;
dict[NSUnderlyingErrorKey] = error;
error = [NSError errorWithDomain:@"YOUR_ERROR_DOMAIN" code:9999 userInfo:dict];
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
return _persistentStoreCoordinator;
}
// 託管上下文
- (NSManagedObjectContext *)managedObjectContext {
if (_managedObjectContext != nil) {
return _managedObjectContext;
}
NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
if (!coordinator) {
return nil;
}
_managedObjectContext = [[NSManagedObjectContext alloc] init];
[_managedObjectContext setPersistentStoreCoordinator:coordinator];
return _managedObjectContext;
}
#pragma mark - Core Data Saving support
- (void)saveContext {
NSManagedObjectContext *managedObjectContext = self.managedObjectContext;
if (managedObjectContext != nil) {
NSError *error = nil;
if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
}
}
先在 ViewController 中引入 AppDelegate 與 entity 的頭檔,並宣告屬性:
@property (strong, nonatomic) AppDelegate *myAppDelegate;
User *user = (User *)[NSEntityDescription insertNewObjectForEntityForName:@"User"
inManagedObjectContext:self.myAppDelegate.managedObjectContext];
[user setName:_nametextfield.text];
[user setAge:[NSNumber numberWithInteger:[_agetextfield.text integerValue]]];
[user setSex:_sextextfield.text];
NSError *error;
BOOL isSaveSuccess = [myAppDelegate.managedObjectContext save:&error]; // 保存(容易忘)
if (!isSaveSuccess) {
NSLog(@"Error:%@", error);
_attentiontextview.text = [NSString stringWithFormat:@"Error:%@", error];
} else {
NSLog(@"Save Successful!");
_attentiontextview.text = @"Save Successful!";
}
// NSFetchRequest:請求(命令集)
NSFetchRequest *request = [[NSFetchRequest alloc] init];
// NSEntityDescription:實體描述(表)
NSEntityDescription *user = [NSEntityDescription entityForName:@"Department"
inManagedObjectContext:myAppDelegate.managedObjectContext];
[request setEntity:user];
NSError *error;
NSArray *mutablefetchResult = [myAppDelegate.managedObjectContext
executeFetchRequest:request error:&error];
if (mutablefetchResult == nil) {
NSLog(@"Error: %@", error);
}
NSLog(@"the count of entry:%lu", (unsigned long)[mutablefetchResult count]);
NSString *str = @"";
for (Department *user in mutablefetchResult) {
str = [str stringByAppendingFormat:@"name:%@------ ", user.departmentname];
}
NSLog(@"str:%@", str);
NSFetchRequest *request = [[NSFetchRequest alloc] init];
NSEntityDescription *user = [NSEntityDescription entityForName:@"User"
inManagedObjectContext:myAppDelegate.managedObjectContext];
[request setEntity:user];
// 設置查詢條件:NSPredicate(謂詞)
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name == %@", @"lisi"];
[request setPredicate:predicate];
NSError *error;
NSArray *mutablFetchResult = [myAppDelegate.managedObjectContext
executeFetchRequest:request error:&error];
if (mutablFetchResult == nil) {
NSLog(@"Error:%@", error);
}
for (User *user in mutablFetchResult) {
[user setAge:[NSNumber numberWithInteger:999]];
}
// 判斷是否修改成功
BOOL isSaveSuccess = [myAppDelegate.managedObjectContext save:&error]; // 保存(容易忘)
if (!isSaveSuccess) {
NSLog(@"Error:%@", error);
} else {
NSLog(@"update Successful!");
}
NSFetchRequest *request = [[NSFetchRequest alloc] init];
NSEntityDescription *user = [NSEntityDescription entityForName:@"Department"
inManagedObjectContext:myAppDelegate.managedObjectContext];
[request setEntity:user];
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"departmentname == %@", @"公共事業部"];
[request setPredicate:predicate];
NSError *error;
NSArray *mutableFetchResult = [myAppDelegate.managedObjectContext
executeFetchRequest:request error:&error];
if (mutableFetchResult == nil) {
NSLog(@"Error:%@", error);
}
for (User *user in mutableFetchResult) {
[myAppDelegate.managedObjectContext deleteObject:user];
}
// 判斷是否刪除成功
BOOL isDeleteSuccess = [myAppDelegate.managedObjectContext save:&error]; // 保存(容易忘)
if (!isDeleteSuccess) {
NSLog(@"Error:%@", error);
} else {
NSLog(@"delete Successful!");
}
嚴格來說,Core Data 不等於「SQLite 的封裝」,它是一個物件圖管理框架,底層儲存型別可以選擇 SQLite、Binary 或 In-Memory。相較直接寫 SQL,它的優勢明顯:高效、程式碼量少(省下至少一半的樣板程式碼)、資料結構清晰,而且物件關聯、改動追蹤、undo/redo 都內建可用。
代價是學習曲線。網路上多數教學一開始就丟出一堆術語,反而讓初學者更困惑。因此建議先記住四個核心物件:
NSManagedObjectModel:等同資料庫的結構定義,由 .xcdatamodeld 編譯而來。
NSPersistentStoreCoordinator:等同資料庫連線,負責 model 與實際檔案之間的橋接。
NSManagedObjectContext:等同工作區,你的所有操作都在這裡進行,直到 save 才會寫入。
NSEntityDescription:等同表。
NSFetchRequest / NSPredicate:等同 SELECT 語句與 WHERE 條件。
對 iOS 開發者而言,Core Data 幾乎是必備技能——沒有它,很多 app 根本無法存在。另外提醒一個高頻錯誤:新增、更新、刪除三種操作都必須呼叫 save:,否則改動只停留在 context 中,App 一關閉就消失不見。