您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發(96)之 Core Data 完整入門

編輯:iOS 開發綜合

Core Data 是位於 SQLite 之上的強大持久化層,它隱藏了 SQL 的複雜性,讓我們能用操作物件的方式操作資料庫。Core Data 會把資料表的每一列轉換成 Objective-C 物件(即「托管物件」,managed object),因此即使完全不懂 SQL 也能完成資料存取。

在 MVC 設計模式中,Core Data 屬於模型層。一般需要在裝置上儲存結構化資料時,工程師會在 SQLite 與序列化( NSCoding 歸檔)之間做選擇,而 Core Data 可以視為兩者的混合體:它擁有 SQL 的強大查詢能力,使用起來卻和序列化一樣簡單,而且不需要手動維護「屬性名稱 ↔ 資料庫欄位名稱」的對應關係。

三個核心概念

托管物件(Managed Object):要存入資料庫的物件表示,可視為 SQL 的一筆紀錄。它包含若干欄位,與應用程式中物件的屬性相互對應。建立後必須先托管到「托管物件上下文中」,才能進一步存入資料庫。

托管物件上下文(Managed Object Context):包含所有已準備提交的托管物件。新增、修改、刪除都在這一層進行,它相當於應用程式與資料庫之間的緩衝區,只有呼叫 save: 才會真正落盤。

托管物件模型/資料表(Managed Object Model):描述資料庫的 schema,供上下文與資料庫互動時使用。其中包含多個實體描述(NSEntityDescription),每個實體對應一個資料表。

建立 Core Data 專案

首先確認已把 CoreData.framework 加入專案,接著新增模型檔:New File > Core Data > Data Model,命名為 CDJournal.xcdatamodel。以下我們做一個簡單的流水帳程式。

打開表編輯器,新增一個名為 Entry 的實體,並為它加入屬性並指定型別(例如 title、body 為 String,creationDate 為 Date)。若有多個實體之間的關聯(例如一個 Author 對應多個 Entry),可透過拖放建立關係,性質類似 SQL 的外鍵。

定義完實體後,必須產生對應的類別:選取 Entry 實體,選擇選單 Editor > Create NSManagedObject Subclass,點擊 Create。完成後專案中會多出 Entry.h 與 Entry.m,這就是實體的物件表示。

初始化 Core Data 堆疊

在 AppDelegate.h 中宣告三個必要物件:

#import <UIKit/UIKit.h>
#import <CoreData/CoreData.h>

@interface AppDelegate : UIResponder <UIApplicationDelegate>
@property (strong, nonatomic) UIWindow *window;

@property (strong, nonatomic) NSManagedObjectModel       *managedObjectModel;      // 資料模型
@property (strong, nonatomic) NSManagedObjectContext     *managedObjectContext;    // 上下文
@property (strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator; // 持久化協調器
@end

接著在 .m 中實作三個 getter:

- (NSManagedObjectModel *)managedObjectModel {
    if (managedObjectModel != nil) return managedObjectModel;
    managedObjectModel = [[NSManagedObjectModel mergedModelFromBundles:nil] retain];
    return managedObjectModel;
}

- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
    if (persistentStoreCoordinator != nil) return persistentStoreCoordinator;

    NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                       NSUserDomainMask, YES) lastObject];
    // Core Data 基於 SQLite,DB 檔名需與 xcdatamodel 同名
    NSURL *storeUrl = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"CDJournal.sqlite"]];

    NSError *error = nil;
    persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc]
                                    initWithManagedObjectModel:[self managedObjectModel]];
    if (![persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType
                                                  configuration:nil
                                                            URL:storeUrl
                                                        options:nil
                                                          error:&error]) {
        NSLog(@"Error: %@, %@", error, [error userInfo]);
    }
    return persistentStoreCoordinator;
}

- (NSManagedObjectContext *)managedObjectContext {
    if (managedObjectContext != nil) return managedObjectContext;

    NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
    if (coordinator != nil) {
        managedObjectContext = [[NSManagedObjectContext alloc] init];
        [managedObjectContext setPersistentStoreCoordinator:coordinator];
    }
    return managedObjectContext;
}

為避免 App 被切到背景時遺失未儲存的資料,別忘了實作 termination 時的保存:

