初次接觸 Core Data 時,會發現它其實就是蘋果封裝的一套 ORM 框架。Core Data 負責在 Model 實體與 SQLite 之間建立關聯,其角色有點像 Java 世界裡的 Hibernate:兩者都能透過操作實體來完成資料庫的增刪改查。Core Data 的 managedObjectContext 相當於 Hibernate 的 session,而 save 操作則類似 commit。若你熟悉 PHP 的 ThinkPHP,也能拿它內建的 ORM 來類比。
那麼,UITableView 為什麼會「愛上」Core Data 呢?下面我們以 iOS 開發中經典的通訊錄範例,逐步說明兩者搭配的優勢。
要在 TableView 中顯示通訊錄,傳統做法得自行設計一層層的巢狀資料結構:
tableArray 承載全部內容。sectionDictionary。header 與 items 兩個鍵,前者是分組名稱,後者是該組的使用者清單。items 又是一個陣列,裡面每個元素是存放使用者資訊的字典。這種手動組装的資料結構既繁瑣,又無法持久化。若資料來源格式不固定,轉換起來更是相當棘手。這正是 Core Data 派上用場的地方——它能簡化資料操作,並自動持久化到 SQLite。
新增專案時選擇 Empty Application,別忘了勾選 Use Core Data。勾選後,Xcode 會自動引入 Core Data 框架、在 AppDelegate 中產生相關設定,並建立一個以專案名稱命名的 Data Model 檔。AppDelegate 中主要會多出以下程式碼:
- (NSManagedObjectModel *)managedObjectModel {
if (_managedObjectModel != nil) {
return _managedObjectModel;
}
NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"Demo083101" withExtension:@"momd"];
_managedObjectModel = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
return _managedObjectModel;
}
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
if (_persistentStoreCoordinator != nil) {
return _persistentStoreCoordinator;
}
NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@"Demo083101.sqlite"];
NSError *error = nil;
_persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:[self managedObjectModel]];
if (![_persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:nil error:&error]) {
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
return _persistentStoreCoordinator;
}
接著在 .xcdatamodeld 中建立資料實體模型,再依此生成對應的實體類別(作用近似 JavaBean)。
Empty Application 預設沒有 Storyboard,若想用它簡化操作,需自行建立一個名為 Main 的 Storyboard,並在專案的 Main Interface 中指定它,同時把 AppDelegate 的啟動方法簡化為直接回傳 YES,將初始化工作交給 Storyboard。
透過 NSManagedObjectContext 操作資料。以新增為例,先取得上下文,建立實體物件並賦值,最後呼叫 save 儲存:
- (IBAction)tapAdd:(id)sender {
Person *person = [NSEntityDescription insertNewObjectForEntityForName:NSStringFromClass([Person class]) inManagedObjectContext:self.managedObjectContext];
person.name = self.nameTextField.text;
person.number = self.numberTextField.text;
person.firstN = [NSString stringWithFormat:@"%c", pinyinFirstLetter([person.name characterAtIndex:0])-32];
NSError *error;
if (![self.managedObjectContext save:&error]) {
NSLog(@"%@", [error localizedDescription]);
}
[self.navigationController popToRootViewControllerAnimated:YES];
}
查詢則依靠 NSFetchRequest 搭配排序規則,再由 NSFetchedResultsController(FRC)把結果轉換成適合 TableView 顯示的格式,並自動完成分組:
NSFetchRequest *request = [[NSFetchRequest alloc] initWithEntityName:NSStringFromClass([Person class])];
NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"firstN" ascending:YES];
[request setSortDescriptors:@[sortDescriptor]];
self.fetchedResultsController = [[NSFetchedResultsController alloc] initWithFetchRequest:request managedObjectContext:self.managedObjectContext sectionNameKeyPath:@"firstN" cacheName:nil];
NSError *error;
if ([self.fetchedResultsController performFetch:&error]) {
NSLog(@"%@", [error localizedDescription]);
}
預設情況下,Core Data 資料變動後 TableView 不會自動更新。要解決這點,讓控制器實作 NSFetchedResultsControllerDelegate 協定,並在 viewDidLoad 中設定 self.fetchedResultsController.delegate = self;,再實作各項回呼(如 controllerWillChangeContent:、didChangeObject:、controllerDidChangeContent:)以對應插入、刪除、更新、移動等操作。如此一來,只要資料變動,畫面便會即時反映。
刪除需先開啟 TableView 的編輯功能(canEditRowAtIndexPath: 回傳 YES),並在 commitEditingStyle: 中透過 FRC 取得實體、呼叫上下文的 deleteObject: 後存檔即可。更新則可透過 prepareForSegue: 搭配 KVC 將選取的實體傳入編輯頁。
依據 DRY(Don't Repeat Yourself)原則,可將新增與更新頁合併為同一個編輯頁:當傳入的 person 為空時新增,否則更新。頭像則可透過 UIImagePickerController 從相簿挑選,並以 UIImagePNGRepresentation 轉為二進位存入 Model。列表可實作 sectionIndexTitlesForTableView: 加上右側索引,並用 cell.imageView.image 顯示頭像。
通訊錄資料一多,搜尋就顯得必要。透過 UISearchDisplayController,在 searchBar:textDidChange: 中加入 NSPredicate 謂詞進行模糊查詢,並重建 FRC;取消搜尋時重新載入原始列表即可。由於搜尋結果使用獨立的 TableView,於 cellForRowAtIndexPath: 中需依 TableView 來源選擇不同的 Cell 樣板。
至此,TableView 與 Core Data 的搭配可謂得心應手——雖然初期配置略顯繁瑣,但只要按部就班,就能打造出一個具備增刪改查、頭像、索引與搜尋的完整通訊錄。