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。