- (void)applicationWillTerminate:(UIApplication *)application {
    NSError *error;
    if (managedObjectContext != nil) {
        if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
            NSLog(@"Error: %@, %@", error, [error userInfo]);
        }
    }
}

hasChanges 用來檢查是否有未儲存的變更,有的話才執行 save,可避免不必要的寫入。

介面與操作

在 ViewController.h 中宣告兩個輸入框與三個 action:

@interface ViewController : UIViewController
@property (retain, nonatomic) IBOutlet UITextField *titleTextField;
@property (retain, nonatomic) IBOutlet UITextField *contentTextField;
@property (strong, nonatomic) AppDelegate *myDelegate;
@property (strong, nonatomic) NSMutableArray *entries;

- (IBAction)addToDB:(id)sender;        // 新增
- (IBAction)queryFromDB:(id)sender;    // 查詢
- (IBAction)backgroundTapped:(id)sender; // 收起鍵盤
@end

新增——用 NSEntityDescription 建立托管物件,賦值後呼叫 save:

- (IBAction)addToDB:(id)sender {
    Entry *entry = (Entry *)[NSEntityDescription
        insertNewObjectForEntityForName:@"Entry"
                 inManagedObjectContext:self.myDelegate.managedObjectContext];

    [entry setTitle:self.titleTextField.text];
    [entry setBody:self.contentTextField.text];
    [entry setCreationDate:[NSDate date]];

    NSError *error;
    if (![self.myDelegate.managedObjectContext save:&error]) {
        NSLog(@"Error: %@, %@", error, [error userInfo]);
    } else {
        NSLog(@"Save successful!");
    }
}

查詢——建立 NSFetchRequest,指定實體與排序方式:

- (IBAction)queryFromDB:(id)sender {
    NSFetchRequest *request = [[NSFetchRequest alloc] init];
    NSEntityDescription *entity = [NSEntityDescription entityForName:@"Entry"
                                              inManagedObjectContext:self.myDelegate.managedObjectContext];
    [request setEntity:entity];

    // 依建立時間倒序排列
    NSSortDescriptor *sort = [[NSSortDescriptor alloc] initWithKey:@"creationDate" ascending:NO];
    [request setSortDescriptors:@[sort]];

    NSError *error = nil;
    NSArray *result = [self.myDelegate.managedObjectContext executeFetchRequest:request error:&error];
    if (result == nil) {
        NSLog(@"Error: %@, %@", error, [error userInfo]);
    }
    self.entries = [result mutableCopy];

    NSLog(@"The count of entry: %lu", (unsigned long)[self.entries count]);
    for (Entry *entry in self.entries) {
        NSLog(@"Title:%@ --- Content:%@ --- Date:%@",
              entry.title, entry.body, entry.creationDate);
    }
}

修改——直接對托管物件重新賦值,再 save 即可,Core Data 會自動偵測差異:

- (void)updateEntry:(Entry *)entry {
    [entry setTitle:self.titleTextField.text];
    [entry setBody:self.contentTextField.text];
    [entry setCreationDate:[NSDate date]];

    NSError *error;
    if (![self.myDelegate.managedObjectContext save:&error]) {
        NSLog(@"Error: %@, %@", error, [error userInfo]);
    }
}

刪除——呼叫 deleteObject 後 save:

- (void)deleteEntry:(Entry *)entry {
    [self.myDelegate.managedObjectContext deleteObject:entry];
    [self.entries removeObject:entry];

    NSError *error;
    if (![self.myDelegate.managedObjectContext save:&error]) {
        NSLog(@"Error: %@, %@", error, [error userInfo]);
    }
}

收起鍵盤:

- (IBAction)backgroundTapped:(id)sender {
    [self.titleTextField resignFirstResponder];
    [self.contentTextField resignFirstResponder];
}

執行結果

填入資料後點擊 Add,新增成功:

多加幾筆資料後點擊 Query,主控台便會印出查詢結果:

相較於直接操作 SQLite,Core Data 的最大優勢在於:資料模型的變更由工具管理、查詢以物件語法表達、並免費獲得 undo/redo 與 parent-child context 的能力。代價則是抽象層較厚,除錯時需要理解 faulting 與 batch fetch 等機制。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved