您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 程式設計技術

iOS 學習筆記 18|CoreData 框架入門:結構、使用與調試

編輯:iOS 程式設計技術

一、CoreData 是什麼

CoreData 是 iOS 5 之後出現的一套框架,本質上是對 SQLite 做了一層封裝與升級的數據持久化方案。它提供了對象 ↔ 關係的映射能力:既能把 OC 對象轉化為數據存進 SQLite 文件,也能把庫裡的數據還原成 OC 對象。

相比直接操作 SQLite,用 CoreData 最大的好處是不用寫 SQL 語句,增刪改查都通過對象操作完成。

二、核心結構

先看一張官方結構圖:

四個關鍵角色:

  • PersistentObjectStore:真正存數據的地方,最常用的是 SQLite(CoreData 也支持 XML、二進制等存儲類型);
  • ManagedObjectModel:對象模型,對應 Xcode 中創建的那個模型文件;
  • PersistentStoreCoordinator:協調器,負責模型與實體類之間的轉換,管理不同存儲的上下文;
  • ManagedObjectContext:對象管理上下文,負責實體對象與數據庫之間的交互,是我們日常打交道最多的對象。

光看文字容易懵,換張理解圖:

最底層是 PersistentObjectStore,也就是實際存數據的結構;圖中的「模型」就是 ManagedObjectModel,是數據轉化為對象的模板。以 SQLite 存儲為例,三類操作的流程是:

  • 讀數據:庫中數據先進入數據解析器,按模型模板生成對應的關聯對象;
  • 插入數據:對象管理器先根據實體描述創建一個空對象並初始化,再經數據解析器按模板轉化為庫數據寫入;
  • 更新數據:先把庫中數據讀出來拿到關聯對象,修改該對象,修改結果再由解析器轉化為更新語句寫回。

這些環節的具體意義,還是在實際使用中體會更深。

三、CoreData 使用步驟

1. 添加框架

  • 引入 CoreData.framework;
  • 導入頭文件 #import <CoreData/CoreData.h>。

2. 創建數據模型與實體類

依據上面的結構圖,第一步是創建數據模板 ManagedObjectModel。這一步全是圖形化操作:

一路 Next:先是選擇數據模板文件並勾選,接著勾選需要的實體,最後會自動生成對象模型文件。

幾點說明:

  • 所有實體類都繼承自 NSManagedObject,每個 NSManagedObject 實例對應庫中一條記錄;
  • 集合屬性(如數組)會自動生成訪問該屬性的分類方法;
  • 屬性的實現用 @dynamic 声明,具體存取細節由框架在運行時提供,開發者不用操心。

3. 創建對象管理上下文

ManagedObjectContext 的創建可以拆成四步:加載模型文件 → 指定數據存儲路徑 → 創建對應類型的存儲 → 創建上下文並關聯存儲。

- (NSManagedObjectContext *)createDbContext {
    // 加載模型,傳 nil 表示合併 bundle 中的所有模型文件
    NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];

    // 創建數據解析器
    NSPersistentStoreCoordinator *storeCoordinator =
        [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];

    // 拼接數據庫路徑
    NSString *dir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    NSString *path = [dir stringByAppendingPathComponent:@"myDatabase.db"];
    NSURL *url = [NSURL fileURLWithPath:path];

    // 關聯 SQLite 持久存儲
    NSError *error = nil;
    [storeCoordinator addPersistentStoreWithType:NSSQLiteStoreType
                                   configuration:nil
                                             URL:url
                                         options:nil
                                           error:&error];

    NSManagedObjectContext *context = nil;
    if (!error) {
        context = [[NSManagedObjectContext alloc] init];
        context.persistentStoreCoordinator = storeCoordinator;
        NSLog(@"數據庫打開成功");
    } else {
        NSLog(@"數據庫打開失敗:%@", error.localizedDescription);
    }
    return context;
}

4. 插入數據

插入時先用 NSEntityDescription(實體描述類)的類方法創建一個實體對象,賦值後保存上下文。

- (void)addClassTest {
    Classes *classes = [NSEntityDescription insertNewObjectForEntityForName:@"Classes"
                                                  inManagedObjectContext:self.context];
    classes.c_id = 301;
    classes.c_name = @"高三(1)班";

    NSError *error = nil;
    // 增刪改之後都必須調用 save,否則操作不會落盤
    if (![self.context save:&error]) {
        NSLog(@"添加過程中發生錯誤:%@", error.localizedDescription);
    }
}

5. 刪除數據

刪除就是把關聯的對象從上下文中刪掉,然後保存:

- (void)removeClasses:(Classes *)classes {
    [self.context deleteObject:classes];
    NSError *error = nil;
    if (![self.context save:&error]) {
        NSLog(@"刪除過程中發生錯誤:%@", error.localizedDescription);
    }
}

6. 查詢數據

查詢要用到兩個類:

  • NSFetchRequest:獲取數據的請求;
  • NSPredicate:請求的謂詞,也就是篩選條件。

場景一:查詢只有唯一關聯對象的情況

例如查找用戶名為 Binger 的所有微博(一條微博只屬於一個用戶),用 keypath 直接查:

- (NSArray *)getStatusByUserName:(NSString *)name {
    NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Status"];
    request.predicate = [NSPredicate predicateWithFormat:@"user.name=%@", name];
    return [self.context executeFetchRequest:request error:nil];
}

場景二:一個對象有多個關聯對象

例如查找內容包含 Watch、且昵稱為「小娜」的用戶發的微博(一個用戶有多條微博),可以兩步走:

- (NSArray *)getUsersByStatusText:(NSString *)text screenName:(NSString *)screenName {
    NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Status"];
    request.predicate = [NSPredicate predicateWithFormat:@"text LIKE '*Watch*'"];
    NSArray *statuses = [self.context executeFetchRequest:request error:nil];

    // 再對結果集做一次謂詞過濾
    NSPredicate *userPredicate = [NSPredicate predicateWithFormat:@"user.screenName=%@", screenName];
    return [statuses filteredArrayUsingPredicate:userPredicate];
}

7. 修改數據

拿到關聯對象直接改屬性,然後保存:

- (void)modifyClasses:(Classes *)classes {
    classes.name = @"吊炸天畢業(1)班";
    NSError *error = nil;
    if (![self.context save:&error]) {
        NSLog(@"修改過程中發生錯誤:%@", error.localizedDescription);
    }
}

四、如何調試 CoreData

Xcode 是支持 CoreData 語句級調試的,開啟路徑如下:

  • Product → Scheme → Edit Scheme
  • Edit Scheme → Run → Arguments

依次添加兩個啟動參數(順序不能錯):-com.apple.CoreData.SQLDebug 1 與 -com.apple.CoreData.LoggingLevel 1。

配置好之後,運行過程中一旦操作了數據庫,對應的 SQL 語句就會打印在輸出面板裡,排查問題非常方便。

注意:如果模型發生了改動,實體類可以重新生成,但已存在的數據庫並不會自動跟著更新。這時需要考慮新建數據庫,並把舊數據遷移過去。

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