本篇文章要談的是 Core Data 的基本概念,以及一個可以完整跑起來的實作範例。如果你剛接觸 iOS 開發,正在尋找一套不必寫 SQL 就能搞定資料持久化的方案,那 Core Data 值得你花時間弄懂。
Apple 官方的定義是:Core Data is a schema-driven object graph management and persistence framework. 翻成中文,就是「一個由綱要(schema)驅動的物件圖管理與持久化框架」。這句話字面上不太好懂,我們換個角度,先釐清幾個常見誤解。
要特別注意的是,Core Data 並不是單一個類別,而是一群需要彼此協作的類別所組成的生態系,整體架構其實相當複雜。
接下來我們直接動手做一個小範例,示範如何新增與查詢資料。
Novel 的實體。- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
return YES;
}
NovelListViewController,父類別選 UITableViewController;在 Storyboard 中把 Table View 的 Class 設為它。NovelDetailsViewController,並在裡面建立對應的 outlet 與 action:#import <UIKit/UIKit.h> @interface NovelDetailsViewController : UIViewController @property (strong, nonatomic) IBOutlet UITextField *tfName; @property (strong, nonatomic) IBOutlet UITextField *tfAuthor; @property (strong, nonatomic) IBOutlet UITextField *tfVersion; - (IBAction)cancel:(id)sender; - (IBAction)save:(id)sender; @end
先取得 AppDelegate 已經幫我們建立好的 Managed Object Context:
- (NSManagedObjectContext *)managedObjectContext {
NSManagedObjectContext *context = nil;
id delegate = [[UIApplication sharedApplication] delegate];
if ([delegate performSelector:@selector(managedObjectContext)]) {
context = [delegate managedObjectContext];
}
return context;
}
接著實作兩個按鈕:
- (IBAction)cancel:(id)sender {
[self dismissViewControllerAnimated:YES completion:nil];
}
- (IBAction)save:(id)sender {
NSManagedObjectContext *context = [self managedObjectContext];
// 建立一筆新的 managed object
NSManagedObject *newNovel = [NSEntityDescription insertNewObjectForEntityForName:@"Novel" inManagedObjectContext:context];
[newNovel setValue:self.tfName.text forKey:@"name"];
[newNovel setValue:self.tfAuthor.text forKey:@"author"];
[newNovel setValue:self.tfVersion.text forKey:@"version"];
NSError *error = nil;
// 存回持久層
if (![context save:&error]) {
NSLog(@"Can't Save! %@ %@", error, [error localizedDescription]);
}
[self dismissViewControllerAnimated:YES completion:nil];
}
按下 Cancel 只是帶著動畫關掉細節頁;按下 Save 則是取得 Context、建立新的 Managed Object、填入欄位值,呼叫 save 落地,然後關閉畫面。
在列表控制器中先宣告一個陣列,並在頁面出現時向持久層撈資料:
@interface NovelListViewController : UITableViewController @property (strong, nonatomic) NSMutableArray *novelList; @end
- (void)viewDidAppear:(BOOL)animated
{
[super viewDidAppear:animated];
NSManagedObjectContext *managedObjectContext = [self managedObjectContext];
NSFetchRequest *fetchRequest = [[NSFetchRequest alloc] initWithEntityName:@"Novel"];
self.novelList = [[managedObjectContext executeFetchRequest:fetchRequest error:nil] mutableCopy];
[self.tableView reloadData];
}
最後調整 Table View 的資料來源:
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.novelList.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
static NSString *CellIdentifier = @"Cell";
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier forIndexPath:indexPath];
NSManagedObject *novel = [self.novelList objectAtIndex:indexPath.row];
[cell.textLabel setText:[NSString stringWithFormat:@"%@ %@", [novel valueForKey:@"name"], [novel valueForKey:@"version"]]];
[cell.detailTextLabel setText:[novel valueForKey:@"author"]];
return cell;
}
別忘了把 Storyboard 裡 Table View Cell 的 Identifier 設為 Cell,要跟程式碼一致。
做到這裡,功能就完成了:資料能存、也能讀回來,而我們一行 SQL 都沒寫。