首页 > 代码库 > Coredata — 入门使用
Coredata — 入门使用
2024-11-26 00:03:02 204人阅读
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语句:
Coredata — 入门使用