【iOS】Core Data
- 前言
- Core Data基本概念
- Core Data核心组件
- Core Data增删改查
- 总结
前言
笔者写项目时用到了Core Data,在此系统学习总结一下。
Core Data基本概念
Core Data是Apple官方推出,适配iOS/macOS的本地数据持久化与对象图管理框架,并非数据库,而是封装了SQLite、二进制、XML存储的ORM框架。开发者无需编写SQL语句,可直接通过操作OC对象实现数据增删改查,同时内置缓存、事务、撤销重做、数据版本迁移能力。
其优势主要在于:
- 简化数据管理:提供ORM映射自动完成OC对象与数据库数据的转换,减少了直接与SQL数据库的交互。
- 高效数据查询:通过NSPredicate进行复杂的数据查询,提高数据检索的灵活性和效率。
- 内置缓存机制:上下文自动缓存已加载数据,减少频繁磁盘IO,提升数据读写性能。
- 版本控制:自动处理数据模型的版本管理,支持数据迁移。
Core Data采用分层栈架构,所有数据操作遵循Model->Context->Coordinator->持久化文件的流转逻辑。
其核心组件包括:
- NSManagedObjectModel(数据模型):等同于数据库Schema,定义Entity(数据表)、Attribute(字段)、Relationship(表关联),是整个数据体系的结构基础。
Schema:数据库中表、视图、索引、存储过程等数据库对象的集合,相当于数据库内部的命名空间。
- NSManagedObjectContext(托管上下文/MOC):数据操作的核心工作区,负责追踪数据变更、管理托管对象生命周期、执行数据的增删改查、提交保存事务。
- NSPersistentStoreCoordinator(持久化协调器/PSC):中间调度层,衔接上下文与底层存储,屏蔽不同存储类型(SQLite/二进制/XML)的差异,开发者无需直接操作。
- NSManagedObject(托管对象):数据实体实例,对应数据库中的单条数据记录,通过KVC完成字段赋值与取值。
NSPersistentContainer:iOS10+推出的整合容器,一键封装核心组件,简化Core Data初始化配置。
Core Data核心组件
- NSManagedObjectModel
数据模型对应数据库Schema,无任何业务逻辑,只负责定义数据结构与关联关系。
模型的核心结构有:
- Entity:实体。对应数据库数据表。
- Attribute:属性、字段。实体的具体字段,支持各种数据类型。
- Relationship:关联关系。实体与实体之间的关联,支持一对一、一对多、多对多,对应数据库外键关联。
- Fetched Property:查询属性。预定义查询规则,无需重复写查询条件,提升复用性。
数据模型有两种创建方式:
- .xcdatamodeld文件:Xcode手动创建Data Model文件,编译后自动生成.momd文件,代码读取该文件加载模型。
- 纯代码动态构建:适合解决多人协作git文件合并出现冲突问题。
我自己和别人协作的MemoryCity的项目里就使用了纯代码构建的方式,这样不依赖NSManagedObject子类,不生成任何托管对象子类,后续所有读写操作数据统一使用KVC。
-(NSManagedObjectModel*)managedObjectModel{// 初始化模型对象NSManagedObjectModel*model=[[NSManagedObjectModel alloc]init];// 初始化Entity实体NSEntityDescription*cachedPostEntity=[[NSEntityDescription alloc]init];cachedPostEntity.name=kYALCachedPostEntityName;cachedPostEntity.managedObjectClassName=@"NSManagedObject";// 创建Attribute字段NSMutableArray<NSAttributeDescription*>*attributes=[NSMutableArray array];[attributes addObject:[selfstringAttributeWithName:@"cacheScope"]];// ...添加多个属性// 绑定字段到实体cachedPostEntity.properties=attributes;// 将实体加入模型model.entities=@[cachedPostEntity];returnmodel;}- NSManagedObjectContext
MOC是Core Data中管理托管对象生命周期和数据库持久化的核心组件。所有数据的增删改查都必须依托上下文完成,即内存中的数据草稿区。数据变更现在内存中生效,调用save:后才真正持久化到磁盘。
MOC核心特性:
- 事务支持:MOC支持事务操作,可以确保数据的一致性和完整性,开发者可以使用它执行批量的数据插入、更新等操作。
- 缓存机制 :MOC提供了一个内存中的对象缓存,所有对数据的操作首先在缓存中进行,这样可以避免频繁的磁盘I/O操作,提升性能。
- 变更追踪 :MOC能够追踪对数据模型所做的更改,并管理相关对象的生命周期,这简化了数据同步和更新的过程。
- 非线程安全:内部无同步锁保护,严禁跨线程操作,多线程需单独创建子上下文。
获取主线程上下文示例:
@interfaceSceneDelegate()@end@implementationSceneDelegate@synthesizepersistentContainer=_persistentContainer;-(NSPersistentContainer*)persistentContainer{if(_persistentContainer==nil){// 创建Core Data容器并加载数据模型,"ModelName"为.xcdatamodeld文件名字// iOS10+后,NSPersistentContainer内部帮我们创建好model、PSC、MOC_persistentContainer=[[NSPersistentContainer alloc]initWithName:@"ModelName"];// 打开数据库,loadPersistentStores内部为我们完成了:// 1. 找SQLite文件,没有就创建并打开// 2. 创建Persistent Store持久化仓库,连接起来PSC// 3. 建立映射,将定义的Entity存储类型为SQLite,Core Data将每个Entity自动映射为一张Table数据表,所有SQL语句在由Core Data在内部自动生成,持计划仓库读写这份SQLite文件// 4. 完成后回调:p1:表示当前加载的Store描述(如SQLite文件位置、是否只读等等) p2:表示是否加载打开数据库失败[_persistentContainer loadPersistentStoresWithCompletionHandler:^(NSPersistentStoreDescription*storeDescription,NSError*error){if(error!=nil){}}];// 自动合并父子上下文变更_persistentContainer.viewContext.automaticallyMergesChangesFromParent=YES;}return_persistentContainer;}这里主要通过NSPersistentContainer获取,第一次访问创建并加载,第二次访问直接返回,类似懒加载模式。
其中viewContext在主线程,主要用于界面相关的数据读取和更新。
设置automaticallyMergesChangesFromParent为YES的意义在于:当后台MOC保存数据后,主线程viewContext可以自动合并这些改动,避免界面显示旧数据,可同步前后台上下文数据。
- NSPersistentStoreCoordinator
PSC是Core Data底层调度核心,负责衔接上下文与本地持久化文件,屏蔽掉SQLite、二进制和内存等不同存储类型的差异。其支持的存储类型有:
- NSSQLiteStoreType:默认存储,最常用。基于SQLite数据库,支持负责查询和事务。
- NSBinaryStoreType:二进制文件存储,适合轻量数据。读写速度快,但不支持复杂查询。
- NSInMemoryStoreType:内存存储,适合临时缓存数据。数据断电会丢失。
- NSXMLStoreType:XML文件存储。仅macOS支持,iOS已废弃。
一般情况下,无需手动调用,容器和上下文会自动封装。上面获取主线程上下文的demo里就是通过NSPersistentContainer已经封装好的示例。
手动配置demo:
整个过程其实就是先创建好模型然后关联给PSC,再创建并添加给PSC数据库,最终达到Model、PSC和SQLite关联起来的效果。
// 创建模型NSManagedObjectModel*model=[selfmanagedObjectModel];// 用模型创建PSCNSPersistentStoreCoordinator*coordinator=[[NSPersistentStoreCoordinator alloc]initWithManagedObjectModel:model];// 获取数据库存储路径NSURL*storeURL=[[NSFileManager defaultManager]URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask].lastObject;storeURL=[storeURL URLByAppendingPathComponent:@"CoreDataDemo.sqlite"];// 创建数据库配置// p1:是否允许自动迁移数据,YES表示Core Data会尝试自动升级数据库 p2:是否自动推断MappingModel,YES表示Core Data会自己从旧字段生成为新字段NSDictionary*options=@{NSMigratePersistentStoresAutomaticallyOption:@YES,NSInferMappingModelAutomaticallyOption:@YES};NSError*error=nil;// 给PSC添加数据库if(![coordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeURL options:options error:&error]){NSLog(@"PSC配置失败:%@",error.localizedDescription);}- NSManagedObject
NSManagedObject是数据实体的运行实例,对应数据库里单条数据记录,所有操作使用KVC。
常用API:
valueForKey::获取字段值setValue:forKey::设置字段值objectID:获取数据唯一标识,可用于精准查询entity:获取当前关联的实体描述
Core Data增删改查
- 新增数据
核心步骤为:获取MOC,通过insertNewObjectForEntityForName:inManagedObjectContext:创建实体对象,并使用KVC赋值,最后调用save:持久化数据。
-(void)insertCoreData{NSManagedObjectContext*context=[selfcreateContext];// 创建实体对象NSManagedObject*student=[NSEntityDescription insertNewObjectForEntityForName:@"Student"inManagedObjectContext:context];// 赋值[student setValue:@"lyd"forKey:@"name"];[student setValue:@19forKey:@"age"];// 保存数据NSError*error=nil;if([context save:&error]){NSLog(@"新增数据成功");}else{NSLog(@"新增数据失败:%@",error.localizedDescription);}}这里会遇到一个问题,大量数据在主线程进行新增保存操作,会使得使得主线程堵塞卡顿。我们使用后台Context在子线程新增保存,最后同步到主线程来解决。
NSManagedObjectContext*context=[[NSManagedObjectContext alloc]initWithConcurrencyType:NSPrivateQueueConcurrencyType];NSManagedObjectContextConcurrencyType枚举值:
- NSMainQueueConcurrencyType:主线程上下文。创建后绑定主线程,必须在主线程操作。
- NSPrivateQueueConcurrencyType:私有队列上下文。拥有独立串行队列,所有操作必须使用
performBlock:或performBlockAndWait:。
Core Data是线程不安全的,Core Data要求所有操作必须跑在MOC自己的队列里,GCD队列无法和Core Data内部事务时序对齐。因此这里必须使用
performBlock:或performBlockAndWait:。
performBlock::异步。不阻塞当前线程,适合后台批量写入和异步查询。performBlockAndWait::同步。阻塞调用方,等数据库操作完成后返回。无论异步或者同步,其本质都是把block提交给上下文自身持有的串行队列执行。
- 查询数据
主要基于NSFetchRequest实现,支持条件查询、排序和分页。
-(NSArray*)fetchAllStudent{NSManagedObjectContext*context=[selfmainContext];// 创建查询请求,指定实体NSFetchRequest*request=[[NSFetchRequest alloc]initWithEntityName:@"Student"];// 条件request.predicate=[NSPredicate predicateWithFormat:@"age > %d",age];// 升序request.sortDescriptors=@[[NSSortDescriptor sortDescriptorWithKey:@"age"ascending:YES]];// 分页request.fetchLimit=20;request.fetchOffset=0;NSError*error=nil;NSArray*resultArray=[context executeFetchRequest:request error:&error];if(error){NSLog(@"查询失败:%@",error.localizedDescription);returnnil;}returnresultArray;}- 更新数据
核心逻辑为先查询、再修改、最后保存,修改内存中托管对象属性,保存后同步到磁盘。
-(void)updateStudentData{NSManagedObjectContext*context=[selfmainContext];NSFetchRequest*request=[[NSFetchRequest alloc]initWithEntityName:@"Student"];// NSPredicate:谓词,用来定义过滤条件NSPredicate*predicate=[NSPredicate predicateWithFormat:@"name == %@",@"lyd"];request.predicate=predicate;NSError*error=nil;NSArray*result=[context executeFetchRequest:request error:&error];// 修改匹配到的第一条数据if(result.count>0){NSManagedObject*student=result.firstObject;[student setValue:@20forKey:@"age"];// 保存更新[context save:&error];NSLog(@"数据更新成功");}}- 删除数据
-(void)deleteStudentData{NSManagedObjectContext*context=[selfmainContext];NSFetchRequest*request=[[NSFetchRequest alloc]initWithEntityName:@"Student"];NSPredicate*predicate=[NSPredicate predicateWithFormat:@"age == %d",20];request.predicate=predicate;NSError*error=nil;NSArray*result=[context executeFetchRequest:request error:&error];if(result.count>0){[context deleteObject:result.firstObject];[context save:&error];NSLog(@"数据删除成功");}}