該文章屬于劉小壯原創(chuàng),轉(zhuǎn)載請注明:劉小壯
在之前的文章中姨俩,已經(jīng)講了很多關(guān)于
CoreData
使用相關(guān)的知識點(diǎn)。這篇文章中主要講兩個(gè)方面朗儒,NSFetchedResultsController
和版本遷移查坪。文章題目中雖然有“高級”兩個(gè)字,其實(shí)講的東西并不高級歧蒋,只是因?yàn)樯弦黄恼轮袞|西太多了土砂,把兩個(gè)較復(fù)雜的知識點(diǎn)挪到這篇文章中。??
文章中如有疏漏或錯(cuò)誤谜洽,還請各位及時(shí)提出萝映,謝謝!??
NSFetchedResultsController
在開發(fā)過程中會經(jīng)常用到UITableView
這樣的視圖類阐虚,這些視圖類需要自己管理其數(shù)據(jù)源序臂,包括網(wǎng)絡(luò)獲取、本地存儲都需要寫代碼進(jìn)行管理实束。
而在CoreData
中提供了NSFetchedResultsController
類(fetched results controller
奥秆,也叫FRC
)逊彭,FRC
可以管理UITableView
或UICollectionView
的數(shù)據(jù)源吭练。這個(gè)數(shù)據(jù)源主要指本地持久化的數(shù)據(jù)诫龙,也可以用這個(gè)數(shù)據(jù)源配合著網(wǎng)絡(luò)請求數(shù)據(jù)一起使用,主要看業(yè)務(wù)需求了鲫咽。
本篇文章會使用UITableView
作為視圖類签赃,配合NSFetchedResultsController
進(jìn)行后面的演示,UICollectionView
配合NSFetchedResultsController
的使用也是類似分尸,這里就不都講了锦聊。
簡單介紹
就像上面說到的,NSFetchedResultsController
就像是上面兩種視圖的數(shù)據(jù)管理者一樣箩绍。FRC
可以監(jiān)聽一個(gè)MOC
的改變孔庭,如果MOC
執(zhí)行了托管對象的增刪改操作,就會對本地持久化數(shù)據(jù)發(fā)生改變材蛛,FRC
就會回調(diào)對應(yīng)的代理方法圆到,回調(diào)方法的參數(shù)會包括執(zhí)行操作的類型、操作的值卑吭、indexPath
等參數(shù)芽淡。
實(shí)際使用時(shí),通過FRC
“綁定”一個(gè)MOC
豆赏,將UITableView
嵌入在FRC
的執(zhí)行流程中挣菲。在任何地方對這個(gè)“綁定”的MOC
存儲區(qū)做修改,都會觸發(fā)FRC
的回調(diào)方法掷邦,在FRC
的回調(diào)方法中嵌入UITableView
代碼并做對應(yīng)修改即可白胀。
由此可以看出FRC
最大優(yōu)勢就是,始終和本地持久化的數(shù)據(jù)保持統(tǒng)一抚岗。只要本地持久化的數(shù)據(jù)發(fā)生改變或杠,就會觸發(fā)FRC
的回調(diào)方法,從而在回調(diào)方法中更新上層數(shù)據(jù)源和UI
宣蔚。這種方式講的簡單一點(diǎn)廷痘,就可以叫做數(shù)據(jù)帶動(dòng)UI。
但是需要注意一點(diǎn)件已,在FRC
的初始化中傳入了一個(gè)MOC
參數(shù)笋额,FRC
只能監(jiān)測傳入的MOC
發(fā)生的改變。假設(shè)其他MOC
對同一個(gè)存儲區(qū)發(fā)生了改變篷扩,FRC
則不能監(jiān)測到這個(gè)變化兄猩,不會做出任何反應(yīng)。
所以使用FRC
時(shí),需要注意FRC
只能對一個(gè)MOC
的變化做出反應(yīng)枢冤,所以在CoreData
持久化層設(shè)計(jì)時(shí)鸠姨,盡量一個(gè)存儲區(qū)只對應(yīng)一個(gè)MOC
,或設(shè)置一個(gè)負(fù)責(zé)UI
的MOC
淹真,這在后面多線程部分會詳細(xì)講解讶迁。
修改模型文件結(jié)構(gòu)
在寫代碼之前,先對之前的模型文件結(jié)構(gòu)做一些修改核蘸。
講FRC
的時(shí)候巍糯,只需要用到Employee
這一張表,其他表和設(shè)置直接忽略客扎。需要在Employee
原有字段的基礎(chǔ)上祟峦,增加一個(gè)String
類型的sectionName
字段,這個(gè)字段就是用來存儲section title
的徙鱼,在下面的文章中將會詳細(xì)講到宅楞。
初始化FRC
下面例子是比較常用的FRC
初始化方式,初始化時(shí)指定的MOC
袱吆,還用之前講過的MOC
初始化代碼厌衙,UITableView
初始化代碼這里也省略了,主要突出FRC
的初始化绞绒。
// 創(chuàng)建請求對象婶希,并指明操作Employee表
NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"Employee"];
// 設(shè)置排序規(guī)則,指明根據(jù)height字段升序排序
NSSortDescriptor *heightSort = [NSSortDescriptor sortDescriptorWithKey:@"height" ascending:YES];
request.sortDescriptors = @[heightSort];
// 創(chuàng)建NSFetchedResultsController控制器實(shí)例处铛,并綁定MOC
NSError *error = nil;
fetchedResultController = [[NSFetchedResultsController alloc] initWithFetchRequest:request
managedObjectContext:context
sectionNameKeyPath:@"sectionName"
cacheName:nil];
// 設(shè)置代理饲趋,并遵守協(xié)議
fetchedResultController.delegate = self;
// 執(zhí)行獲取請求拐揭,執(zhí)行后FRC會從持久化存儲區(qū)加載數(shù)據(jù)撤蟆,其他地方可以通過FRC獲取數(shù)據(jù)
[fetchedResultController performFetch:&error];
// 錯(cuò)誤處理
if (error) {
NSLog(@"NSFetchedResultsController init error : %@", error);
}
// 刷新UI
[tableView reloadData];
在上面初始化FRC
時(shí),傳入的sectionNameKeyPath:
參數(shù)堂污,是指明當(dāng)前托管對象的哪個(gè)屬性當(dāng)做section
的title
家肯,在本文中就是Employee
表的sectionName
字段為section
的title
。從NSFetchedResultsSectionInfo
協(xié)議的indexTitle
屬性獲取這個(gè)值盟猖。
在sectionNameKeyPath:
設(shè)置屬性名后讨衣,就以這個(gè)屬性名作為分組title
,相同的title
會被分到一個(gè)section
中式镐。
初始化FRC
時(shí)參數(shù)managedObjectContext:
傳入了一個(gè)MOC
參數(shù)反镇,FRC
只能監(jiān)測這個(gè)傳入的MOC
發(fā)生的本地持久化改變。就像上面介紹時(shí)說的娘汞,其他MOC
對同一個(gè)持久化存儲區(qū)發(fā)生的改變歹茶,FRC
則不能監(jiān)測到這個(gè)變化。
再往后面看到cacheName:
參數(shù),這個(gè)參數(shù)我設(shè)置的是nil
惊豺。參數(shù)的作用是開啟FRC
的緩存燎孟,對獲取的數(shù)據(jù)進(jìn)行緩存并指定一個(gè)名字∈粒可以通過調(diào)用deleteCacheWithName:
方法手動(dòng)刪除緩存揩页。
但是這個(gè)緩存并沒有必要,緩存是根據(jù)NSFetchRequest
對象來匹配的烹俗,如果當(dāng)前獲取的數(shù)據(jù)和之前緩存的相匹配則直接拿來用爆侣,但是在獲取數(shù)據(jù)時(shí)每次獲取的數(shù)據(jù)都可能不同,緩存不能被命中則很難派上用場衷蜓,而且緩存還占用著內(nèi)存資源累提。
在FRC
初始化完成后,調(diào)用performFetch:
方法來同步獲取持久化存儲區(qū)數(shù)據(jù)磁浇,調(diào)用此方法后FRC
保存數(shù)據(jù)的屬性才會有值斋陪。獲取到數(shù)據(jù)后,調(diào)用tableView
的reloadData
方法置吓,會回調(diào)tableView
的代理方法无虚,可以在tableView
的代理方法中獲取到FRC
的數(shù)據(jù)。調(diào)用performFetch:
方法第一次獲取到數(shù)據(jù)并不會回調(diào)FRC
代理方法衍锚。
代理方法
FRC
中包含UITableView
執(zhí)行過程中需要的相關(guān)數(shù)據(jù)友题,可以通過FRC
的sections
屬性,獲取一個(gè)遵守<NSFetchedResultsSectionInfo>
協(xié)議的對象數(shù)組戴质,數(shù)組中的對象就代表一個(gè)section
度宦。
在這個(gè)協(xié)議中有如下定義,可以看出這些屬性和UITableView
的執(zhí)行流程是緊密相關(guān)的告匠。
@protocol NSFetchedResultsSectionInfo
/* Name of the section */
@property (nonatomic, readonly) NSString *name;
/* Title of the section (used when displaying the index) */
@property (nullable, nonatomic, readonly) NSString *indexTitle;
/* Number of objects in section */
@property (nonatomic, readonly) NSUInteger numberOfObjects;
/* Returns the array of objects in the section. */
@property (nullable, nonatomic, readonly) NSArray *objects;
@end // NSFetchedResultsSectionInfo
在使用過程中應(yīng)該將FRC
和UITableView
相互嵌套戈抄,在FRC
的回調(diào)方法中嵌套UITableView
的視圖改變邏輯,在UITableView
的回調(diào)中嵌套數(shù)據(jù)更新的邏輯后专。這樣可以始終保證數(shù)據(jù)和UI的同步划鸽,在下面的示例代碼中將會演示FRC
和UITableView
的相互嵌套。
Table View Delegate
// 通過FRC的sections數(shù)組屬性戚哎,獲取所有section的count值
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return fetchedResultController.sections.count;
}
// 通過當(dāng)前section的下標(biāo)從sections數(shù)組中取出對應(yīng)的section對象裸诽,并從section對象中獲取所有對象count
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return fetchedResultController.sections[section].numberOfObjects;
}
// FRC根據(jù)indexPath獲取托管對象,并給cell賦值
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
Employee *emp = [fetchedResultController objectAtIndexPath:indexPath];
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"identifier" forIndexPath:indexPath];
cell.textLabel.text = emp.name;
return cell;
}
// 創(chuàng)建FRC對象時(shí)型凳,通過sectionNameKeyPath:傳遞進(jìn)去的section title的屬性名丈冬,在這里獲取對應(yīng)的屬性值
- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
return fetchedResultController.sections[section].indexTitle;
}
// 是否可以編輯
- (BOOL)tableView:(UITableView *)tableView canEditRowAtIndexPath:(NSIndexPath *)indexPath {
return YES;
}
// 這里是簡單模擬UI刪除cell后,本地持久化區(qū)數(shù)據(jù)和UI同步的操作甘畅。在調(diào)用下面MOC保存上下文方法后埂蕊,F(xiàn)RC會回調(diào)代理方法并更新UI
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
// 刪除托管對象
Employee *emp = [fetchedResultController objectAtIndexPath:indexPath];
[context deleteObject:emp];
// 保存上下文環(huán)境实夹,并做錯(cuò)誤處理
NSError *error = nil;
if (![context save:&error]) {
NSLog(@"tableView delete cell error : %@", error);
}
}
}
上面是UITableView
的代理方法绳泉,代理方法中嵌套了FRC
的數(shù)據(jù)獲取代碼供璧,這樣在刷新視圖時(shí)就可以保證使用最新的數(shù)據(jù)。并且在代碼中簡單實(shí)現(xiàn)了刪除cell
后拷姿,通過MOC
調(diào)用刪除操作匀们,使本地持久化數(shù)據(jù)和UI
保持一致缴淋。
就像上面cellForRowAtIndexPath:
方法中使用的一樣,FRC
提供了兩個(gè)方法輕松轉(zhuǎn)換indexPath
和NSManagedObject
的對象泄朴,在實(shí)際開發(fā)中這兩個(gè)方法非常實(shí)用重抖,這也是FRC
和UITableView
、UICollectionView
深度融合的表現(xiàn)祖灰。
- (id)objectAtIndexPath:(NSIndexPath *)indexPath;
- (nullable NSIndexPath *)indexPathForObject:(id)object;
Fetched Results Controller Delegate
// Cell數(shù)據(jù)源發(fā)生改變會回調(diào)此方法钟沛,例如添加新的托管對象等
- (void)controller:(NSFetchedResultsController *)controller didChangeObject:(id)anObject atIndexPath:(nullable NSIndexPath *)indexPath forChangeType:(NSFetchedResultsChangeType)type newIndexPath:(nullable NSIndexPath *)newIndexPath {
switch (type) {
case NSFetchedResultsChangeInsert:
[tableView insertRowsAtIndexPaths:@[newIndexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
case NSFetchedResultsChangeDelete:
[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
case NSFetchedResultsChangeMove:
[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
[tableView insertRowsAtIndexPaths:@[newIndexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
case NSFetchedResultsChangeUpdate: {
UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
Employee *emp = [fetchedResultController objectAtIndexPath:indexPath];
cell.textLabel.text = emp.name;
}
break;
}
}
// Section數(shù)據(jù)源發(fā)生改變回調(diào)此方法,例如修改section title等局扶。
- (void)controller:(NSFetchedResultsController *)controller didChangeSection:(id <NSFetchedResultsSectionInfo>)sectionInfo atIndex:(NSUInteger)sectionIndex forChangeType:(NSFetchedResultsChangeType)type {
switch (type) {
case NSFetchedResultsChangeInsert:
[tableView insertSections:[NSIndexSet indexSetWithIndex:sectionIndex] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
case NSFetchedResultsChangeDelete:
[tableView deleteSections:[NSIndexSet indexSetWithIndex:sectionIndex] withRowAnimation:UITableViewRowAnimationAutomatic];
break;
default:
break;
}
}
// 本地?cái)?shù)據(jù)源發(fā)生改變恨统,將要開始回調(diào)FRC代理方法。
- (void)controllerWillChangeContent:(NSFetchedResultsController *)controller {
[tableView beginUpdates];
}
// 本地?cái)?shù)據(jù)源發(fā)生改變三妈,F(xiàn)RC代理方法回調(diào)完成畜埋。
- (void)controllerDidChangeContent:(NSFetchedResultsController *)controller {
[tableView endUpdates];
}
// 返回section的title,可以在這里對title做進(jìn)一步處理畴蒲。這里修改title后悠鞍,對應(yīng)section的indexTitle屬性會被更新。
- (nullable NSString *)controller:(NSFetchedResultsController *)controller sectionIndexTitleForSectionName:(NSString *)sectionName {
return [NSString stringWithFormat:@"sectionName %@", sectionName];
}
上面就是當(dāng)本地持久化數(shù)據(jù)發(fā)生改變后模燥,被回調(diào)的FRC
代理方法的實(shí)現(xiàn)咖祭,可以在對應(yīng)的實(shí)現(xiàn)中完成自己的代碼邏輯。
在上面的章節(jié)中講到刪除cell
后蔫骂,本地持久化數(shù)據(jù)同步的問題么翰。在刪除cell
后在tableView
代理方法的回調(diào)中,調(diào)用了MOC
的刪除方法纠吴,使本地持久化存儲和UI
保持同步硬鞍,并回調(diào)到下面的FRC
代理方法中慧瘤,在代理方法中對UI
做刪除操作戴已,這樣一套由UI的改變引發(fā)的刪除流程就完成了。
目前為止已經(jīng)實(shí)現(xiàn)了數(shù)據(jù)和UI
的雙向同步锅减,即UI
發(fā)生改變后本地存儲發(fā)生改變糖儡,本地存儲發(fā)生改變后UI
也隨之改變≌唬可以通過下面添加數(shù)據(jù)的代碼來測試一下握联,NSFetchedResultsController
就講到這里了桦沉。
- (void)addMoreData {
Employee *employee = [NSEntityDescription insertNewObjectForEntityForName:@"Employee" inManagedObjectContext:context];
employee.name = [NSString stringWithFormat:@"lxz 15"];
employee.height = @(15);
employee.brithday = [NSDate date];
employee.sectionName = [NSString stringWithFormat:@"3"];
NSError *error = nil;
if (![context save:&error]) {
NSLog(@"MOC save error : %@", error);
}
}
版本遷移
CoreData
版本遷移的方式有很多,一般都是先在Xcode
中金闽,原有模型文件的基礎(chǔ)上纯露,創(chuàng)建一個(gè)新版本的模型文件,然后在此基礎(chǔ)上做不同方式的版本遷移代芜。
本章節(jié)將會講三種不同的版本遷移方案埠褪,但都不會講太深,都是從使用的角度講起挤庇,可以滿足大多數(shù)版本遷移的需求钞速。
為什么要版本遷移?
在已經(jīng)運(yùn)行程序并通過模型文件生成數(shù)據(jù)庫后嫡秕,再對模型文件進(jìn)行的修改渴语,如果只是修改已有實(shí)體屬性的默認(rèn)值、最大最小值昆咽、Fetch Request
等屬性自身包含的參數(shù)時(shí)驾凶,并不會發(fā)生錯(cuò)誤。如果修改模型文件的結(jié)構(gòu)掷酗,或修改屬性名狭郑、實(shí)體名等,造成模型文件的結(jié)構(gòu)發(fā)生改變汇在,這樣再次運(yùn)行程序就會導(dǎo)致崩潰翰萨。
在開發(fā)測試過程中,可以直接將原有程序卸載就可以解決這個(gè)問題糕殉,但是本地之前存儲的數(shù)據(jù)也會消失亩鬼。如果是線上程序,就涉及到版本遷移的問題阿蝶,否則會導(dǎo)致崩潰雳锋,并提示如下錯(cuò)誤:
CoreData: error: Illegal attempt to save to a file that was never opened. "This NSPersistentStoreCoordinator has no persistent stores (unknown). It cannot perform a save operation.". No last error recorded.
然而在需求不斷變化的過程中,后續(xù)版本肯定會對原有的模型文件進(jìn)行修改羡洁,這時(shí)就需要用到版本遷移的技術(shù)玷过,下面開始講版本遷移的方案。
創(chuàng)建新版本模型文件
本文中講的幾種版本遷移方案筑煮,在遷移之前都需要對原有的模型文件創(chuàng)建新版本辛蚊。
選中需要做遷移的模型文件 -> 點(diǎn)擊菜單欄Editor -> Add Model Version -> 選擇基于哪個(gè)版本的模型文件(一般都是選擇目前最新的版本),新建模型文件完成真仲。
對于新版本模型文件的命名袋马,我在創(chuàng)建新版本模型文件時(shí),一般會拿當(dāng)前工程版本號當(dāng)做后綴秸应,這樣在模型文件版本比較多的時(shí)候虑凛,就可以很容易將模型文件版本和工程版本對應(yīng)起來碑宴。
添加完成后,會發(fā)現(xiàn)之前的模型文件會變成一個(gè)文件夾桑谍,里面包含著多個(gè)模型文件延柠。
在新建的模型文件中,里面的文件結(jié)構(gòu)和之前的文件結(jié)構(gòu)相同锣披。后續(xù)的修改都應(yīng)該在新的模型文件上捕仔,之前的模型文件不要再動(dòng)了,在修改完模型文件后盈罐,記得更新對應(yīng)的模型類文件榜跌。
基于新的模型文件,對Employee
實(shí)體做如下修改盅粪,下面的版本遷移也以此為例钓葫。
添加一個(gè)String
類型的屬性,設(shè)置屬性名為sectionName
票顾。
此時(shí)還應(yīng)該選中模型文件础浮,設(shè)置當(dāng)前模型文件的版本。這里選擇將最新版本設(shè)置為剛才新建的1.1.0版本
奠骄,模型文件設(shè)置工作完成豆同。
Show The File Inspector -> Model Version -> Current 設(shè)置為最新版本。
對模型文件的設(shè)置已經(jīng)完成了含鳞,接下來系統(tǒng)還要知道我們想要怎樣遷移數(shù)據(jù)影锈。在遷移過程中可能會存在多種可能,蘋果將這個(gè)靈活性留給了我們完成蝉绷。剩下要做的就是編寫遷移方案以及細(xì)節(jié)的代碼鸭廷。
輕量級版本遷移
輕量級版本遷移方案非常簡單,大多數(shù)遷移工作都是由系統(tǒng)完成的熔吗,只需要告訴系統(tǒng)遷移方式即可辆床。在持久化存儲協(xié)調(diào)器(PSC
)初始化對應(yīng)的持久化存儲(NSPersistentStore
)對象時(shí),設(shè)置options
參數(shù)即可桅狠,參數(shù)是一個(gè)字典讼载。PSC
會根據(jù)傳入的字典,自動(dòng)推斷版本遷移的過程中跌。
字典中設(shè)置的key:
NSMigratePersistentStoresAutomaticallyOption
設(shè)置為YES
咨堤,CoreData
會試著把低版本的持久化存儲區(qū)遷移到最新版本的模型文件。NSInferMappingModelAutomaticallyOption
設(shè)置為YES
晒他,CoreData
會試著以最為合理地方式自動(dòng)推斷出源模型文件的實(shí)體中吱型,某個(gè)屬性到底對應(yīng)于目標(biāo)模型文件實(shí)體中的哪一個(gè)屬性逸贾。
版本遷移的設(shè)置是在創(chuàng)建MOC
時(shí)給PSC
設(shè)置的陨仅,為了使代碼更直觀津滞,下面只給出發(fā)生變化部分的代碼,其他MOC
的初始化代碼都不變灼伤。
// 設(shè)置版本遷移方案
NSDictionary *options = @{NSMigratePersistentStoresAutomaticallyOption : @YES,
NSInferMappingModelAutomaticallyOption : @YES};
// 創(chuàng)建持久化存儲協(xié)調(diào)器触徐,并將遷移方案的字典當(dāng)做參數(shù)傳入
[coordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:[NSURL fileURLWithPath:dataPath] options:options error:nil];
修改實(shí)體名
假設(shè)需要對已存在實(shí)體進(jìn)行改名操作,需要將重命名后的實(shí)體Renaming ID
狐赡,設(shè)置為之前的實(shí)體名撞鹉。下面是Employee
實(shí)體進(jìn)行操作。
修改后再使用實(shí)體時(shí)颖侄,應(yīng)該將實(shí)體名設(shè)為最新的實(shí)體名鸟雏,這里也就是Employee2
,而且數(shù)據(jù)庫中的數(shù)據(jù)也會遷移到Employee2
表中览祖。
Employee2 *emp = [NSEntityDescription insertNewObjectForEntityForName:@"Employee2" inManagedObjectContext:context];
emp.name = @"lxz";
emp.brithday = [NSDate date];
emp.height = @1.9;
[context save:nil];
Mapping Model 遷移方案
輕量級遷移方案只是針對增加和改變實(shí)體孝鹊、屬性這樣的一些簡單操作,假設(shè)有更復(fù)雜的遷移需求展蒂,就應(yīng)該使用Xcode
提供的遷移模板(Mapping Model
)又活。通過Xcode
創(chuàng)建一個(gè)后綴為.xcmappingmodel
的文件,這個(gè)文件是專門用來進(jìn)行數(shù)據(jù)遷移用的锰悼,一些變化關(guān)系也會體現(xiàn)在模板中柳骄,看起來非常直觀。
這里還以上面更改實(shí)體名箕般,并遷移實(shí)體數(shù)據(jù)為例子耐薯,將Employee
實(shí)體遷移到Employee2
中。首先將Employee
實(shí)體改名為Employee2
丝里,然后創(chuàng)建Mapping Model
文件可柿。
Command + N 新建文件 -> 選擇 Mapping Model -> 選擇源文件 Source Model -> 選擇目標(biāo)文件 Target Model -> 命名 Mapping Model 文件名 -> Create 創(chuàng)建完成。
現(xiàn)在就創(chuàng)建好一個(gè)Mapping Model
文件丙者,文件中顯示了實(shí)體复斥、屬性、Relationships
械媒,源文件和目標(biāo)文件之間的關(guān)系目锭。實(shí)體命名是EntityToEntity
的方式命名的,實(shí)體包含的屬性和關(guān)聯(lián)關(guān)系纷捞,都會被添加到遷移方案中(Entity Mapping
痢虹,Attribute Mapping
,Relationship Mapping
)主儡。
在遷移文件的下方是源文件和目標(biāo)文件的關(guān)系奖唯。
在上面圖中改名后的Employee2
實(shí)體并沒有遷移關(guān)系,由于是改名后的實(shí)體糜值,系統(tǒng)還不知道實(shí)體應(yīng)該怎樣做遷移丰捷。所以選中Mapping Model
文件的Employee2 Mappings
坯墨,可以看到右側(cè)邊欄的Source
為invalid value
。因?yàn)橐獜?code>Employee實(shí)體遷移數(shù)據(jù)過來病往,所以將其選擇為Employee
捣染,遷移關(guān)系就設(shè)置完成了。
設(shè)置完成后停巷,還應(yīng)該將之前EmployeeToEmployee
的Mappings
刪除耍攘,因?yàn)檫@個(gè)實(shí)體已經(jīng)被Employee2
替代,它的Mappings
也被Employee2 Mappings
所替代畔勤,否則會報(bào)錯(cuò)蕾各。
在實(shí)體的遷移過程中,還可以通過設(shè)置Predicate
的方式庆揪,來簡單的控制遷移過程示损。例如只需要遷移一部分指定的數(shù)據(jù),就可以通過Predicate
來指定嚷硫〖旆茫可以直接在右側(cè)Filter Predicate
的位置設(shè)置過濾條件,格式是$source.height < 100
仔掸,$source
代表數(shù)據(jù)源的實(shí)體脆贵。
更復(fù)雜的遷移需求
如果還存在更復(fù)雜的遷移需求,而且上面的遷移方式不能滿足起暮,可以考慮更復(fù)雜的遷移方式卖氨。假設(shè)要在遷移過程中,對遷移的數(shù)據(jù)進(jìn)行更改负懦,這時(shí)候上面的遷移方案就不能滿足需求了筒捺。
對于上面提到的問題,在Mapping Model
文件中選中實(shí)體纸厉,可以看到Custom Policy
這個(gè)選項(xiàng)系吭,選項(xiàng)對應(yīng)的是NSEntityMigrationPolicy
的子類,可以創(chuàng)建并設(shè)置一個(gè)子類颗品,并重寫這個(gè)類的方法來控制遷移過程肯尺。
- (BOOL)createDestinationInstancesForSourceInstance:(NSManagedObject *)sInstance entityMapping:(NSEntityMapping *)mapping manager:(NSMigrationManager *)manager error:(NSError **)error;
版本遷移總結(jié)
版本遷移在需求的變更中肯定是要發(fā)生的,但是我們應(yīng)該盡量避免這樣的情況發(fā)生躯枢。在最開始設(shè)計(jì)模型文件數(shù)據(jù)結(jié)構(gòu)的時(shí)候则吟,就應(yīng)該設(shè)計(jì)一個(gè)比較完善并且容易應(yīng)對變化的結(jié)構(gòu),這樣后面就算發(fā)生變化也不會對結(jié)構(gòu)主體造成大的改動(dòng)锄蹂。
好多同學(xué)都問我有Demo
沒有氓仲,其實(shí)文章中貼出的代碼組合起來就是個(gè)Demo
。后來想了想,還是給本系列文章配了一個(gè)簡單的Demo
敬扛,方便大家運(yùn)行調(diào)試晰洒,后續(xù)會給所有博客的文章都加上Demo
。
Demo
只是來輔助讀者更好的理解文章中的內(nèi)容舔哪,應(yīng)該博客結(jié)合Demo
一起學(xué)習(xí)欢顷,只看Demo
還是不能理解更深層的原理槽棍。Demo
中幾乎每一行代碼都會有注釋捉蚤,各位可以打斷點(diǎn)跟著Demo
執(zhí)行流程走一遍,看看各個(gè)階段變量的值炼七。
Demo地址:劉小壯的Github
這兩天更新了一下文章缆巧,將CoreData
系列的六篇文章整合在一起,做了一個(gè)PDF
版的《CoreData Book》豌拙,放在我Github上了陕悬。PDF
上有文章目錄,方便閱讀按傅。
如果你覺得不錯(cuò)捉超,請把PDF幫忙轉(zhuǎn)到其他群里,或者你的朋友唯绍,讓更多的人了解CoreData拼岳,衷心感謝!??