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)

posted on 2013-09-18 12:00  老Zhan  阅读(5233)  评论(3编辑  收藏  举报