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

認識 CoreData(二):模型檔、托管物件類別與增刪改查全流程

編輯:iOS 開發基礎

投稿文章,作者:劉小壯

第一篇沒有觸及具體用法,只是把 CoreData 整體介紹了一遍,算開場也算總結。這一篇進入實作:CoreData 的基礎用法,以及使用中容易忽略的細節。因為會穿插大量程式碼與截圖,篇幅偏長,頗考驗耐心。

文中若有疏漏或錯誤,還請各位及時提出,謝謝。

建立自帶 CoreData 的工程

新建專案時勾選 Use Core Data,系統會自動生成一批 CoreData 程式碼,以及一個以工程名稱開頭、副檔名為 .xcdatamodeld 的模型檔。這些程式碼位於 AppDelegate 中,等於全域可用。

系統生成的內容其實很少:托管物件模型、托管物件上下文、持久化儲存調度器,加上一個 MOC 的 save 方法。但這些已經足夠跑通基礎流程。

不過我並不建議把這部分程式碼留在 AppDelegate 裡,大型專案尤其應該把它抽離到專門的類別或模組中管理。所以我的習慣是新建一個「乾淨」的專案,自己從零把 CoreData 加進去——這樣對整個使用鏈路的掌握會牢固得多。

模型檔的建立

建立模型檔

使用 CoreData 的第一步,是建立副檔名為 .xcdatamodeld 的模型檔:Command + N → Core Data → Data Model → Next。

建立完成後,左側列表有三個入口:Entities、Fetch Requests、Configurations,分別對應實體、請求模板與配置資訊。

新增實體與屬性

點擊左側列表下方的 Add Entity,可選擇 Add Entity、Add Fetch Request、Add Configuration。這裡先新增一個命名為 Person 的實體。

每個實體都對應三塊內容:Attributes、Relationships、Fetched Properties,即屬性、關聯關係與擷取操作。

接著為 Person 加上兩個屬性:age(Integer 16)與 name(String)。

屬性型別一覽

模型檔中的型別選擇,和一般繼承自 NSObject 的模型類別大致相似,但仍有幾點值得留意:

  • Undefined:預設值,參與編譯會報錯。

  • Integer 16:整數,範圍 -32768 ~ 32767。

  • Integer 32:整數,範圍 -2147483648 ~ 2147483647。

  • Integer 64:整數,範圍 –9223372036854775808 ~ 9223372036854775807。

  • Float:單精度小數,精度與範圍低於 Double。

  • Double:雙精度小數,小數位更精確、表示範圍更大。

  • String:對應 NSString。

  • Boolean:對應 NSNumber。

  • Date:對應 NSDate。

  • Binary Data:對應 NSData。

  • Transformable:任意 OC 物件,生成類別檔後會先被宣告為 id,可手動改成實際型別。前提是該類別必須遵守並實作 NSCoding 協議,因為它需要被歸檔落地。

建立實體關聯

新增 Department 與 Employee 兩個實體,各自補上一些屬性,然後在它們之間建立關聯。

先在 Employee 的 Relationships 處點加號,名稱設為 department,Type 設為 Department,Inverse 設為 employee(這個欄位的作用後面會說)。

再對 Department 做同樣的操作,唯一關鍵差異是 Type:這裡要選 To Many(一對多)。Employee 那邊預設的 To One 是一對一關係。如此一來就符合常理——一個 Department 可以有多個 Employee,而一個 Employee 只屬於一個 Department。

Relationships 的角色有點像 SQLite 的外部索引鍵,用來定義同一模型內實體之間的關係,可設為對一或對多,也可單向或雙向,一切看需求。若為對多關係,預設以 NSSet 集合來承載。

Inverse 的作用則是:兩個實體互相把對方填進 Inverse,就形成了雙向關聯,從任一端都能找到另一端。

Fetched Properties

實體最下方還有個 Fetched Properties,實務上用得不多,這裡不展開。它的功能與 NSFetchRequest 相同,屬於預先定義好的擷取規則;定義完成後,可透過 NSManagedObjectModel 的 fetchRequestFromTemplateWithName:substitutionVariables: 等方法取出,系統會把它們快取在一個字典中。

Data Model Inspector:屬性與關係的細節設定

