Core Data的理解

一、基礎概念深入

1.NSManagedObjectContext

被管理數據上下文就像便箋簿

當從數據持久層獲取數據時,相當於把這些臨時的數據拷貝寫在便箋簿上,然後就可以隨心所欲的修改這些值。

通過上下文,可以對數據記錄NSManagedObject進行添加刪除更改,記錄更改後支持撤銷和重做。

除非你保存這些數據變化,否則持久層的東西是不會變化。

通常我們將 controller 類或其子類與 Managed Object Context NSManagedObjectContext綁定,這樣就方便我們動態地生成,獲取數據對象等。

 常用的方法:

 

-save:將數據對象保存到數據文件

-objectWithID:查詢指定 Managed Object ID 的數據對象

-deleteObject:將一個數據對象標記爲刪除,但是要等到 Context 提交更改時才真正刪除數據對象

-undo回滾最後一步操作,這是都 undo/redo 的支持

-lock加鎖,常用於多線程以及創建事務。同類接口還有:-unlock and -tryLock

-rollback還原數據文件內容

-reset清除緩存的 Managed Objects。只應當在添加或刪除 Persistent Stores 時使用

-undoManager返回當前 Context 所使用的 NSUndoManager

-assignObject: toPersistantStore:由於 Context 可以管理從不同數據文件而來的數據對象,

這個接口的作用就是指定數據對象的存儲數據文件(通過指定 PersistantStore 實現)

-executeFetchRequest: error:執行獲取數據請求,返回所有匹配的數據對象

 

2.NSManagedObject

被管理的數據記錄,相當於數據庫中的一條記錄

每一個NSManagedObject對象,都有一個全局 ID(類型爲:NSManagedObjectID)。每個在NSManagedObjectContext註冊過

的NSManagedObject,可以通過這個全局 ID 在上下文中查詢到。

每個在持久存儲層中的對象,都對應一個與上下文相關的NSManagedObject

常用的方法:

-entity 獲取實體

-objectID 獲取NSManagedObjectID

-valueForKey: 獲取指定 Property 的值

-setValue: forKey: 設定指定 Property 的值

3.NSFetchRequest

獲取數據的請求,通過被管理數據的上下文來執行查詢,比如

NSArray *fetchedObjects = [context executeFetchRequest:fetchRequest error:&error];

查詢時,必須指定查詢實體或實體名稱,以 NSArray 形式返回查詢結果,如果我們沒有設置任何查詢條件,則返回該 Entity 的所有數據對象。

我們可以使用謂詞來設置查詢條件,通常會將常用的 Fetch Requests 保存到 dictionary 以重複利用。

NSFetchRequest包括以下部分:

(1)實體(Entity)的名稱

(2)NSPredicate謂詞(搜索關鍵字或限定條件)

(3)排序方式(NSArray *)sortDescriptors

所有的被管理對象(managed object)都必須在上下文中註冊,而通過NSFetchRequest獲得的對象自動被註冊。

如果在上下文中已經存在了要獲取的對象,那麼這個被管理NSManagedObject將被返回。否則上下文就會從相關的數據源中查找(也可能找不到)

例如,以下代碼是查詢在指定日期之後創建的ContactInfo,並將查詢結果按照name排序

複製代碼

NSManagedObjectContext * context  = [self managedObjectContext];

NSManagedObjectModel   * model    = [self managedObjectModel];

NSDictionary           * entities = [model entitiesByName];

NSEntityDescription    * entity   = [entities valueForKey:@"ContactInfo"];

 

NSPredicate * predicate;

predicate = [NSPredicate predicateWithFormat:@"creationDate > %@", date];

                         

NSSortDescriptor * sort = [[NSortDescriptor alloc] initWithKey:@"name"];

NSArray * sortDescriptors = [NSArray arrayWithObject: sort];

 

NSFetchRequest * fetch = [[NSFetchRequest alloc] init];

[fetch setEntity: entity];

[fetch setPredicate: predicate];

[fetch setSortDescriptors: sortDescriptors];

 

NSArray * results = [context executeFetchRequest:fetch error:nil];

[sort release];

[fetch release];

複製代碼

常用方法:

-setEntity:設置你要查詢的數據對象的類型(Entity)

-setPredicate:設置查詢條件

-setFetchLimit:設置最大查詢對象數目

-setSortDescriptors:設置查詢結果的排序方法

-setAffectedStores:設置可以在哪些數據存儲中查詢

4.NSPersistentStoreCoordinator

持久化數據助理

Core Data定義了一個棧,持久化存儲助理在中間,棧頂是被管理數據的上下文,棧底是持久化存儲層,結構如圖

 

通常從磁盤上的數據文件中讀取或存儲數據,這些底層的讀寫就由它來處理。一般我們無需與它直接打交道,上下文已經封裝了對它的調用

常用方法:

 

 

-addPersistentStoreForURL:configuration:URL:options:error:加載持久化存儲數據,對應的卸載接口爲 -removePersistentStore:error:

-migratePersistentStore:toURL:options:withType:error:遷移數據存儲,效果與 "save as"相似,但是操作成功後,

遷移前的數據存儲不可再使用

-managedObjectIDForURIRepresentation:返回給定 URL所指示的數據存儲的 object id,如果找不到匹配的數據存儲則返回 nil

-persistentStoreForURL:返回指定路徑的 Persistent Store

-URLForPersistentStore:返回指定 Persistent Store 的存儲路徑

5.NSManagedObjectModel

被管理的數據模型,用來描述程序的實體、其屬性、關係的模型圖

包括以下幾個部分:

(1)實體(Entity)

對應NSEntityDescription對象

相當於數據庫中的一個表

實體名稱(name)

實體類名:NSManagedObject子類的名稱

實體實例:NSManagedObject對象或其子類的實例

NSEntityDescription 常用方法:

+insertNewObjectForEntityForName:inManagedObjectContext: 工廠方法,

根據給定的 Entity 描述,生成相應的 NSManagedObject 對象,並插入 ManagedObjectContext 中。

-managedObjectClassName返回映射到 Entity 的 NSManagedObject 類名

-attributesByName以名字爲 key, 返回 Entity 中對應的 Attributes

-relationshipsByName以名字爲 key, 返回 Entity 中對應的 Relationships

(2)屬性(Property)

對應NSPropertyDescription對象

Property 爲 Entity 的特性,它相當於數據庫表中的一列,或者 XML 文件中的 value-key 對中的 key。

它可以描述實體基本屬性(Attribute),實體之間的關係(RelationShip),或查詢屬性(Fetched Property)。

<1> 實體的基本屬性(Attributes)

對應NSAttributeDescription對象

存儲基本數據,數據類型包括:

string,date,integer(NSString, NSDate, NSNumber)

<2> 實體間的關係(Relationships)

對應NSRelationshipDescription對象

支持對一、對多的關係

<3> 查詢屬性(Fetched Property)

對應NSFetchedPropertyDescription對象

根據查詢謂詞返回指定實體的符合條件的數據對象

表示了一種“弱”的、單項的關係(相當於數據庫中的查詢語句)

 6.持久化存儲層(Persistent Stores)

持久化存儲層是和文件或外部數據庫關聯的,大多數訪問持久化存儲層的動作都由上下文來完成。

7.NSFetchedResultsController

 用於在表視圖table view中加載部分數據

 

二、用代碼創建數據模型

複製代碼

NSManagedObjectModel *managedObjectModel()

{

    static NSManagedObjectModel *moModel = nil;

 

    if (moModel != nil) {

        return moModel;

    }

    

    moModel = [[NSManagedObjectModel alloc] init];

    

    // Create the entity    NSEntityDescription *runEntity = [[NSEntityDescription alloc] init];

    [runEntity setName:@"Run"];

    [runEntity setManagedObjectClassName:@"Run"];

    

    [moModel setEntities:[NSArray arrayWithObject:runEntity]];

    

    // Add the Attributes    NSAttributeDescription *dateAttribute = [[NSAttributeDescription alloc] init];

    [dateAttribute setName:@"date"];

    [dateAttribute setAttributeType:NSDateAttributeType];

    [dateAttribute setOptional:NO];

    

    NSAttributeDescription *idAttribute = [[NSAttributeDescription alloc] init];

    [idAttribute setName:@"processID"];

    [idAttribute setAttributeType:NSInteger32AttributeType];

    [idAttribute setOptional:NO];

    [idAttribute setDefaultValue:[NSNumber numberWithInteger:-1]];

 

    // Create the validation predicate for the process ID.

    // The following code is equivalent to validationPredicate = [NSPredicate predicateWithFormat:@"SELF > 0"]    NSExpression *lhs = [NSExpression expressionForEvaluatedObject];

    NSExpression *rhs = [NSExpression expressionForConstantValue:[NSNumber numberWithInteger:0]];

    

    NSPredicate *validationPredicate = [NSComparisonPredicate

                                        predicateWithLeftExpression:lhs

                                        rightExpression:rhs

                                        modifier:NSDirectPredicateModifier

                                        type:NSGreaterThanPredicateOperatorType

                                        options:0];

    

    NSString *validationWarning = @"Process ID < 1";

    [idAttribute setValidationPredicates:[NSArray arrayWithObject:validationPredicate]

                  withValidationWarnings:[NSArray arrayWithObject:validationWarning]];

    

    NSArray *properties = [NSArray arrayWithObjects: dateAttribute, idAttribute, nil];

    [runEntity setProperties:properties];

    

    // Add a Localization Dictionary    NSMutableDictionary *localizationDictionary = [NSMutableDictionary dictionary];

    [localizationDictionary setObject:@"Date" forKey:@"Property/date/Entity/Run"];

    [localizationDictionary setObject:@"Process ID" forKey:@"Property/processID/Entity/Run"];

    [localizationDictionary setObject:@"Process ID must not be less than 1" forKey:@"ErrorString/Process ID < 1"];

    

    [moModel setLocalizationDictionary:localizationDictionary];

    

    return moModel;

}

