iOS：OC Lib：MagicalRecord

# MagicalRecord 2.1

## 前言

CoreData是iOS開發中常常使用的數據持久化的技術。但其操做過程稍微繁瑣，即便你只是實現簡單的存取，不涉及請求優化，也要進行許多配置工做，代碼量在動輒幾十行，對新手來講也須要較大時間成本。

MagicalRecord是OC的一個庫，協助方便CoreData的工做。其吸取了Ruby on Rails的Active Record模式，目標是：

* 簡化Core Data相關代碼
* 容許清晰，簡單，單行獲取
* 當須要優化請求的時候，仍然容許修改NSFetchRequest

## 安裝

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

二、下載完成，將MagicalRecord 文件夾拖到Xcode中，添加進項目。添加CoreData framework。

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

四、**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)