iOS：OC Lib：MagicalRecord

# MagicalRecord 2.1

## 前言

CoreData是iOS开发中经常使用的数据持久化的技术。但其操作过程稍微繁琐，即使你只是实现简单的存取，不涉及请求优化，也要进行许多配置工作，代码量在动辄几十行，对新手来说也需要较大时间成本。

MagicalRecord是OC的一个库，协助方便CoreData的工作。其吸收了Ruby on Rails的Active Record模式，目标是：

* 简化Core Data相关代码
* 允许清晰，简单，单行获取
* 当需要优化请求的时候，仍然允许修改NSFetchRequest

## 安装

1、在 [github](https://github.com/magicalpanda/MagicalRecord) 上下载MagicalRecord

2、下载完成，将MagicalRecord 文件夹拖到Xcode中，添加进项目。添加CoreData framework。

3、在PCH文件中添加 **CoreData+MagicalRecord.h**

4、**Option：** 如果你在使用MagicalRecord方法的时候不想带**MR_** 前缀，e.g. 直接用**findAll** 代替 **MR_findAll**，就在PCH中在**CoreData+MagicalRecord.h**之前增加 **#defin MR_SHORTHAND** 即可。

## 环境需求

MagicalRecord 需要的环境：

* iOS 5.x 及以上， Mac OS 10.7及以上
* ARC

iOS4，无ARC ，可以使用兼容版本，1.8.3

## 用法

### 创建Model

创建一个Model.xcdatamodeld ，添加一个Person Entity，添加age firstname lastname 三个属性。最后使用*Editor > Create NSManagedObject Subclass* ORM生成Person类。

### 初始化

在AppDelegate中：

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

	- (void)applicationWillTerminate:(NSNotification *)aNotification
	{
	    [MagicalRecord cleanUp];
	}

这样就搞定初始化啦！！

### 增

	Person *person = [Person MR_createEntity];
	person.firstname = @"Frank";
	person.lastname = @"Zhang";
	person.age = @26;
	[[NSManagedObjectContext MR_defaultContext] MR_save];

### 查

	//查找数据库中的所有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 *person = ...;//此处略
	person.lastname = object;
	[[NSManagedObjectContext MR_defaultContext] MR_save];

### 删

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

### more

* [MagicalRecord 官方](http://cocoadocs.org/docsets/MagicalRecord/2.1/)
* [Magical Record入门教程](http://furybean.github.io/blog/2012/08/01/magicalrecord-tutorial/)
* [Using CoreData with MagicalRecord](http://ablfx.com/blog/article/2)
* [Magical Record: how to make programming with Core Data pleasant](http://yannickloriot.com/2012/03/magicalrecord-how-to-make-programming-with-core-data-pleasant/#sthash.aPAOnVdF.dpbs)