您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

Core Data 完全指南:六大元件、資料模型設計與 SQLite 落地實作

編輯:iOS 相關資訊

Core Data 是 iOS 上進行資料持久化的首選方案。這篇文章把它的組成元件、依賴關係,以及從建置、建模到增查的完整流程一次講清楚。

一、觀念篇

基本定位

  1. Core Data 是資料持久化儲存的最佳方式之一。
  2. 底層的實際儲存型態可以是 SQLite 資料庫、XML、 binary、純記憶體,或自訂型別。在 Mac OS X 10.5 Leopard 之後,開發者可以繼承 NSPersistentStore 來打造自訂儲存格式。
  3. 好處很明確:合理管理記憶體、不必跟 SQL 纏鬥、執行效率高。

七大構成元件

  • NSManagedObjectContext(被管理的資料上下文):操作持久層,負責新增、查詢、刪除。
  • NSManagedObjectModel(被管理的資料模型):包含所有表格或資料結構的定義,用來設定實體屬性與屬性之間的關係。可透過圖形化編輯器或程式碼建立。
  • NSPersistentStoreCoordinator(持久化儲存助理):相當於資料庫的連接器,決定儲存的名稱、位置、方式與時機。
  • NSManagedObject(被管理的資料記錄):對應資料庫中的一筆表格記錄。
  • NSFetchRequest(查詢請求):相當於一段查詢語句。
  • NSEntityDescription(實體結構):相當於表格結構定義。
  • .xcdatamodeld 套件:內含 .xcdatamodel 檔,由資料模型編輯器維護,編譯後產出 .momd 或 .mom。

這些元件的依賴關係可參考下圖:

二、以 SQLite 為底層的實作

要留意一個與直接操作 SQLite 的差異:Core Data 只能取出整個實體記錄後再分解,才能拿到單一屬性值。

建置流程

整體分三步:建立資料上下文、建立資料模型、建立持久化儲存助理。

新增專案時選擇 Blank Application,並勾選 Use Core Data:

勾選之後,AppDelegate 中會自動產生相關程式碼:

@property (readonly, strong, nonatomic) NSManagedObjectContext *managedObjectContext;
@property (readonly, strong, nonatomic) NSManagedObjectModel *managedObjectModel;
@property (readonly, strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator;

- (void)saveContext;
- (NSURL *)applicationDocumentsDirectory;

其中 saveContext 負責把資料存回持久層,applicationDocumentsDirectory 則回傳 App 沙盒的 Documents 目錄路徑,例如 /var/mobile/Applications/5FG80A45-DFB5-4087-A1B1-41342A977E21/Documents/。

App 即將終止時記得存回:

- (void)applicationWillTerminate:(UIApplication *)application {
    [self saveContext];
}
- (void)saveContext {
    NSError *error = nil;
    NSManagedObjectContext *managedObjectContext = self.managedObjectContext;
    if (managedObjectContext != nil) {
        if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
            NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
            abort();
        }
    }
}
- (NSURL *)applicationDocumentsDirectory {
    return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
}

資料上下文初始化之後,必須綁上持久化儲存助理:

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

資料模型必須依賴 .momd 的路徑,而 .momd 是由 .xcdatamodeld 編譯而來:

- (NSManagedObjectModel *)managedObjectModel {
    if (__managedObjectModel != nil) {
        return __managedObjectModel;
    }
    NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"TestApp" withExtension:@"momd"];
    __managedObjectModel = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
    return __managedObjectModel;
}

持久化儲存助理要依賴 NSManagedObjectModel,接著指定儲存型別(預設 NSSQLiteStoreType)、路徑與檔名:

- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
    if (__persistentStoreCoordinator != nil) {
        return __persistentStoreCoordinator;
    }
    NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@"TestApp.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 檔、自動連結 CoreData.framework,並在 .pch 預編譯碼頭檔中匯入:

#import <CoreData/CoreData.h>

用編輯器建立資料模型

新增實體:選取 .xcdatamodel 檔,在編輯器底部工具列點 Add Entity,再於右側欄命名。

新增屬性:選取實體後點 Add Attribute,命名並設定 Attribute Type。

建立關係:點 Add Relationship,命名後把 destination 指向另一個實體。

建立反向關係:在另一個實體建立關係並命名,目標指向先前的實體,並在 Inverse 欄位選回先前那條關係。

設定刪除規則:兩條關係都選 Cascade(關聯模式),這樣其中一筆資料被刪除時,另一端的資料也會一起消失。

切換 Editor Style 按鈕可以換一種檢視方式:

新增資料

在 AppDelegate.m 的 application:didFinishLaunchingWithOptions: 中呼叫自訂方法:

- (void)insertCoreData {
    NSManagedObjectContext *context = [self managedObjectContext];

    NSManagedObject *contactInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactInfo" inManagedObjectContext:context];
    [contactInfo setValue:@"name B" forKey:@"name"];
    [contactInfo setValue:@"birthday B" forKey:@"birthday"];
    [contactInfo setValue:@"age B" forKey:@"age"];

    NSManagedObject *contactDetailInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactDetailInfo" inManagedObjectContext:context];
    [contactDetailInfo setValue:@"address B" forKey:@"address"];
    [contactDetailInfo setValue:@"name B" forKey:@"name"];
    [contactDetailInfo setValue:@"telephone B" forKey:@"telephone"];

    // 建立雙向關聯
    [contactDetailInfo setValue:contactInfo forKey:@"info"];
    [contactInfo setValue:contactDetailInfo forKey:@"details"];

    NSError *error;
    if (![context save:&error]) {
        NSLog(@"不能保存:%@", [error localizedDescription]);
    }
}

