10-NSPersistentContainer介绍

版权声明：本文为博主原创文章，未经博主允许不得转载。

• 以下内容，主要根据本人多年开发经验翻译自苹果官方文档https://developer.apple.com/reference/coredata/nspersistentcontainer?language=objc

 

• 1.NSPersistentContainer

  • NSPersistentContainer是一个容器,封装了应用程序中的CoreData Stack（核心数据栈堆）

• 2.概述

  • NSPersistentContainer简化了创建和管理的核心堆栈的数据处理创建NSManagedObjectModel，NSPersistentStoreCoordinator,NSManagedObjectContext

• 3.API介绍

• 实例化

/**类方法创建NSPersistentContainer
* name:表示保存的数据库文件名称
* 使用此方法创建NSPersistentContainer，默认模型文件名称为name
*/
+ (instancetype)persistentContainerWithName:(NSString *)name;
/**类方法创建NSPersistentContainer
* name:表示保存的数据库文件名称
* model：对象管理模型
*/
+ (instancetype)persistentContainerWithName:(NSString *)name managedObjectModel:(NSManagedObjectModel *)model


//以下两个为实例方法，使用和参数同上
- (instancetype)initWithName:(NSString *)name;

- (instancetype)initWithName:(NSString *)name managedObjectModel:(NSManagedObjectModel *)model

 

属性信息

 

//返回沙盒中存储数据库的文件夹URL路径，这是一个静态方法，表示数据库的文件夹路径是唯一的，并且奇妙的是：这个文件夹是动态创建的（Library->Application Support）
+ (NSURL *)defaultDirectoryURL;
//只读属性，当前NSPersistentContainer容器的名称
@property (copy, readonly) NSString *name;
//只读属性，自动生成的管理对象上下文，这个上下文默认的操作类型是NSMainQueueConcurrencyType主线程
@property (strong, readonly) NSManagedObjectContext *viewContext;
//只读属性，对象管理模型
@property (strong, readonly) NSManagedObjectModel *managedObjectModel;
//只读属性，存储调度器
@property (strong, readonly) NSPersistentStoreCoordinator *persistentStoreCoordinator;
//存储器描述数组），内部进行了copy处理，无需担心内存安全
@property (copy) NSArray<NSPersistentStoreDescription *> *persistentStoreDescriptions;

配置信息

 

 

//加载存储器，此方法必须要调用，否则无法存储数据
//block中NSPersistentStoreDescription用于描述生成的存储器信息，如：数据库文件路径、存储类型等  NSError用于描述加载存储器是否成功或失败信息
- (void)loadPersistentStoresWithCompletionHandler:(void (^)(NSPersistentStoreDescription *, NSError * _Nullable))block;

//返回一个基于多线程的管理对象上下文，我们无需关心多线程的内部实现以及线程安全，由NSPersistentContainer新创建一个
//此方法非常牛逼，调用这个方法之后，对返回的上下文做一些数据的处理都是在子线程中完成的，可以用于处理对数据库进行大量数据操作的场景
- (NSManagedObjectContext *)newBackgroundContext NS_RETURNS_RETAINED;

//使用存储调度器快速在多线程中操作数据库，效率非常高(比主线程操作块50倍！！！)
- (void)performBackgroundTask:(void (^)(NSManagedObjectContext *))block;