[转载][类 NSFetchedResultsController]

原文地址：[类 NSFetchedResultsController]作者：NiB官方

引子：NSFetchedResultsController和UITableView集成起来处理数据具有强大的灵活性。首先得到的好处是不需要将数据记录进行分页，不然，按照传统的做法，需要先查询出总的记录，然后再从纪录里面过滤，这样会进行两次操作，对内存消耗很大，处理不好，程序甚至可能崩溃。使用NSFetchedResultsController类不仅简单，还具有更高的性能，这个类自动帮助你记录分页的事情，得到表对应的Core Data对象也非常简单。

更重要的是，你在其他界面更新或者删除记录时，NSFetchedResultsController可以帮助你同步更新UITableView，你的UITableView和数据库同步将变得非常简单。
NSFetchedResultsController[/b]

继承自	NSObject
遵循	NSObject (NSObject)
框架	/System/Library/Frameworks/CoreData.framework
可用性	Available in iOS 3.0 and later.
指南[/b]	Core Data Programming Guide
定义于[/b]	NSFetchedResultsController.h
相关代码[/b]	CoreDataBooks DateSectionTitles iPhoneCoreDataRecipes TopSongs

当你从Core Data 取出数据，然后以表格视图的形式展现数据的时候，fetched results控制器很有用。它是连接Core Data和表格视图的桥梁，首选的一种控制器。


(图一)

我们知道表格视图有很多种形式, fetched results 控制器主要针对列表视图(如图1)，这种视图是由很多section组成的，每个section又包含了很多row。你只需配置：entity是什么，如何排序（必须配置），预筛选项（可选）。NSFetchedResultsController就会自动帮你处理好每个section都应该显示哪些数据。

另外，NSFecthedResultsController还提供以下特性：

监控managed object context对象的改变，报告给delegate（可选）.

缓冲数据，让性能有所提升，专门针对需要频繁显示的数据 （可选）。

总结一下，fetched results 控制器 提供下面3种模式：
1． 不追踪模式：delegate设为nil.
只提供基本的查询数据访问数据的能力。
2． 内存追踪模式：delegate有值，file cache name设为nil.
controller负责监控结果集中的数据改变，针对改变调整排序。
3. 完全追踪模式：delegate和file cache name都有值
controller负责监控结果集中的数据改变，针对改变调整排序。还能把计算的结果存入缓存。

重要：作为这个类的delegate,至少要实现一个追踪方法：controllerDidChangeController。哪怕这个方法你什么也不写为空，也要实现这个方法。

使用[/b]NSFetchedResultsController[/b]控制器[/b]

创建控制器[/b]
一般来说，你会创建一个NSFetchedResultsController实例作为table view的成员变量。初始化的时候，你提供四个参数：
1。 一个fetch request.必须包含一个sort descriptor用来给结果集排序。
2。 一个managed object context。 控制器用这个context来执行取数据的请求。
3。 一个可选的key path作为section name。控制器用key path来把结果集拆分成各个section。（传nil代表只有一个section）
4。 一个cache file的名字，用来缓冲数据，生成section和索引信息。

当你实例都创建好之后，调用performFetch: 来执行查询。

NSManagedObjectContext *context = <#Managed object context#>;

NSFetchRequest *fetchRequest = [[NSFetchRequest alloc] init];

// Configure the request's entity, and optionally its predicate.[/i]

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"<#Sort key#>" ascending:YES];

NSArray *sortDescriptors = [[NSArray alloc] initWithObjects:sortDescriptor, nil];

[fetchRequest setSortDescriptors:sortDescriptors];

[sortDescriptors release];

[sortDescriptor release];

NSFetchedResultsController *controller = [[NSFetchedResultsController alloc]

initWithFetchRequest:fetchRequest

managedObjectContext:context

sectionNameKeyPath:nil

cacheName:@"<#Cache name#>"];

[fetchRequest release];

NSError *error;

BOOL success = [controller performFetch:&error];

重要：你不可以用一个fetched results controller来执行几个查询，如果你非要这么做，那用deleteCacheWithName:把cache file先删除，不然会冲突.

控制器的代理[/b]

如果你为fetched results控制器设置了代理，代理会收到从它的managed object context中传来改变通知。delegate会处理context中任何会影响结果集或者section的变化，results也做相应的更新。控制器会告诉delegate结果集改变了什么或者section变化了哪些。你只要覆写几个方法来更新table view就行。

缓存[/b]

如果有必要，控制器会使用缓存来避免重复地构造section或者把section中的内容进行排序的工作。可以说，你程序一运行，这个缓存也跟着建立好了。

