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　在不开启自动推断功能时，必须要有映射模型方能完成迁移工作

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

请按下列步骤修改Grocery Dude，以添加新的映射模型：

1.确保Data Model组处于选中状态^[1]。

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界面。

图3-6　Xcode的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所示。

图3-7　手动配置从Measurement实体到Amount实体的映射

由于我们把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-4　AppDelegate.m文件中的demo方法（获取测试用的Amount数据）

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

图3-8　从顺利迁移至新版本的模型中获取到的数据

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

图3-9　顺利迁移到新版本的模型

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

[1] “确保某物处于选中状态”或“确保某物受选”的意思就是“用鼠标点击某物，以将其选中”。为了尊重原著，译文将原书中的某些“ensure…is selected”直接对译为“确保……处于选中状态”。——译者注