流程是:取得上下文 → 用 insertNewObjectForEntityForName 建立兩筆記錄 → 對編輯器中定義的屬性賦值。此時資料只存在記憶體,呼叫 save 之後才真正落地。

查詢資料

- (void)dataFetchRequest {
    NSManagedObjectContext *context = [self managedObjectContext];
    NSFetchRequest *fetchRequest = [[[NSFetchRequest alloc] init] autorelease];
    NSEntityDescription *entity = [NSEntityDescription entityForName:@"ContactInfo" inManagedObjectContext:context];
    [fetchRequest setEntity:entity];

    NSError *error;
    NSArray *fetchedObjects = [context executeFetchRequest:fetchRequest error:&error];
    for (NSManagedObject *info in fetchedObjects) {
        NSLog(@"name:%@", [info valueForKey:@"name"]);
        NSLog(@"age:%@", [info valueForKey:@"age"]);
        NSLog(@"birthday:%@", [info valueForKey:@"birthday"]);
        NSManagedObject *details = [info valueForKey:@"details"];
        NSLog(@"address:%@", [details valueForKey:@"address"]);
        NSLog(@"telephone:%@", [details valueForKey:@"telephone"]);
    }
}

fetchRequest 是 SQL 查詢的包裝類,必須用 setEntity 指定要查的實體;entityForName 會回傳該實體結構的指標。執行 executeFetchRequest:error: 後,成功時會拿到對應的記錄陣列。你也可以透過 NSManagedObject 上的關聯屬性,直接跳到另一筆記錄取欄位。

用 NSManagedObject 子類取代 Key-Value

為每個實體產生 NSManagedObject 子類,之後就能用強型別的屬性存取,比 Key-Value 更安全也更易讀。在模型編輯器中選取實體,透過 File → New → File... → Core Data → NSManagedObject subclass 產生同名類別。

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

@class ContactDetailInfo;

@interface ContactInfo : NSManagedObject
@property (nonatomic, retain) NSString *age;
@property (nonatomic, retain) NSString *birthday;
@property (nonatomic, retain) NSString *name;
@property (nonatomic, retain) ContactDetailInfo *details;
@end
#import "ContactInfo.h"
#import "ContactDetailInfo.h"

@implementation ContactInfo
@dynamic age;
@dynamic birthday;
@dynamic name;
@dynamic details;
@end

這裡的 @dynamic 是告訴編譯器不要理會這些存取器,讓編譯通過;真正的 getter 與 setter 由 Core Data 在執行期動態產生。

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

@class ContactInfo;

@interface ContactDetailInfo : NSManagedObject
@property (nonatomic, retain) NSString *address;
@property (nonatomic, retain) NSString *name;
@property (nonatomic, retain) NSString *telephone;
@property (nonatomic, retain) ContactInfo *info;
@end
#import "ContactDetailInfo.h"
#import "ContactInfo.h"

@implementation ContactDetailInfo
@dynamic address;
@dynamic name;
@dynamic telephone;
@dynamic info;
@end

產生之後,模型編輯器右側欄的 Class 欄位會變成具體類別名稱:

原本 Key-Value 風格的程式碼就可以改寫成:

- (void)insertCoreData {
    NSManagedObjectContext *context = [self managedObjectContext];

    ContactInfo *contactInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactInfo" inManagedObjectContext:context];
    contactInfo.name = @"name B";
    contactInfo.birthday = @"birthday B";
    contactInfo.age = @"age B";

    ContactDetailInfo *contactDetailInfo = [NSEntityDescription insertNewObjectForEntityForName:@"ContactDetailInfo" inManagedObjectContext:context];
    contactDetailInfo.address = @"address B";
    contactDetailInfo.name = @"name B";
    contactDetailInfo.telephone = @"telephone B";
    contactDetailInfo.info = contactInfo;
    contactInfo.details = contactDetailInfo;

    NSError *error;
    if (![context save:&error]) {
        NSLog(@"不能保存:%@", [error localizedDescription]);
    }
}
- (void)dataFetchRequest {
    NSManagedObjectContext *context = [self managedObjectContext];
    NSFetchRequest *fetchRequest = [[[NSFetchRequest alloc] init] autorelease];
    NSEntityDescription *entity = [NSEntityDescription entityForName:@"ContactInfo" inManagedObjectContext:context];
    [fetchRequest setEntity:entity];

    NSError *error;
    NSArray *fetchedObjects = [context executeFetchRequest:fetchRequest error:&error];
    for (ContactInfo *info in fetchedObjects) {
        NSLog(@"name:%@", info.name);
        NSLog(@"age:%@", info.age);
        NSLog(@"birthday:%@", info.birthday);
        ContactDetailInfo *details = info.details;
        NSLog(@"address:%@", details.address);
        NSLog(@"telephone:%@", details.telephone);
    }
}

三、底層資料庫小抄

想看 Core Data 實際送出的 SQL,可以在 Edit Scheme → Run → Arguments 分頁加入參數:-com.apple.CoreData.SQLDebug 1。

使用 SQLite 儲存時,資料表名稱是「Z」加上實體名稱大寫,一個實體對應一張表;欄位名稱則是「Z」加上屬性名稱大寫。

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