複製代碼

1)我們創建了一個全局模型 moModel;

2)並在其中創建一個名爲 Run 的 Entity,這個 Entity 對應的 ManagedObject 類名爲 Run(很快我們將創建這樣一個類);

3)給 Run Entity 添加了兩個必須的 Property:date 和 processID,分別表示運行時間以及進程 ID;並設置默認的進程 ID 爲 -1;

4)給 processID 特性設置檢驗條件:必須大於 0;

5)給模型設置本地化描述詞典;

本地化描述提供對 Entity,Property,Error信息等的便於理解的描述,其可用的鍵值對如下表:

KeyValue

"Entity/NonLocalizedEntityName""LocalizedEntityName"

"Property/NonLocalizedPropertyName/Entity/EntityName""LocalizedPropertyName"

"Property/NonLocalizedPropertyName""LocalizedPropertyName"

"ErrorString/NonLocalizedErrorString""LocalizedErrorString"

 

三、存儲數據到xml文件

存儲類型爲NSXMLStoreType

複製代碼

NSManagedObjectContext *managedObjectContext()

{

    static NSManagedObjectContext *moContext = nil;

    if (moContext != nil) {

        return moContext;

    }

    

    moContext = [[NSManagedObjectContext alloc] init];

    

    // Create a persistent store coordinator, then set the coordinator for the context.    NSManagedObjectModel *moModel = managedObjectModel();

    NSPersistentStoreCoordinator *coordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:moModel];

    [moContext setPersistentStoreCoordinator: coordinator];

    

    // Create a new persistent store of the appropriate type.     NSString *STORE_TYPE = NSXMLStoreType;

    NSString *STORE_FILENAME = @"CoreDataTutorial.xml";

    

    NSError *error = nil;

    NSURL *url = [applicationDocmentDirectory() URLByAppendingPathComponent:STORE_FILENAME];

    

    NSPersistentStore *newStore = [coordinator addPersistentStoreWithType:STORE_TYPE

                                                            configuration:nil

                                                                      URL:url

                                                                  options:nil

                                                                    error:&error];

    

    if (newStore == nil) {

        NSLog(@"Store Configuration Failure\n%@", ([error localizedDescription] != nil) ? [error localizedDescription] : @"Unknown Error");

    }

 

    return moContext;

}

複製代碼

四、自定義NSManagedObject子類

比如,Run.h文件

複製代碼

#import <CoreData/NSManagedObject.h>

 

@interface Run : NSManagedObject

{

    NSInteger processID;

}

 

@property (retain) NSDate *date;

@property (retain) NSDate *primitiveDate;

@property NSInteger processID;

 

@end

複製代碼

Run.m文件

複製代碼

#import "Run.h"

 

@implementation Run

 

@dynamic date;

@dynamic primitiveDate;

 

- (void) awakeFromInsert

{

    [super awakeFromInsert];

 

    self.primitiveDate = [NSDate date];

}

 

#pragma mark -

#pragma mark Getter and setter

 

- (NSInteger)processID 

{

    [self willAccessValueForKey:@"processID"];

    NSInteger pid = processID;

    [self didAccessValueForKey:@"processID"];

    return pid;

}

 

- (void)setProcessID:(NSInteger)newProcessID

{

    [self willChangeValueForKey:@"processID"];

    processID = newProcessID;

    [self didChangeValueForKey:@"processID"];

}

 

// Implement a setNilValueForKey: method. If the key is “processID” then set processID to 0.

 

- (void)setNilValueForKey:(NSString *)key {

    

    if ([key isEqualToString:@"processID"]) {

        self.processID = 0;

    }

    else {

        [super setNilValueForKey:key];

    }

}

 

@end

複製代碼

1)這個類中的 date 和 primitiveDate 的訪問屬性爲 @dynamic,這表明在運行期會動態生成對應的 setter 和 getter;

2)在這裏我們演示瞭如何正確地手動實現 processID 的 setter 和 getter:爲了讓 ManagedObjecContext  能夠檢測 processID的變化,以及自動支持 undo/redo,我們需要在訪問和更改數據對象時告之系統,will/didAccessValueForKey 以及 will/didChangeValueForKey 就是起這個作用的。

3)當我們設置 nil 給數據對象 processID 時,我們可以在 setNilValueForKey 捕獲這個情況,並將 processID  置 0;

4)當數據對象被插入到 ManagedObjectContext 時,我們在 awakeFromInsert 將時間設置爲當前時間。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章