選中實體後,右側的 Data Model Inspector 提供進一步配置,且會隨屬性型別不同而變化。以下以 String 型別為例。

屬性設定

  • Default Value:預設值,除二進位外幾乎所有型別都支援。

  • Optional:是否可選。設為 NO 時,存檔前該屬性必須有值,否則 MOC 會失敗並回傳 error。預設是 YES。

  • Transient:設為 YES 則該屬性只存在記憶體中,不參與持久化。其他操作與一般屬性無異。它很適合存放臨時資料——每次都不同、也不需要落地的那些。

  • Indexed:加上索引能明顯加快檢索;但代價出現在刪除等寫入操作上,因為索引也要同步維護,速度會變慢。

  • Validation:可設定 Max Value / Min Value 來約束資料。數值型別約束範圍,字串約束長度,日期約束時間區間。

  • Reg. Ex.:可掛正則表達式做校驗,不影響資料本身(僅適用於 String)。

  • Allows External Storage:存放大型二進位檔案時,是否放到儲存區之外。設為 YES 時,超過 1MB 的檔案會外置,避免拖累 SQLite 的表操作效率。

Relationships 設定

Delete Rule 定義的是:當目前物件被刪除時,與之關聯的物件會如何反應。共有四個枚舉值,與模型檔中的選項一一對應:

  • NSNoActionDeleteRule:刪除後不做任何處理,也不會把關聯物件的指向清空。後續若繼續使用該關聯屬性,可能衍生其他問題。

  • NSNullifyDeleteRule:刪除後把關聯物件的指向設為 nil,這是預設值。

  • NSCascadeDeleteRule:連帶刪除,目前物件被刪時,與之關聯的物件也一併刪除。

  • NSDenyDeleteRule:若目前物件仍被其他物件指向,則不允許刪除。

Type 則決定這段關係是 To One 還是 To Many。

實體的繼承

Parent Entity 可以在實體之間建立繼承關係,產生的托管類別檔同樣帶有繼承結構。要注意的是,父子實體的屬性名稱不可重複。

使用繼承時有個副作用值得留意:系統會把子類繼承自父類的那部分資料,統一存進父類的表中。所有共享同一父類的子類都往同一張表寫,資料量容易失控,進而影響效能。

Fetch Requests:視覺化的請求配置

Entities 下方的 Fetch Requests 也是用來配置請求物件的,但操作更直覺,幾個點擊就能完成簡單的請求設定,比前面提到的 Fetched Properties 好用一些。

上圖是針對 Employee 的 height 屬性做的配置,條件是 height 小於 2。之後可透過 NSManagedObjectModel 的 fetchRequestTemplateForName: 取出,參數就是這裡設定的名稱 EmployeeFR。

Editor Style:兩種視角看模型

我認為這是 CoreData 最大的優勢之一——模型結構完全視覺化,實體與屬性、實體與實體之間的對應關係一目了然。

.xcdatamodeld 提供兩種檢視風格:Table(列表)與 Graph(圖表)。圖表更直觀,操作上也有便利之處:在 Table 模式下建立兩個實體的關聯,預設只會產生單向關係;而在 Graph 模式下,按住 Control 把兩個圖形連起來,結果會是雙向關聯。

純程式碼建立實體?可以,但不推薦

如果完全不用模型檔,就得靠程式碼建立實體描述、關聯描述,再逐一設定給 NSManagedObjectModel;而使用模型檔時,這些都是透過 NSManagedObjectModel 讀檔完成。

純程式碼的路線下,Apple 更推薦用 KVC 存取,所有托管物件一律用 NSManagedObject 建立。但問題不少:開發成本高、使用不便,最大的痛點是到處寫屬性名稱的字串 key,極易出錯,而且 CoreData 原本的優勢也蕩然無存。所以還是強烈建議走模型檔路線。

建立托管物件類別檔

實體建立完成後,就能依據它生成繼承自 NSManagedObject 的類別檔。

這裡刻意用 Department 來示範——因為它有對多關係,生成的關聯屬性寫法與對一關係不同,正好能看出差異。Command + N → NSManagedObject subclass → 選模型檔 → 選實體。

結果會產生四個檔案:以實體名開頭的 .h 與 .m,另外兩個是該實體的 Category。

為什麼會多出 Category

