iphone数据存储之-- 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信息等的便于理解的描述,其可用的键值对如下表:

Key Value
"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 将时间设置为当前时间。

 

posted @ 2012-10-09 12:42  月光的尽头  阅读(9410)  评论(4编辑  收藏  举报