Coredata — 入门使用

CoreData的底层实现尽管是使用的sqlite数据库。但是CoreData在使用起来但是和sqlite大相径庭。可能你会发现你连一句sql语句都不要写。CoreData存在于应用程序和持久化存储区之间，扮演了桥梁的角色，将托管的对象映射到持久化存储区其中。

1.设置上下文

在代码開始之前还须要加入CoreData框架，并在合适的地方引入头文件<CoreData/CoreData.h>：

// 从应用程序包中载入模型文件
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];
// 传入模型对象。初始化NSPersistentStoreCoordinator
NSPersistentStoreCoordinator *psc = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];
// 构建SQLite数据库文件的路径
NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"model.data"];
// 将数据库路径转成URL
NSURL *url = [NSURL fileURLWithPath:filePath];
// 加入持久化存储库，这里使用SQLite作为存储库
NSError *error = nil;
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:url options:nil error:&error];
// 推断数据库是否加入成功
if (store == nil) {
[NSException raise:@"加入数据库错误" format:@"%@", [error localizedDescription]];
}
// 初始化上下文
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] initWithConcurrencyType:NSMainQueueConcurrencyType];
// 设置persistentStoreCoordinator属性
context.persistentStoreCoordinator = psc;

2.加入数据

// 创建一个Husband实体对象，传入上下文
NSManagedObject *husband = [NSEntityDescription insertNewObjectForEntityForName:@"Husband" inManagedObjectContext:context];
// 通过键值编码的方式设置Husband的name属性
[husband setValue:@"jack" forKey:@"name"];
// 通过coredata生成的实体类来创建一个Wife实体对象，传入上下文
Wife *wife = [NSEntityDescription insertNewObjectForEntityForName:@"Wife" inManagedObjectContext:context];
// 通过setter方法设置属性
wife.name = @"rose";
// 设置Husband和Wife之间的关联关系（一方关联，还有一方自己主动关联）
wife.husband = husband;
// 利用上下文对象，将数据同步到持久化存储库
BOOL success = [context save:&error];
if (!success) {
[NSException raise:@"訪问数据库错误" format:@"%@", [error localizedDescription]];
}
// 假设是想做更新操作：须要将实体对象先查询出来。在更改了实体对象的属性后调用[context save:&error]，就能将更改的数据同步到数据库

3.查询数据

// 初始化一个查询请求
NSFetchRequest *request = [[NSFetchRequest alloc] init];
// 设置要查询的实体
request.entity = [NSEntityDescription entityForName:@"Husband" inManagedObjectContext:context];
// 设置排序（依照name降序）
NSSortDescriptor *sort = [NSSortDescriptor sortDescriptorWithKey:@"name" ascending:NO];
request.sortDescriptors = [NSArray arrayWithObject:sort];
// 设置条件过滤(搜索name中包括字符串"ja"的记录)
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name like %@", @"*ja*"];
request.predicate = predicate;
// 运行请求,返回一个数组
NSArray *objs = [context executeFetchRequest:request error:&error];
if (error) {
[NSException raise:@"查询错误" format:@"%@", [error localizedDescription]];
}
// 遍历数据
for (NSManagedObject *obj in objs) {
NSLog(@"name=%@", [obj valueForKey:@"name"]);
// 实体属性中包括还有一个实体。不须要再次设置查询请求，Core Data会依据关联关系查询到关联的实体信息
NSLog(@"wife = %@", [[obj valueForKey:@"wife"] valueForKey:@"name"]);
}

fetchRequest相当于sql查询语句的包装类。须要用setEntity方法，来指定详细查询的实体结构（表结构）；

通过NSEntityDescription的entityForName方法来。返回指向该详细实体结构的指针；

然后调用executeFetchRequest:error:方法，来运行查询操作，假设操作成功，则返回相应的数据记录数组。

当中，能够通过NSManagedObject数据记录对象里关联的属性，查询还有一个数据记录对象里的属性；

CoreData不会依据实体中的关联关系马上获取对应的关联对象，比方通过CoreData取出Husband实体时。并不会马上查询相关联的Wife实体；当应用真的须要使用Wife时，才会再次查询数据库。载入Wife实体的信息。这个就是CoreData的延迟载入机制。

4.删除数据

Core Data的增删改使用的方法都是save:方法，在上下文调用save方法之前，全部的数据改动都是发生在内存中的。仅仅有调用save方法后，上下文中发生的数据改动才会被写入到持久化存储区。

获取到须要删除的实体对象之后。调用deleteObject:方法就能够从上下文中删除这个实体对象了，最后须要调用save:方法同步改动到数据库中：

// 初始化一个查询请求
NSFetchRequest *request = [[NSFetchRequest alloc] init];
// 设置要查询的实体
request.entity = [NSEntityDescription entityForName:@"Husband" inManagedObjectContext:context];
// 设置条件过滤(搜索name等于jack2的实体)
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name == %@", @"jack2"];
request.predicate = predicate;
// 运行请求,返回一个数组
NSArray *objs = [context executeFetchRequest:request error:&error];
if (error) {
[NSException raise:@"查询错误" format:@"%@", [error localizedDescription]];
}
// 遍历数据
for (NSManagedObject *obj in objs) {
// 传入须要删除的实体对象
[context deleteObject:obj];
// 将结果同步到数据库
[context save:&error];
if (error) {
[NSException raise:@"删除错误" format:@"%@", [error localizedDescription]];
}
}