Category 裡有兩個分類:CoreDataProperties 與 CoreDataGeneratedAccessors。其中前者一定存在,後者只在實體設定了對多關係時才會生成。

CoreDataProperties 中列出實體宣告的 Attributes 與 Relationships。對多關係以 NSSet 承載,對一關係則是普通物件型別屬性。在 .m 檔中,所有屬性都以 @dynamic 修飾——因為 CoreData 會在執行期動態為這些屬性生成實作,編譯期並不存在。

CoreDataGeneratedAccessors 則是系統為對多屬性自動生成的集合操作方法,通常一個屬性對應四個方法,同樣在執行期動態實作,用途都是操作那個集合。

托管物件類別檔本身

打開系統生成的類別檔,內容非常乾淨,沒有任何業務邏輯。Apple 的註解寫著:Insert code here to declare functionality of your managed object subclass——這裡就是你撰寫該類別相關邏輯的地方。當然,什麼都不寫也完全可以,取決於需求。

任意型別屬性與標量型別

實體支援任何繼承自 NSObject 的屬性型別,包含專案裡自己寫的類別。由於下拉清單不會列出專案自訂類別,做法是先把型別選為 Transformable,生成類別檔後再手動改成想要的型別。前提依舊:該類別必須遵守 NSCoding 協議。

另一個容易忽略的細節是:無論實體裡選的是 Integer 32 還是 Float,只要屬於基礎資料型別,生成出來預設都是 NSNumber。若你希望拿到真正的標量型別,建立檔案時請勾選 Use scalar properties for primitive data types,這樣就會產生 int64_t、float 這類型別。

模型變動後如何更新

實體有變動時,需要重新生成 Category 檔。步驟與前面相同,重點是直接替換 Category 檔,不要刪除;托管物件類別檔本身不會被覆寫。

CoreData 增刪改查

以下操作仍以 Department 與 Employee 為例,模型檔名為 Company。

先談 NSManagedObjectContext

iOS 5 之前,建立 MOC 都是直接 init。iOS 5 之後,Apple 更推薦 initWithConcurrencyType:,在建立時就明確指定並發型別。這個參數是枚舉值,主要有三種:

  • NSConfinementConcurrencyType:用 init 建立時的隱式預設值。iOS 9 之後已被 Apple 廢棄,呼叫部分較新的 CoreData API 可能導致崩潰。

  • NSPrivateQueueConcurrencyType:私有並發佇列,操作都在子執行緒完成。

  • NSMainQueueConcurrencyType:主並發佇列。涉及 UI 相關操作時,應使用這個選項。

若繼續沿用 init,就可能與後來推出的 API 不相容。典型錯誤如下——因為未顯式指定並發型別時,預設落到已廢棄的 NSConfinementConcurrencyType:

Terminating app due to uncaught exception 'NSInvalidArgumentException',
reason: 'NSConfinementConcurrencyType context ...'

建立 MOC 的完整程式碼

// 上下文:並發佇列設為主佇列
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] initWithConcurrencyType:NSMainQueueConcurrencyType];

// 托管物件模型:以 Company.momd 的路徑初始化
NSURL *modelPath = [[NSBundle mainBundle] URLForResource:@"Company" withExtension:@"momd"];
NSManagedObjectModel *model = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelPath];

// 持久化儲存調度器
NSPersistentStoreCoordinator *coordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];

// 關聯 SQLite 檔案(已存在則不會重複建立)
NSString *dataPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject;
dataPath = [dataPath stringByAppendingFormat:@"/%@.sqlite", @"Company"];
[coordinator addPersistentStoreWithType:NSSQLiteStoreType
                          configuration:nil
                                    URL:[NSURL fileURLWithPath:dataPath]
                                options:nil
                                  error:nil];

// 把調度器掛到上下文上
context.persistentStoreCoordinator = coordinator;

關於 .momd

程式碼裡出現的 momd 是什麼?建立 .xcdatamodeld 之後,它在編譯期會被編譯成副檔名為 .momd 的檔案,放進 .app 的 Main Bundle 中。

專案裡若有多個模型檔,就需要透過載入不同的 .momd 來建立不同的 NSManagedObjectModel,一個 MOM 對應一個模型檔。MOM 內部包含該模型檔所有 entities、configurations、fetchRequests 的描述。

