[Cocoa]深刻浅出 Cocoa 之 Core Data（1）- 框架详解

深刻浅出 Cocoa 之 Core Data（1）- 框架详解

罗朝辉( http://blog.csdn.net/kesalin)

CC 许可，转载请注明出处

Core data 是 Cocoa 中处理数据，绑定数据的关键特性，其重要性不言而喻，但也比较复杂。Core Data 相关的类比较多，初学者每每不太容易弄懂。计划用三个教程来说解这一部分：

框架详解：讲解  Core data 框架，运做过程，设计的类；
Core data应用程序示例：经过生成一个使用 Core data 的应用程序来说解如何 在  XCode 4 中使用 Core data。
手动建立Core data示例：不利用框架自动生成代码，彻底本身编写全部的 Core data 相关代码的命令行应用程序来深刻讲解 Core data的使用。

本文为第一部份：框架详解

一，概观
下面先给出一张类关系图，让咱们对它有个整体的认识。

在上图中，咱们能够看到有五个相关模块：
1， Managed Object Model
Managed Object Model 是描述应用程序的数据模型，这个模型包含实体（Entity），特性（Property），读取请求（Fetch Request）等。（下文都使用英文术语。）

2，Managed Object Context
Managed Object Context 参与对数据对象进行各类操做的全过程，并监测数据对象的变化，以提供对 undo/redo 的支持及更新绑定到数据的 UI。

3，Persistent Store Coordinator
Persistent Store Coordinator 至关于数据文件管理器，处理底层的对数据文件的读取与写入。通常咱们无需与它打交道。

4，Managed Object
Managed Object 数据对象，与 Managed Object Context 相关联。

5，Controller
图中绿色的 Array Controller, Object Controller, Tree Controller 这些控制器，通常都是经过 control+drag 将 Managed Object Context 绑定到它们，这样咱们就能够在 nib 中可视化地操做数据。

这写模块是怎样运做的呢？

1，应用程序先建立或读取模型文件（后缀为xcdatamodeld）生成 NSManagedObjectModel 对象。Document应用程序是通常是经过 NSDocument 或其子类 NSPersistentDocument）从模型文件（后缀为 xcdatamodeld）读取。
2，而后生成 NSManagedObjectContext 和 NSPersistentStoreCoordinator 对象，前者对用户透明地调用后者对数据文件进行读写。
3，NSPersistentStoreCoordinator 负责从数据文件(xml, sqlite,二进制文件等)中读取数据生成 Managed Object，或保存 Managed Object 写入数据文件。
4，NSManagedObjectContext 参与对数据进行各类操做的整个过程，它持有 Managed Object。咱们经过它来监测 Managed Object。监测数据对象有两个做用：支持 undo/redo 以及数据绑定。这个类是最常被用到的。
5，Array Controller, Object Controller, Tree Controller 这些控制器通常与 NSManagedObjectContext 关联，所以咱们能够经过它们在 nib 中可视化地操做数据对象。

二， Model class

模型有点像数据库的表结构，里面包含 Entry， 实体又包含三种 Property：Attribute（属性），RelationShip（关系）， Fetched Property（读取属性）。Model class 的名字多以 "Description" 结尾。咱们能够看出：模型就是描述数据类型以及其关系的。

主要的 Model class 有：

 

Model Classes

Managed Object Model	NSManagedObjectModel	数据模型
Entity	NSEntityDescription	抽象数据类型，至关于数据库中的表
Property	NSPropertyDescription	Entity 特性，至关于数据库表中的一列
> Attribute	NSAttributeDescription	基本数值型属性（如Int16, BOOL, Date等类型的属性）
> Relationship	NSRelationshipDescription	属性之间的关系
> Fetched Property	NSFetchedPropertyDescription	查询属性（至关于数据库中的查询语句）

 

1）Entity - NSEntityDescription
Entity 至关于数据库中的一个表，它描述一种抽象数据类型，其对应的类为 NSManagedObject 或其子类。

NSEntityDescription 经常使用方法:
+insertNewObjectForEntityForName:inManagedObjectContext: 工厂方法，根据给定的 Entity 描述，生成相应的 NSManagedObject 对象，并插入 ManagedObjectContext 中。
-managedObjectClassName返回映射到 Entity 的 NSManagedObject 类名
-attributesByName以名字为 key， 返回 Entity 中对应的 Attributes
-relationshipsByName以名字为 key， 返回 Entity 中对应的 Relationships

2）Property - NSPropertyDescription
Property 为 Entity 的特性，它至关于数据库表中的一列，或者 XML 文件中的 value-key 对中的 key。它能够描述实体数据(Attribute)，Entity之间的关系(RelationShip)，或查询属性(Fetched Property)。

 > Attribute - NSAttributeDescription
Attribute 存储基本数据，如 NSString, NSNumber or NSDate 等。它能够有默认值，也可使用正则表达式或其余条件对其值进行限定。一个属性能够是 optional 的。
 
 > Relationship - NSRelationshipDescription 
Relationship 描述 Entity，Property 之间的关系，能够是一对一，也能够是一对多的关系。 

 > Fetched Property - NSFetchedPropertyDescription
Fetched Property 根据查询谓词返回指定 Entity 的符合条件的数据对象。

上面说的比较抽象，举个例子来讲，见图：

 

咱们有一个 CocoaDataDemo.xcdatamodeld 模型文件，应用程序根据它生成一个 NSManagedObjectModel 对象，这个模型有三个 Entity，每一个 Entity 又可包含 Attribute Relationship, Feteched Property 三种类型的 Property。在本例中， Author Entity 包含两个Attribute : name 和 email，它们对于的运行时类均为 NSManagedObject；还包含一个与 Post 的 Relationship；没有设置  Feteched Property。

咱们一般使用 KVC 机制来访问 Property。下面来看代码：

 

NSManagedObjectContext * context = [[NSApp delegate] managedObjectContext];
NSManagedObject        * author  = nil;

author = [NSEntityDescription insertNewObjectForEntityForName: @"Author" inManagedObjectContext: context];
[author setValue: @"nemo@pixar.com" forKey: @"email"];

NSLog (@"The Author's email is: %@", [author valueForKey:@"email"]);

在上面代码中，咱们先取得 NSManagedObjectContext， 而后调用 NSEntityDescription 的方法，以 Author 为实体模型，生成对应的 NSManagedObject 对象，插入 NSManagedObjectContext 中，而后给这个对象设置特性 email 的值。

三，运行时类与对象
> Managed Object - NSManagedObject
Managed Object 表示数据文件中的一条记录，每个 Managed Object 在内存中对应 Entity 的一个数据表示。Managed Object 的成员为 Entity 的 Property 所描述。
好比在上面的代码，author 这个 NSManagedObject，对应名为 Author 的 Entity。

每个 Managed Object 都有一个全局 ID（类型为：NSManagedObjectID）。Managed Object 会附加到一个 Managed Object Context，咱们能够经过这个全局 ID 在 Managed Object Context 查询对应的 Managed Object。

 

NSManagedObject 经常使用方法

-entity	获取其 Entity
-objectID	获取其 Managed Object ID
-valueForKey:	获取指定 Property 的值
-setValue: forKey:	设定指定 Property 的值

 

 

> Managed Object Context - NSManagedObjectContext
Managed Object Context 的做用至关重要，对数据对象进行的操做都与它有关。当建立一个数据对象并插入 Managed Object Context 中，Managed Object Context 就开始跟踪这个数据对象的一切变更，并在合适的时候提供对 undo/redo 的支持，或调用 Persistent Store Coordinato 将变化保存到数据文件中去。

一般咱们将 controller 类（如：NSArrayController，NSTreeController）或其子类与 Managed Object Context 绑定，这样就方便咱们动态地生成，获取数据对象等。

 

NSManagedObjectContext 经常使用方法

-save:	将数据对象保存到数据文件
-objectWithID:	查询指定 Managed Object ID 的数据对象
-deleteObject:	将一个数据对象标记为删除，可是要等到 Context 提交更改时才真正删除数据对象
-undo	回滚最后一步操做，这是都 undo/redo 的支持
-lock	加锁，经常使用于多线程以及建立事务。同类接口还有：-unlock and -tryLock
-rollback	还原数据文件内容
-reset	清除缓存的 Managed Objects。只应当在添加或删除 Persistent Stores 时使用
-undoManager	返回当前 Context 所使用的 NSUndoManager
-assignObject: toPersistantStore:	因为 Context 能够管理从不一样数据文件而来的数据对象， 这个接口的做用就是指定数据对象的存储数据文件（经过指定 PersistantStore 实现）
-executeFetchRequest: error:	执行 Fetch Request 并返回全部匹配的数据对象

 

 

> Persistent Store Coordinator - NSPersistentStoreCoordinator
使用 Core Data document 类型的应用程序，一般会从磁盘上的数据文中中读取或存储数据，这写底层的读写就由 Persistent Store Coordinator 来处理。通常咱们无需与它直接打交道来读写文件，Managed Object Context 在背后已经为咱们调用 Persistent Store Coordinator 作了这部分工做。

 

NSPersistentStoreCoordinator 经常使用方法

-addPersistentStoreForURL:configuration:URL:options:error:	装载数据存储，对应的卸载数据存储的接口为 -removePersistentStore:error:
-migratePersistentStore:toURL:options:withType:error:	迁移数据存储，效果与 "save as"类似，可是操做成功后， 迁移前的数据存储不可再使用
-managedObjectIDForURIRepresentation:	返回给定 URL所指示的数据存储的 object id，若是找不到匹配的数据存储则返回 nil
-persistentStoreForURL:	返回指定路径的 Persistent Store
-URLForPersistentStore:	返回指定 Persistent Store 的存储路径

 

 

> Persistent Document - NSPersistentDocument
NSPersistentDocument 是 NSDocument 的子类。 multi-document Core Data 应用程序使用它来简化对 Core Data 的操做。一般使用 NSPersistentDocument 的默认实现就足够了，它从 Info.plist 中读取 Document types 信息来决定数据的存储格式（xml,sqlite, binary）。

 

NSPersistentDocument 经常使用方法

-managedObjectContext	返回文档的 Managed Object Context，在多文档应用程序中，每一个文档都有本身的 Context。
-managedObjectModel	返回文档的 Managed Object Model

 

 

四，Fetch Requests
Fetch Requests 至关于一个查询语句，你必须指定要查询的 Entity。咱们经过 Fetch Requests 向 Managed Object Context 查询符合条件的数据对象，以 NSArray 形式返回查询结果，若是咱们没有设置任何查询条件，则返回该 Entity 的全部数据对象。咱们可使用谓词来设置查询条件，一般会将经常使用的 Fetch Requests 保存到 dictionary 以重复利用。

示例：

 

NSManagedObjectContext * context  = [[NSApp delegate] managedObjectContext];
NSManagedObjectModel   * model    = [[NSApp delegate] managedObjectModel];
NSDictionary           * entities = [model entitiesByName];
NSEntityDescription    * entity   = [entities valueForKey:@"Post"];

NSPredicate * predicate;
predicate = [NSPredicate predicateWithFormat:@"creationDate > %@", date];

NSSortDescriptor * sort = [[NSortDescriptor alloc] initWithKey:@"title"];
NSArray * sortDescriptors = [NSArray arrayWithObject: sort];

NSFetchRequest * fetch = [[NSFetchRequest alloc] init];
[fetch setEntity: entity];
[fetch setPredicate: predicate];
[fetch setSortDescriptors: sortDescriptors];

NSArray * results = [context executeFetchRequest:fetch error:nil];
[sort release];
[fetch release];

在上面代码中，咱们查询在指定日期以后建立的 post，并将查询结果按照 title 排序返回。

 

 

NSFetchRequest 经常使用方法

-setEntity:	设置你要查询的数据对象的类型（Entity）
-setPredicate:	设置查询条件
-setFetchLimit:	设置最大查询对象数目
-setSortDescriptors:	设置查询结果的排序方法
-setAffectedStores:	设置能够在哪些数据存储中查询

 

 

参考资料：
Core Data ReferenceAPI listing for the Core Data classes
http://developer.apple.com/documentation/Cocoa/Reference/CoreData_ObjC/index.html

NSPredicate ReferenceAPI listing for NSPredicate
http://developer.apple.com/documentation/Cocoa/Reference/Foundation/ObjC_classic/Classes/NSPredicate.html