Magical Record入门

Magical Record是什么

在Cocoa中存在一种技术叫Core Data，用来对数据进行持久化，类似于Java世界中的Hibernate。在新建CocoaApplication/iOS Application的向导中，有一个选项是要不要使用CoreData，当启用以后你会发现在AppDelegate.m中添加了大量与CoreData相关的代码，但是你对大部分代码不知所以然。

Magical Record的出现在一定程度上缓解了这个问题，降低了Core Data的使用门槛。

Magical Record借用了Ruby on Rails中的ActiveRecord模式，使得你可以非常容易的添加、查找、删除数据。Google了一下，没有发现中文相关教程，遂把自己的试用过程记录下来，写成此篇文章。

安装

1. 新建一个项目，注意在向导中不要勾选CoreData。
2. 下载MagicalRecord，并把MagicalRecord目录拖拽到工程中，记得勾选copy items into groupfolder。
3. 为项目添加CoreData FrameWork。(点击工程根节点，然后依次Targets > Build Phases >Link Binary With Libraries > + > CoreData.framework >Add)。
4. 添加Magical Record的头文件到*-Prefix.pch：

    

   1. #import "CoreData+MagicalRecord.h"

创建模型文件

下面创建一个名为Person的模型，有age、firstname、lastname三个字段。

1. 创建一个名为Model的模型文件。 (File > New File… > Core Data > DataModel)
2. 点击左下角的Add Entity，更改Entity的名字为Person。
3. 为Entity添加三个Attribute：age(Integer16)、firstname(string)、lastname(string)。
4. 点击Editor > Create NSManagedObject Subclass… >Create创建模型文件对应的类。

使用MagicalRecord

初始化MagicalRecord

首先在AppDelegate.m中添加以下代码对Magical Record进行初始化：

1. - (void)applicationDidFinishLaunching:(NSNotification*)aNotification
2. {
3. [MagicalRecordsetupCoreDataStackWithStoreNamed:@"MyDatabase.sqlite"];
4. // ...
5. return YES;
6. }
7. - (void)applicationWillTerminate:(NSNotification*)aNotification
8. {
9. [MagicalRecordcleanUp];
10. }

是否比Core Data默认的初始化简洁多了呢？

查询记录

使用Person的MR_findAll、MR_findAllSortedBy、MR_findByAttribute等方法可以查询Person：

1. //查找数据库中的所有Person。
2. NSArray *persons= [PersonMR_findAll];
3. //查找所有的Person并按照first name排序。
4. NSArray *personsSorted= [PersonMR_findAllSortedBy:@"firstname"ascending:YES];
5. //查找所有age属性为25的Person记录。
6. NSArray *personsAgeEuqals25= [PersonMR_findByAttribute:@"age"withValue:[NSNumbernumberWithInt:25]];
7. //查找数据库中的第一条记录
8. Person *person= [PersonMR_findFirst];

添加记录

使用Person的MR_createEntity方法可以方便的创建一个Person，需要使用[[NSManagedObjectContextMR_defaultContext] MR_save]来进行保存哦：

1. Person *person= [PersonMR_createEntity];
2. person.firstname= @"Frank";
3. person.lastname= @"Zhang";
4. person.age= @26;//此处使用了LLVM的新特性，XCode4.4可用
5. [[NSManagedObjectContextMR_defaultContext]MR_save];

更新记录

直接对数据库中查找到的Person进行赋值，然后使用NSManagedObjectContext保存即可更新Person：

1. Person *person= ...;//此处略
2. person.lastname= object;
3. [[NSManagedObjectContextMR_defaultContext]MR_save];

删除记录

使用Person的MR_deleteEntity可以方便的删除Person，模式和添加更新一致：

1. Person *person= ...;//此处略
2. [personMR_deleteEntity];
3. [[NSManagedObjectContextMR_defaultContext]MR_save];

小技巧

启动时MR_mergedObjectModelFromMainBundle方法报错

Core Data的模型有版本的概念，有可能在你Magical Record第一次初始化完成以后，你又更改了模型文件，导致CoreData去合并模型报错。解决办法很简单，点击菜单中的Project->Clean即可。

项目使用ARC后，编译MagicalRecord不通过

点击项目 -> Build Phases -> Compile Sources中, 双击报错的class文件,编辑Compiler Flags加入 -fno-objc-arc。

不想使用MR_前缀

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