雖然 .momd 放在 .app 裡、別人解包就能看到,但它是經過編碼的,無法直接讀出內容,因此安全性不成問題。

這裡有個實務上的重點:如果不指定 MOM 對應哪個模型檔,直接用 init 建立,系統會把所有模型檔的表全部塞进同一個 SQLite 資料庫。 因此需要明確用 mainBundle 中的不同 .momd 分別初始化 MOM,這樣建立資料庫時才會產生各自獨立的檔案。

持久化儲存調度器(PSC)

NSPersistentStoreCoordinator 在 CoreData 體系中扮演「中樞」:對上,它提供簡潔的呼叫介面,把持久化細節隱藏起來;對下,它協調多個持久化儲存物件(NSPersistentStore),讓下層只需專注存檔邏輯。

addPersistentStoreWithType:configuration:URL:options:error: 負責建立並關聯資料庫,回傳一個負責具體持久化實作的 NSPersistentStore 物件。注意它是實例方法,也就是說同一個 PSC 可以掛多個儲存區——語法上允許,但這種需求不多,管理起來也麻煩,實務上很少這麼做。

PSC 提供四種儲存方案,最常用的是 SQLite。其中 Binary 與 XML 這兩種在操作時需要把整個檔案載入記憶體,開銷相當可觀:

  • NSSQLiteStoreType:SQLite 資料庫

  • NSXMLStoreType:XML 檔案

  • NSBinaryStoreType:二進位檔案

  • NSInMemoryStoreType:直接存在記憶體中

新增

// 建立托管物件並指定實體名
Employee *emp = [NSEntityDescription insertNewObjectForEntityForName:@"Employee"
                                             inManagedObjectContext:context];
emp.name = @"lxz";
emp.height = @1.7;
emp.brithday = [NSDate date];

// 存檔前先判斷是否有變更
NSError *error = nil;
if (context.hasChanges) {
    [context save:&error];
}

if (error) {
    NSLog(@"CoreData Insert Data Error : %@", error);
}

insertNewObjectForEntityForName:inManagedObjectContext: 會建立並回傳一個托管物件,同時把它掛進指定上下文。要注意的是,MOC 會先把操作留在快取層,只有呼叫 save: 之後才真正寫入資料庫。這樣做避免了頻繁的磁碟存取。

刪除

// 先撈出要刪的物件
NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Employee"];

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name = %@", @"lxz"];
request.predicate = predicate;

NSError *error = nil;
NSArray *employees = [context executeFetchRequest:request error:&error];

// 逐個刪除
[employees enumerateObjectsUsingBlock:^(Employee * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    [context deleteObject:obj];
}];

if (context.hasChanges) {
    [context save:nil];
}

if (error) {
    NSLog(@"CoreData Delete Data Error : %@", error);
}

修改

NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Employee"];

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name = %@", @"lxz"];
request.predicate = predicate;

NSError *error = nil;
NSArray *employees = [context executeFetchRequest:request error:&error];

[employees enumerateObjectsUsingBlock:^(Employee * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    obj.height = @3.f;
}];

// 變更同樣需要存檔才會落地
if (context.hasChanges) {
    [context save:nil];
}

if (error) {
    NSLog(@"CoreData Update Data Error : %@", error);
}

查詢

NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Employee"];

NSError *error = nil;
NSArray *employees = [context executeFetchRequest:request error:&error];

[employees enumerateObjectsUsingBlock:^(Employee * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    NSLog(@"Employee Name : %@, Height : %@, Brithday : %@", obj.name, obj.height, obj.brithday);
}];

if (error) {
    NSLog(@"CoreData Ergodic Data Error : %@", error);
}

查詢示範寫得比較粗暴,直接把整張 Employee 表撈了出來——純粹為了展示流程。實務中當然只該載入真正需要的資料,下一篇文章會談到更精細的取用方式。

總結

CoreData 中所有托管物件一旦建立,就都掛靠在 MOC 上。因此對它做的任何操作都會被 MOC 記錄下來;直到呼叫 save:,MOC 才把任務交給 PSC,再由 PSC 指派給具體的 NSPersistentStore 去落地。

上面這組增刪改查,流程大同小異,都是最基礎的操作。下一篇會進入更複雜的應用場景。

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