我们知道 CoreData 里存储的是具有相同结构的一系列数据的集合，TableView 正好是用列表来展示一系列具有相同结构的数据集合的。所以，要是 CoreData 和 TableView 能结合起来，CoreData 查询出来的数据能同步地显示在 TableView 上，更好一点就是 CoreData 里的改动也能同步到 TableView 上，那就再好不过了。可喜的是，确实有这样一个 API，那就是 NSFetchedResultsController，相信不少人对这个东西都不陌生，因为用 Xcode 创建带有 CoreData 的 Master-Detail 模板工程时，就是用这个接口来实现的。这篇文章也主要是围绕着模板工程中的代码进行介绍，如果你对这块比较熟悉的话，不妨直接去看模板里的代码；如果你是第一次听说这个 API，不妨继续看下去，相信会对你有帮助的。
创建一个简单的 TableView 布局
在使用 CoreData 之前，首先我们来创建一个简单的 TableView 布局，对大多数人来说，这应该没什么难度，所以下面就直接贴代码，不会对代码进行解释了。
这里我们用 Storyboard 创建一个 TableViewController，首先配置 tableView 的 dataSource
- (void)viewDidLoad {
[super viewDidLoad];
// 添加编辑和插入按钮
self.navigationItem.leftBarButtonItem = self.editButtonItem;
self.navigationItem.rightBarButtonItem = [self addBarButtonItem];
}
#pragma mark - Table view data source
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return 100;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:kCellIdentifier forIndexPath:indexPath];
[self configureCell:cell atIndexPath:indexPath];
return cell;
}
- (BOOL)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath {
return YES;
}
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
// deletions
}
}这是一个非常简单的 TableView，现在只能显示一些随机生成的数据。接下来我们来实现 NSFetchedResultsController 来和 CoreData 中的数据对接，CoreData 相关的代码，就直接用之前文章里创建的 Student 实体。如果有不了解的朋友，可以先去看一下这篇文章 CoreData 从入门到精通 （一） 数据模型 + CoreData 栈的创建。
初始化 NSFetchedResultsController
先来看一下 NSFetchedResultsController 的初始化代码：
#pragma mark - NSFetchedResultsController
- (NSFetchedResultsController<Student *> *)fetchedResultsController {
if (!_fetchedResultsController) {
NSFetchRequest *fetchRequest = [Student fetchRequest];
fetchRequest.sortDescriptors = @[[NSSortDescriptor sortDescriptorWithKey:@"studentId" ascending:YES]];
fetchRequest.fetchBatchSize = 50;
fetchRequest.fetchLimit = 200;
NSFetchedResultsController *fetchController = [[NSFetchedResultsController alloc] initWithFetchRequest:fetchRequest managedObjectContext:self.context sectionNameKeyPath:@"studentAge" cacheName:@"StudentTable"];
fetchController.delegate = self;
NSError *error;
[fetchController performFetch:&error];
[[[Logger alloc] init] dealWithError:error whenFail:@"fetch failed" whenSuccess:@"fetch success"];
_fetchedResultsController = fetchController;
}
return _fetchedResultsController;
}创建 fetchedResultsController 需要指定一个 fetchRequest，这很好理解，因为 fetchedResultsController 也需要查询 CoreData 数据库里的数据，需要注意的是，指定的这个 fetchRequest 必须要设置 sortDescriptors 也就是排序规则这个属性，不设置直接运行的话，程序是会直接崩溃的,这是因为 fetchedResultsController 需要根据这个排序规则来规定数据该以什么顺序显示到 tableView 上，而且这个 fetchRequest 指定之后就不可以再修改了；
context 就是上下文的对象；sectionNameKeyPath 可以指定一个 keypath 来为 tableView 生成不同的 section，指定成 nil 的话，就只生成一个 section；
cacheName 用来指定一个缓存的名字，加载好的数据会缓存到这样一个私有的文件夹里，这样可以避免过多的从 CoreData 数据库里查询以及计算的操作。
除此之外，fetchLimit 和 fetchBatchSize 这两个属性也需要注意一下，fetchLimit 之前讲过是指定获取数据的上限数量，而 fetchBatchSize 是分批查询的数据量大小。因为一次性查询出过多的数据会消耗不少的内存，所以这里推荐给这两个属性设置一个合理的值；指定的泛型 Student 就是 fetchRequest 查询的数据类型。这些都配置之后调用 performFetch: 方法就可以执行查询操作了。返回的数据保存在 fetchedResultsController 的 fetchedObjects 属性里，不过我们一般不会直接用到它。
fetchedResultsController 绑定到 TableView
下面来修改 tableView 的 dataSource 的方法将查询出来的数据集合和 TableView 绑定。
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
// sections 是一个 NSFetchedResultsSectionInfo 协议类型的数组，保存着所有 section 的信息
return self.fetchedResultsController.sections.count;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
// sectionInfo 里的 numberOfObjects 属性表示对应 section 里的结果数量
id<NSFetchedResultsSectionInfo> sectionInfo = self.fetchedResultsController.sections[section];
return sectionInfo.numberOfObjects;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:kCellIdentifier forIndexPath:indexPath];
// 通过这个方法可以直接获取到对应 indexPath 的实体类对象
Student *student = [self.fetchedResultsController objectAtIndexPath:indexPath];
[self configureCell:cell withStudent:student];
return cell;
}
// 修改后的configureCell 方法
- (void)configureCell:(UITableViewCell *)cell withStudent:(Student *)student {
cell.textLabel.text = [NSString stringWithFormat:@"%d:%@ age:%d", student.studentId, student.studentName, student.studentAge];
}实现增删改查的同步更新
上一步里我们实现了把 fetchedResultsController 里的数据绑定到 TableView 上，但还没完成同步更新的实现，例如 CoreData 数据库里新插入了数据，TableView 这时也可以自动更新。实现这个功能，只需要实现 fetchedResultsController 的 delegate 就可以了。
NSFetchedResultsControllerDelegate 里有一个 NSFetchedResultsChangeType 枚举类型，其中的四个成员分别对应 CoreData 里的增删改查：
typedef NS_ENUM(NSUInteger, NSFetchedResultsChangeType) {
NSFetchedResultsChangeInsert = 1,
NSFetchedResultsChangeDelete = 2,
NSFetchedResultsChangeMove = 3,
NSFetchedResultsChangeUpdate = 4
}delegate 里共有五个协议方法：
// 对应 indexPath 的数据发生变化时会回调这个方法
@optional
- (void)controller:(NSFetchedResultsController *)controller didChangeObject:(id)anObject atIndexPath:(nullable NSIndexPath *)indexPath forChangeType:(NSFetchedResultsChangeType)type newIndexPath:(nullable NSIndexPath *)newIndexPath;
// section 发生变化时会回调这个方法
@optional
- (void)controller:(NSFetchedResultsController *)controller didChangeSection:(id <NSFetchedResultsSectionInfo>)sectionInfo atIndex:(NSUInteger)sectionIndex forChangeType:(NSFetchedResultsChangeType)type;
// 数据内容将要发生变化时会回调
@optional
- (void)controllerWillChangeContent:(NSFetchedResultsController *)controller;
// 数据内容发生变化之后会回调
@optional
- (void)controllerDidChangeContent:(NSFetchedResultsController *)controller;
// 返回对应 section 的标题
@optional
- (nullable NSString *)controller:(NSFetchedResultsController *)controller sectionIndexTitleForSectionName:(NSString *)sectionName；
@end想要实现 tableView 的数据同步更新可以按下面的代码来实现这几个 delegate 方法：
#pragma mark - NSFetchedResultsControllerDelegate
- (void)controllerWillChangeContent:(NSFetchedResultsController *)controller {
// 在这里调用 beginUpdates 通知 tableView 开始更新，注意要和 endUpdates 联用
[self.tableView beginUpdates];
}
- (void)controller:(NSFetchedResultsController *)controller didChangeObject:(id)anObject atIndexPath:(NSIndexPath *)indexPath forChangeType:(NSFetchedResultsChangeType)type newIndexPath:(NSIndexPath *)newIndexPath {
// beginUpdates 之后，这个方法会调用，根据不同类型，来对tableView进行操作，注意什么时候该用 indexPath，什么时候用 newIndexPath.
switch (type) {
case NSFetchedResultsChangeInsert:
[self.tableView insertRowsAtIndexPaths:@[newIndexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
case NSFetchedResultsChangeMove:
[self.tableView moveRowAtIndexPath:indexPath toIndexPath:newIndexPath];
break;
case NSFetchedResultsChangeUpdate:
[self configureCell:[self.tableView cellForRowAtIndexPath:indexPath] withStudent:anObject];
break;
case NSFetchedResultsChangeDelete:
[self.tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
}
}
- (void)controllerDidChangeContent:(NSFetchedResultsController *)controller {
// 更新完后会回调这里，调用 tableView 的 endUpdates.
[self.tableView endUpdates];
}最后来实现一开始添加的编辑和插入按钮的操作：
- (UIBarButtonItem *)addBarButtonItem {
UIBarButtonItem *addBarButtonItem = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemAdd target:self action:@selector(addRandomStudent)];
return addBarButtonItem;
}
// 为了看到插入效果，可以把 fetchedResultsController 的fetchLimit 和 fetchBatchSize 调小一些.
- (void)addRandomStudent {
NSString *name = [NSString stringWithFormat:@"student-%u", arc4random_uniform(100000)];
int16_t age = (int16_t)arc4random_uniform(10) + 10;
int16_t stuId = (int16_t)arc4random_uniform(INT16_MAX);
Student *student = [NSEntityDescription insertNewObjectForEntityForName:@"Student" inManagedObjectContext:self.context];
student.studentName = name;
student.studentAge = age;
student.studentId = stuId;
[self.context save:nil];
}
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
Student *student = [self.fetchedResultsController objectAtIndexPath:indexPath];
[self.context deleteObject:student];
[self.context save:nil];
}
}到此为止 NSFetchedResultsController 的使用就讲完了，有了它 CoreData 和 TableView的结合是不是很方便呢。