Core Data 功能強大,但样板程式碼多到令人卻步:NSManagedObjectContext、NSPersistentStoreCoordinator、NSManagedObjectModel 三件套的配置,加上每一個 fetch 都要組 NSPredicate、處理 fault、記得 save。
MagicalRecord 是 Saul Mora 開發的開源庫,靈感來自 Ruby on Rails 的 Active Record 模式,目標就是讓 Core Data 用起来像 ActiveRecord 一樣直觀。它把 context 管理、背景佇列、合併策略這些容易出錯的部分都收攏起來。
建議用 CocoaPods:
pod 'MagicalRecord'
然後在 AppDelegate 中一行啟動:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[MagicalRecord setupCoreDataStack];
return YES;
}
進入背景時別忘了存檔:
- (void)applicationDidEnterBackground:(UIApplication *)application {
[MagicalRecord saveBackgroundTasksAndWait];
}
Person *person = [Person MR_createEntity]; person.firstname = @"Frank"; person.lastname = @"Zhang"; person.age = @26; [[NSManagedObjectContext MR_defaultContext] MR_saveToPersistentStoreAndWait];
// 全部
NSArray *persons = [Person MR_findAll];
NSLog(@"%ld", (unsigned long)[persons count]);
// 排序
NSArray *personsSorted = [Person MR_findAllSortedBy:@"firstname" ascending:YES];
// 條件查詢
NSArray *ageEquals25 = [Person MR_findByAttribute:@"age"
withValue:[NSNumber numberWithInt:25]];
// 第一筆
Person *person = [Person MR_findFirst];
// 條件 + 排序
NSArray *result = [Person MR_findByAttribute:@"lastname"
withValue:@"Zhang"
andOrderBy:@"age"
ascending:YES];
NSArray *wellPerson = [Person MR_findByAttribute:@"lastname"
withValue:@"Zhang"
andOrderBy:@"age"
ascending:YES];
for (Person *p in wellPerson) {
p.lastname = @"kun";
}
[[NSManagedObjectContext MR_defaultContext] MR_saveToPersistentStoreAndWait];
注意這裡不需要像原生 Core Data 那樣先 fetch 再逐筆修改並追蹤 changes——MagicalRecord 幫你處理了 context 的綁定與 save。
// 清空全部
[Person MR_truncateAll];
[[NSManagedObjectContext MR_defaultContext] MR_saveToPersistentStoreAndWait];
// 條件刪除
NSArray *personsDelete = [Person MR_findByAttribute:@"lastname"
withValue:@"Zhang"
andOrderBy:@"age"
ascending:YES];
NSLog(@"%ld", (unsigned long)[personsDelete count]);
for (Person *person in personsDelete) {
[person MR_deleteEntity];
}
[[NSManagedObjectContext MR_defaultContext] MR_saveToPersistentStoreAndWait];
MagicalRecord 真正的價值在這裡。原生 Core Data 的「在背景 context 存檔後要把變更合併回主 context」是無數 bug 的來源,而它已經內建處理:
[MagicalRecord saveWithBlock:^(NSManagedObjectContext *localContext) {
Person *person = [Person MR_createEntityInContext:localContext];
person.firstname = @"Frank";
// 這個 block 在背景佇列執行
}]; // 存檔後自動合併回 defaultContext
需要等待完成時:
[MagicalRecord saveWithBlockAndWait:^(NSManagedObjectContext *localContext) {
// ...
}];
優點:大幅降低 Core Data 的入門門檻;背景 context 與合併策略內建且正確;語法接近 ActiveRecord,可讀性高。
注意事項:MagicalRecord 已有一段時間未積極維護,若專案要長期運行,建議改用 Apple 官方自 iOS 10 起的 NSPersistentContainer——它免費、由 Apple 維護,並提供了同等級的便利:
// iOS 10+ 原生寫法
NSPersistentContainer *container =
[[NSPersistentContainer alloc] initWithName:@"MyModel"];
[container loadPersistentStoresWithCompletionHandler:^(NSPersistentStoreDescription *desc, NSError *error) {
if (error) NSLog(@"載入失敗:%@", error);
}];
self.persistentContainer = container;
// 背景執行 + 自動合併
NSManagedObjectContext *ctx = [self.persistentContainer newBackgroundContext];
[ctx performBlock:^{
Person *person = (Person *)[NSEntityDescription insertNewObjectForEntityForName:@"Person"
inManagedObjectContext:ctx];
person.firstname = @"Frank";
[self.persistentContainer.viewContext setMergePolicy:NSMergeByPropertyObjectTrumpMergePolicy];
// 存檔後 automaticallyMergesChangesFromParent 會處理合併
[ctx save:nil];
}];
在 NSPersistentContainer 建立時設定 viewContext.automaticallyMergesChangesFromParent = YES,就能得到與 MagicalRecord 相同的「背景寫入、主線程自動更新」體驗,而且不必引入第三方依賴。
第三方專案下載:github.com/magicalpanda/MagicalRecord