《Core Data应用开发实践指南》一3.4　默认的迁移方式

本节书摘来自华章出版社《Core Data应用开发实践指南》一书中的第3章，第3.4节，作者 （美）Tim Roadley，更多章节内容可以访问云栖社区“华章计算机”公众号查看

3.4　默认的迁移方式

有时候我们需要比轻量级迁移更为精细的控制手段。比方说，我们要把Measurement实体替换成另外一个名叫Amount的实体，并且还想把Measurement实体中名叫abc的那个属性迁移到Amount实体中的xyz 属性上面。abc中已有的数据也要迁移到xyz属性。为了完成这些需求，开发者需要创建模型映射，以便手工指明映射关系。在添加持久化存储区时，即便NSInferMappingModelAutomaticallyOption选项设为YES，Core Data也还是会先检测有没有文件，如果有的话，那么在执行自动推断之前，它会先试着使用这个文件来迁移。在测试映射模型之前，建议先禁用该选项，这样才可以确定映射模型是不是已经付诸使用并且能够正常运作了。
请按下列步骤修改Grocery Dude，以禁用自动化模型映射功能：
修改CoreDataHelper.m文件中的loadStore方法，把NSInferMappingModelAutomaticallyOption设为@NO。
请按下列步骤修改Grocery Dude，以便添加新模型，为从Measurement实体迁移到Amount实体做准备：

1. 可以先抓取一份快照或备份整个项目。
2. 根据Model 2版本来创建新版模型，将其命名为Model 3。
3. 选中Model 3.xcdatamodel。
4. 删除Measurement实体。
5. 新建Amount实体，并向其中添加类型为String的xyz属性。
6. 根据Amount实体创建NSManagedObject子类。在保存类文件这个步骤中，别忘了勾选targets中的“Grocery Dude”。
7. 将Model 3设为当前模型版本。
8. 运行应用程序，目前它应该出错并崩溃。错误信息如图3-5所示。

为了解决图3-5中的错误，我们需要创建映射模型，以指明字段之间的映射关系。具体到本例来说，就是要把旧模型中Measurement实体的abc属性迁移为新模型中Amount实体的xyz 属性。
请按下列步骤修改Grocery Dude，以添加新的映射模型：

1. 确保Data Model 组处于选中状态。
2. 点击File＞New＞File...菜单项。
3. 选择iOS＞Core Data＞Mapping Model，并点击Next按钮。
4. 把Model 2.xcdatamodel选为Source Data Model，并点击Next按钮。
5. 把Model 3.xcdatamodel选为Target Data Model，并点击Next按钮。
6. 将mapping model的名称设为Model2toModel3，并将其保存。
7. 确保Targets中的“Grocery Dude”处于勾选状态，然后点击Create按钮。
8. 选中Model2toModel3.xcmappingmodel。
   现在你将看到如图3-6所示的model-mapping editor界面。

Xcode目前呈现的这套映射是Core Data以最合理的方式推断出来的。在界面左方，应该会看到ENTITY MAPPINGS字样，它下面列出了源实体与目标实体之间的映射。通过图3-6我们应该可以看到，Core Data已经推断出源Item实体对应于目标Item实体，而这个推断是合理的。实体映射时所采用的命名标准是SourceToDestination（源实体名到目标实体名）。明白了这一点之后，我们就会发现，Amount实体并没有与之对应的源实体，因为Amount没有出现在源模型里面。
请按下列步骤修改Grocery Dude，以便将旧版模型的Measurement实体映射到新版模型的Amount实体：

1. 确保Model2toModel3.xcmappingmodel处于选中状态。
2. 在ENTITY MAPPINGS中选定Amount。
3. 点击View＞Utilities＞Show Mapping Model Inspector菜单项（假如菜单里没有这一项，可以按“Option＋＋3”组合键），然后应该就会看到如图3-7所示的面板了。
4. 在Entity Mapping区域中，把Amount实体的Source设置成Measurement。设置好的结果如图3-7所示。

由于我们把Measurement选为源实体，而把Amount选为目标实体，所以Mapping Name这一栏就自动变成了MeasurementToAmount。此外，映射的Type（类型）也从Add变成了Transform。如果要实现更为复杂的迁移方式，那么可以在Custom Policy文本框中输入类名，这个类应该是NSEntityMigrationPolicy的子类。在该子类中，可以通过覆写createDestinationInstancesForSourceInstance方法而操作待迁移的数据。比方说，可以拦截abc这个属性的值，将其中每个单词的首字母改为大写，然后再把修改过的值迁移到xyz属性。
图3-7底部的Source Fetch选项可通过谓词（在Filter Predicate文本框中输入）限定迁移过来的数据量。假如只想把旧数据中的一部分迁移过来，那么这个选项就很有用了。此处的谓词格式与通常代码中编写的谓词相似，只不过要用$source变量来表示源数据。比方说，如果想把abc属性为nil的源数据排除掉，那么可将谓词写成$source.abc!=nil。
在前述的图3-6中，选定ENTITY MAPPINGS字样下方的ItemToItem实体，并观察属性映射中的内容，会看到目标实体中的每个属性都设置有对应的Value Expression。现在再来查看MeasurementToAmount实体的映射，会发现xyz这个Destination 属性并没有设置Value Expression。这就意味着xyz属性目前还没有对应的Source 属性，需要按照ItemToItem实体映射中的那种格式，给它设置一条Value Expression。我们一开始提出的需求是把abc属性映射到xyz属性，所以接下来就按照这个需求配置Value Expression。
请按下列步骤修改Grocery Dude，给名为xyz的Destination 属性设置适当的Value Expression：

1. 在MeasurementToAmount的实体映射界面中，把xyz这个Destination 属性的Value Expression设置为$source.abc。
   迁移模型虽然已经配置好了，但demo方法仍然会从Measurement实体获取数据，而在新模型中，是没有这个实体的。

请按下列步骤修改Grocery Dude，令demo方法使用Amount实体而非Measurement实体：

1. 把AppDelegate.m文件顶部的#import "Measurement.h"替换为#import "Amount.h"。
2. 修改AppDelegate.m文件的demo方法，用程序清单3-4中的代码替换原有代码。原来的代码是获取一小部分Measurement样例数据，而这段代码也与之相似，它是获取一小部分Amount数据。
3. 运行应用程序。由于要迁移数据，所以加载屏幕的显示时间可能会稍微长一些，具体情况与电脑速度有关。
   

只要迁移过程顺利完成，程序就不会崩溃，你应该会在控制台的日志中看到如图3-8所示的信息。

为了验证迁移后的数据是否已经保存到持久化存储区，我们可以用第2章中讲过的办法来查看Grocery-Dude.sqlite文件的内容。正确的结果应该如图3-9所示，其中多出了名为ZAMOUNT的表（这张表对应于Amount实体），旧的Measurement实体里的数据现已出现在这张表中。

在学习下一节之前，一定要先关掉SQLite Database Browser。