您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 資料持久化:用 MagicalRecord 馴服 Core Data

編輯:iOS 開發綜合

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

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved