3. 运行时类与对象
NSManagedObject
Managed Object 表示数据文件中的一条记录,每一个Managed Object在内存中对应的实体(Entity)的一个数据表示。Managed Object的成员为Entity的Property所描述
每一个 Managed Object 都有一个全局 ID(类型为:NSManagedObjectID)。Managed Object 会附加到一个 Managed Object Context,我们可以通过这个全局 ID 在 Managed Object Context 查询对应的 Managed Object。
-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 绑定,这样就方便我们动态地生成,获取数据对象等。
-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 做了这部分工作。
-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)。
-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 排序返回。
-setEntity: | 设置你要查询的数据对象的类型(Entity) |
-setPredicate: | 设置查询条件 |
-setFetchLimit: | 设置最大查询对象数目 |
-setSortDescriptors: | 设置查询结果的排序方法 |
-setAffectedStores: | 设置可以在哪些数据存储中查询 |