MagicalRecord入門教程

與Core Data相關的還有比較有名的MagicalRecord。使用CoreData時會用到許多引用代碼,讓工作變得很複雜,MagicalRecord可以幫你解決這些問題。MagicalRecord的目標是清除CoreData引用的代碼,允許在需要請求優化的時候修改NSFetchRequest。  

 

需要iOS5.0及以上版本(也有兼容iOS 4.0的版本),Mac OS 10.7及以上版本。支持ARC/Non-ARC。能利用iCloud同步CoreData商店。

 

MagicalRecord的靈感來自於Ruby on Rails(wikipedia:Ruby on Rails簡稱Rails,是一個使用Ruby語言寫的開源Web應用框架,它是嚴格按照MVC結構開發的。它努力使自身保持簡單,來使實際的應用開發時的代碼更少,使用最少的配置。) 

Magical Record是什麼

在Cocoa中存在一種技術叫Core Data,用來對數據進行持久化,類似於Java世界中的Hibernate。在新建Cocoa Application/iOS Application的嚮導中,有一個選項是要不要使用Core Data,當啓用以後你會發現在AppDelegate.m中添加了大量與Core Data相關的代碼,但是你對大部分代碼不知所以然。


Magical Record的出現在一定程度上緩解了這個問題,降低了Core Data的使用門檻。


Magical Record借用了Ruby on Rails中的Active Record模式,使得你可以非常容易的添加、查找、刪除數據。Google了一下,沒有發現中文相關教程,遂把自己的試用過程記錄下來,寫成此篇文章。


安裝

  1. 新建一個項目,注意在嚮導中不要勾選Core Data。

  2. 下載Magical Record,並把MagicalRecord目錄拖拽到工程中,記得勾選copy items into group folder。

  3. 爲項目添加CoreData FrameWork。(點擊工程根節點,然後依次Targets > Build Phases > Link Binary With Libraries > + > CoreData.framework > Add)。

  4. 添加Magical Record的頭文件到*-Prefix.pch:

    1. #import "CoreData+MagicalRecord.h"


使用Magical Record

初始化Magical Record

首先在AppDelegate.m中添加以下代碼對Magical Record進行初始化:

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification
{
    [MagicalRecord setupCoreDataStackWithStoreNamed:@"MyDatabase.sqlite"];
    // ...
    return YES;
}
- (void)applicationWillTerminate:(NSNotification *)aNotification
{
    [MagicalRecord cleanUp];
}

是否比Core Data默認的初始化簡潔多了呢?

查詢記錄

使用Person的MR_findAll、MR_findAllSortedBy、MR_findByAttribute等方法可以查詢Person:

  1. //查找數據庫中的所有Person。
    NSArray *persons = [Person MR_findAll];
    //查找所有的Person並按照first name排序。
    NSArray *personsSorted = [Person MR_findAllSortedBy:@"firstname" ascending:YES];
    //查找所有age屬性爲25的Person記錄。
    NSArray *personsAgeEuqals25   = [Person MR_findByAttribute:@"age" withValue:[NSNumber numberWithInt:25]];
    //查找數據庫中的第一條記錄
    Person *person = [Person MR_findFirst];


添加記錄

使用Person的MR_createEntity方法可以方便的創建一個Person,需要使用保存哦:

    Person *personAdd = [Person MR_createEntity];
    personAdd.firstName = @"mengmeng";
    personAdd.sex = @"nv";
    personAdd.age = [NSNumber numberWithInt:14];
    [[NSManagedObjectContext MR_defaultContext] MR_saveToPersistentStoreAndWait];
    [[NSManagedObjectContext MR_defaultContext] MR_saveOnlySelfWithCompletion:^(BOOL contextDidSave, NSError *error) {
        NSLog(@"保存完成了");
    }];


更新記錄

直接對數據庫中查找到的Person進行賦值,然後使用NSManagedObjectContext保存即可更新Person:

  1. Person *person = ...;//此處略
    person.lastname = object;        
    [[NSManagedObjectContext MR_defaultContext] MR_save];


刪除記錄

使用Person的MR_deleteEntity可以方便的刪除Person,模式和添加更新一致:

  1. Person *person = ...;//此處略
    [person MR_deleteEntity];
    [[NSManagedObjectContext MR_defaultContext] MR_save];


小技巧

啓動時MR_mergedObjectModelFromMainBundle方法報錯

Core Data的模型有版本的概念,有可能在你Magical Record第一次初始化完成以後,你又更改了模型文件,導致Core Data去合併模型報錯。解決辦法很簡單,點擊菜單中的Project->Clean即可。

項目使用ARC後,編譯Magical Record不通過

點擊項目 -> Build Phases -> Compile Sources中, 雙擊報錯的class文件, 編輯Compiler Flags加入 -fno-objc-arc。

不想使用MR_前綴

只需要在*-Prefix.pch文件中添加一句#define MR_SHORTHAND即可,注意這句要在#import “CoreData+MagicalRecord.h”之前。

參考鏈接:

Magical Record: how to make programming with Core Data pleasant

注:這篇文章中的MagicalRecordHelpers、MRCoreDataAction都已經不在新版本的Magical Record中存在,都已經更改爲MagicalRecord。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章