CoreData 是 iOS 5 之後出現的一套框架,本質上是對 SQLite 做了一層封裝與升級的數據持久化方案。它提供了對象 ↔ 關係的映射能力:既能把 OC 對象轉化為數據存進 SQLite 文件,也能把庫裡的數據還原成 OC 對象。
相比直接操作 SQLite,用 CoreData 最大的好處是不用寫 SQL 語句,增刪改查都通過對象操作完成。
先看一張官方結構圖:

四個關鍵角色:
PersistentObjectStore:真正存數據的地方,最常用的是 SQLite(CoreData 也支持 XML、二進制等存儲類型);ManagedObjectModel:對象模型,對應 Xcode 中創建的那個模型文件;PersistentStoreCoordinator:協調器,負責模型與實體類之間的轉換,管理不同存儲的上下文;ManagedObjectContext:對象管理上下文,負責實體對象與數據庫之間的交互,是我們日常打交道最多的對象。光看文字容易懵,換張理解圖:

最底層是 PersistentObjectStore,也就是實際存數據的結構;圖中的「模型」就是 ManagedObjectModel,是數據轉化為對象的模板。以 SQLite 存儲為例,三類操作的流程是:
這些環節的具體意義,還是在實際使用中體會更深。
CoreData.framework;#import <CoreData/CoreData.h>。依據上面的結構圖,第一步是創建數據模板 ManagedObjectModel。這一步全是圖形化操作:





一路 Next:先是選擇數據模板文件並勾選,接著勾選需要的實體,最後會自動生成對象模型文件。

幾點說明:
NSManagedObject,每個 NSManagedObject 實例對應庫中一條記錄;@dynamic 声明,具體存取細節由框架在運行時提供,開發者不用操心。ManagedObjectContext 的創建可以拆成四步:加載模型文件 → 指定數據存儲路徑 → 創建對應類型的存儲 → 創建上下文並關聯存儲。
- (NSManagedObjectContext *)createDbContext {
// 加載模型,傳 nil 表示合併 bundle 中的所有模型文件
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];
// 創建數據解析器
NSPersistentStoreCoordinator *storeCoordinator =
[[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];
// 拼接數據庫路徑
NSString *dir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
NSString *path = [dir stringByAppendingPathComponent:@"myDatabase.db"];
NSURL *url = [NSURL fileURLWithPath:path];
// 關聯 SQLite 持久存儲
NSError *error = nil;
[storeCoordinator addPersistentStoreWithType:NSSQLiteStoreType
configuration:nil
URL:url
options:nil
error:&error];
NSManagedObjectContext *context = nil;
if (!error) {
context = [[NSManagedObjectContext alloc] init];
context.persistentStoreCoordinator = storeCoordinator;
NSLog(@"數據庫打開成功");
} else {
NSLog(@"數據庫打開失敗:%@", error.localizedDescription);
}
return context;
}
插入時先用 NSEntityDescription(實體描述類)的類方法創建一個實體對象,賦值後保存上下文。
- (void)addClassTest {
Classes *classes = [NSEntityDescription insertNewObjectForEntityForName:@"Classes"
inManagedObjectContext:self.context];
classes.c_id = 301;
classes.c_name = @"高三(1)班";
NSError *error = nil;
// 增刪改之後都必須調用 save,否則操作不會落盤
if (![self.context save:&error]) {
NSLog(@"添加過程中發生錯誤:%@", error.localizedDescription);
}
}
刪除就是把關聯的對象從上下文中刪掉,然後保存:
- (void)removeClasses:(Classes *)classes {
[self.context deleteObject:classes];
NSError *error = nil;
if (![self.context save:&error]) {
NSLog(@"刪除過程中發生錯誤:%@", error.localizedDescription);
}
}
查詢要用到兩個類:
NSFetchRequest:獲取數據的請求;NSPredicate:請求的謂詞,也就是篩選條件。場景一:查詢只有唯一關聯對象的情況
例如查找用戶名為 Binger 的所有微博(一條微博只屬於一個用戶),用 keypath 直接查:
- (NSArray *)getStatusByUserName:(NSString *)name {
NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Status"];
request.predicate = [NSPredicate predicateWithFormat:@"user.name=%@", name];
return [self.context executeFetchRequest:request error:nil];
}
場景二:一個對象有多個關聯對象
例如查找內容包含 Watch、且昵稱為「小娜」的用戶發的微博(一個用戶有多條微博),可以兩步走:
- (NSArray *)getUsersByStatusText:(NSString *)text screenName:(NSString *)screenName {
NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Status"];
request.predicate = [NSPredicate predicateWithFormat:@"text LIKE '*Watch*'"];
NSArray *statuses = [self.context executeFetchRequest:request error:nil];
// 再對結果集做一次謂詞過濾
NSPredicate *userPredicate = [NSPredicate predicateWithFormat:@"user.screenName=%@", screenName];
return [statuses filteredArrayUsingPredicate:userPredicate];
}
拿到關聯對象直接改屬性,然後保存:
- (void)modifyClasses:(Classes *)classes {
classes.name = @"吊炸天畢業(1)班";
NSError *error = nil;
if (![self.context save:&error]) {
NSLog(@"修改過程中發生錯誤:%@", error.localizedDescription);
}
}
Xcode 是支持 CoreData 語句級調試的,開啟路徑如下:
Product → Scheme → Edit SchemeEdit Scheme → Run → Arguments依次添加兩個啟動參數(順序不能錯):-com.apple.CoreData.SQLDebug 1 與 -com.apple.CoreData.LoggingLevel 1。

配置好之後,運行過程中一旦操作了數據庫,對應的 SQL 語句就會打印在輸出面板裡,排查問題非常方便。
注意:如果模型發生了改動,實體類可以重新生成,但已存在的數據庫並不會自動跟著更新。這時需要考慮新建數據庫,並把舊數據遷移過去。