5.新建project时勾选Use Core Data选项的情况

在新建project时使用CoreData，系统会帮我们在AppDelegate中搭建好一个上下文环境，我们能够在其它的controller中去使用这个context，省去了自己搭建上下文的操作，使用起来很简便。

AppDelegate.h中：

@interface AppDelegate : UIResponder
@property (strong, nonatomic) UIWindow *window;
// 搭建上下文环境须要使用的对象
@property (readonly, strong, nonatomic) NSManagedObjectContext *managedObjectContext;
@property (readonly, strong, nonatomic) NSManagedObjectModel *managedObjectModel;
@property (readonly, strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator;
// 保存实体对象到数据库中
- (void)saveContext;
// 取得程序沙盒路径的URL
- (NSURL *)applicationDocumentsDirectory;
@end

AppDelegate.m中：

#pragma mark - Core Data stack
@synthesize managedObjectContext = _managedObjectContext;
@synthesize managedObjectModel = _managedObjectModel;
@synthesize persistentStoreCoordinator = _persistentStoreCoordinator;
- (NSURL *)applicationDocumentsDirectory {
// The directory the application uses to store the Core Data store file. This code uses a directory named "edu.hcit.qqqqq" in the application's documents directory.
return [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject];
}
- (NSManagedObjectModel *)managedObjectModel {
// The managed object model for the application. It is a fatal error for the application not to be able to find and load its model.
if (_managedObjectModel != nil) {
return _managedObjectModel;
}
/**************************************************************************************************/
// model 是模型文件的名称，默认是和项目名称同样的
NSURL *modelURL = [[NSBundle mainBundle] URLForResource:@"model" withExtension:@"momd"];
_managedObjectModel = [[NSManagedObjectModel alloc] initWithContentsOfURL:modelURL];
return _managedObjectModel;
}
- (NSPersistentStoreCoordinator *)persistentStoreCoordinator {
// The persistent store coordinator for the application. This implementation creates and returns a coordinator, having added the store for the application to it.
if (_persistentStoreCoordinator != nil) {
return _persistentStoreCoordinator;
}
// Create the coordinator and store
_persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:[self managedObjectModel]];
/**************************************************************************************************/
// 以下的数据库 model.sqlite 是存储实体数据的数据库
NSURL *storeURL = [[self applicationDocumentsDirectory] URLByAppendingPathComponent:@"model.sqlite"];
NSError *error = nil;
NSString *failureReason = @"There was an error creating or loading the application's saved data.";
if (![_persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:nil error:&error]) {
// Report any error we got.
NSMutableDictionary *dict = [NSMutableDictionary dictionary];
dict[NSLocalizedDescriptionKey] = @"Failed to initialize the application's saved data";
dict[NSLocalizedFailureReasonErrorKey] = failureReason;
dict[NSUnderlyingErrorKey] = error;
error = [NSError errorWithDomain:@"YOUR_ERROR_DOMAIN" code:9999 userInfo:dict];
// Replace this with code to handle the error appropriately.
// abort() causes the application to generate a crash log and terminate. You should not use this function in a shipping application, although it may be useful during development.
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
return _persistentStoreCoordinator;
}
- (NSManagedObjectContext *)managedObjectContext {
// Returns the managed object context for the application (which is already bound to the persistent store coordinator for the application.)
if (_managedObjectContext != nil) {
return _managedObjectContext;
}
NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator];
if (!coordinator) {
return nil;
}
_managedObjectContext = [[NSManagedObjectContext alloc] initWithConcurrencyType:NSMainQueueConcurrencyType];
[_managedObjectContext setPersistentStoreCoordinator:coordinator];
return _managedObjectContext;
}

#pragma mark - Core Data Saving support
- (void)saveContext {
NSManagedObjectContext *managedObjectContext = self.managedObjectContext;
if (managedObjectContext != nil) {
NSError *error = nil;
if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) {
// Replace this implementation with code to handle the error appropriately.
// abort() causes the application to generate a crash log and terminate. You should not use this function in a shipping application, although it may be useful during development.
NSLog(@"Unresolved error %@, %@", error, [error userInfo]);
abort();
}
}
}

假设在一个已有的project中加入CoreData。搭建上下文时能够新建一个使用CoreData的project，将上述的代码复制到已有project，在AppDelegate.m中将模型文件的名称和数据库名称稍作改动就可以。数据的操作方法与上文类似。

6.打印隐藏的SQL语句

在Edit Scheme中选择Run，之后进入Arguments标签，加入參数：“-com.apple.CoreData.SQLDebug 1”

打开SQL语句隐藏开关后，程序在执行时。debug日志里会打印程序执行的SQL语句：