当你初始化一个NSFetchedResultsController实例的时候，你一般会确定好文件的名字。（如果你不定义名字，那控制器就不使用缓存）当你创建一个控制器，它会寻找一个已存在的缓存：

如果控制器找不到合适的缓存，它就计算section以及其内容的显示顺序。把结果信息写入硬盘。

如果它能找到一个同名缓存，会先检查缓存中的数据是否合法。控制器会参照当前entity的名字，entity版本信息，排序，缓存文件更改时间来判断这个缓存是否可用。

如果缓存和当前信息相兼容，控制器会复用之前存储的计算结果。
如果缓存和当前信息不兼容，控制器重新计算然后更新缓存。

一旦section和排序的信息改变了，那缓存一定会跟着改变。
所以你如果有多个fetched result控制器，配置得都不一样，那你最好用不用得缓存名字。

函数 deleteCacheWithName:可以直接删除一个缓存文件

实现table view datasource方法

你可以让控制器提供相应的信息，然后实现你datasource方法。

(NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {

return [[<#Fetched results controller#> sections] count];

}

- (NSInteger)tableView:(UITableView *)table numberOfRowsInSection:(NSInteger)section {

id <NSFetchedResultsSectionInfo> sectionInfo = [[<#Fetched results controller#> sections] objectAtIndex:section];

return [sectionInfo numberOfObjects];

}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

UITableViewCell *cell = <#Get the cell#>;

NSManagedObject *managedObject = [<#Fetched results controller#> objectAtIndexPath:indexPath];

// Configure the cell with data from the managed object.[/i]

return cell;

}

- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {

id <NSFetchedResultsSectionInfo> sectionInfo = [[<#Fetched results controller#> sections] objectAtIndex:section];

return [sectionInfo name];

}

- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView {

return [<#Fetched results controller#> sectionIndexTitles];

}

- (NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index{

return [<#Fetched results controller#> sectionForSectionIndexTitle:title atIndex:index];

}

响应变化[/b]

基本上，NSFetchedResultsController设计之初就是为了应对模型层的变化，负责告知其delegate结果变化了或者section的改变了。

如果你允许一个用户重新对表格进行排序，那你实现的delegate方法就必须把这个也考虑进来。

其实， managed object context收到processPendingChanges消息的时候，所作的变化才有所反应。因此，如果你对一个managed object的属性进行了更改，存储位置变化了，控制器的结果会跟着改变。但当前事件周期结束，记录的索引才跟着变化（processPendingChanges函数被调用）。比如，下面这段代码 就应该输出“same”:

NSFetchedResultsController *frc = <#A fetched results controller#>;

NSManagedObject *managedObject = <#A managed object in frc's fetchedObjects array#>;

NSIndexPath *beforeIndexPath = [frc indexPathForObject:managedObject];

[managedObject setSortKeyAttribute:

<#A new value that changes managedObject's position in frc's fetchedObjects array#>;

NSIndexPath *afterIndexPath = [frc indexPathForObject:managedObject];

if ([beforeIndexPath compare:afterIndexPath] == NSOrderedSame) {

NSLog(@"same");

}

改变查询请求[/b]

你不能只是简单地改变fetch request来试图改变查询结果，如果你想看到变化，你应该：
1。如果你用cache，删掉它（用deleteCacheWithName:函数）
不过一般来说，查询请求都改变了，你不太可能会用一个cache.
2。改变fetch request.
3。调用 performFetch:函数

对象的检查[/b]

如果一个managed object context 告诉fetched result 控制器 一个单独的对象是无效的，那控制器就认为这样地对象已经被删除了，并且发送适当的delegate消息。

有的时候可能所有的对象都是无效的（比如，当我们调用reset函数或者一个存储从持久化存储管理器中被删除的时候）NSFetchResultsController不会一个个对象去检验，也不会发送删除对象的通知。而是，你必须调用performFetch:去重置管理器并且重载table view当中的数据（reloadData）。

iOS[/b] 版本的问题[/b]

iOS 4.0以后，即使你重用一个cache,那管理器也不会报错，只是显示出错误的数据而已（这样可以削减程序启动时复杂的字符串比较，提高效率）。所以注意不要重复使用！

子类需要注意[/b]

如果你想自定义section的创建，索引的标题，那你可能会子类这个控制器。你可以覆写sectionIndexTitleForSectionName:方法。
如果你想section的名字不是大写字母开头，而是其他的，你可以覆写sectionIndexTitles。
如果你想索引的名字是其他的内容，为每个已知section覆写sectionIndexTitleForSectionName:。