Swift 定制 Core Data 迁移

news2025/1/18 8:36:11

在这里插入图片描述

在这里插入图片描述

文章目录

    • 前言
    • 什么是 Core Data 迁移？
    • 示例
    • 更新模型
    • 创建一个新的模型版本
    • 创建映射模型
    • 编写自定义迁移策略
    • 总结

前言

随着应用程序和用户群的增长，你需要添加新功能，删除其他功能，并改变应用程序的工作方式。这是软件开发生命周期的自然结果，我们应该接受。

随着应用程序的发展，你的数据模型也会发生变化。你需要更改数据结构的方式，以适应新功能，同时确保用户不会在不同版本之间丢失任何数据。如果你使用 Core Data 在应用程序中持久化信息，那么 Core Data 迁移就会发挥作用。

什么是 Core Data 迁移？

Core Data 迁移是将数据模型从一个版本更新到另一个版本的过程，因为数据的形状发生了变化（例如，添加或删除新属性）。

在大多数情况下，Core Data 将自动处理迁移过程。但是，有些情况下，你需要通过提供一个映射模型来自定义迁移过程，告诉 Core Data 究竟如何从源模型迁移到目标模型中的每个属性和实体。

甚至有些情况下，映射模型是不够的，你需要编写自定义迁移策略来处理特定情况。这是本文要重点讨论的情况。

示例

让我们考虑一个应用程序，在 Core Data 栈中存储表示音乐曲目的对象。模型非常简单，只包含一个实体：Track，Track.swift 代码如下：

Copy code
Track.swift
import Foundation
import CoreData

@objc(Track)
public class Track: NSManagedObject, Identifiable {
    @nonobjc public class func fetchRequest() -> NSFetchRequest<Track> {
        return NSFetchRequest<Track>(entityName: "Track")
    }

    @NSManaged public var imageURL: String?
    @NSManaged public var json: String?
    @NSManaged public var lastPlayedAt: Date?
    @NSManaged public var title: String?
    @NSManaged public var artistName: String?
}

上面的 Track 实体有五个属性：

  • imageURL：表示曲目封面图像的 URL 的字符串。
  • json：表示来自服务器的原始 JSON 数据响应的字符串。
  • lastPlayedAt：表示上次播放曲目的日期。
  • title：表示曲目的标题的字符串。
  • artistName：表示艺术家的名称的字符串。

Core Data 栈不会与 iCloud 同步，并具有以下设置，CoreDataStack.swift 文件代码如下：

Copy code
CoreDataStack.swift
import CoreData

struct PersistenceController {
    static let shared = PersistenceController()

    let container: NSPersistentContainer

    init(inMemory: Bool = false) {
        container = NSPersistentContainer(name: "CustomMigration")
        if inMemory {
            container.persistentStoreDescriptions.first!.url = URL(fileURLWithPath: "/dev/null")
        }

        container.viewContext.automaticallyMergesChangesFromParent = true
        if let description = container.persistentStoreDescriptions.first {
            description.shouldMigrateStoreAutomatically = true
            description.shouldInferMappingModelAutomatically = false
        }

        container.loadPersistentStores(completionHandler: { (storeDescription, error) in
            if let error = error as NSError? {
                fatalError("Unresolved error \(error), \(error.userInfo)")
            }
        })
    }
}

如果你仔细观察上面的示例，你会注意到我们告诉 Core Data 自动迁移存储，因为我们不想做渐进式迁移，这种迁移速度慢得多且更复杂，并且我们还告诉 Core Data 不要自动推断映射模型，这意味着我们将不得不为每个迁移提供一个映射模型文件，并且可以允许我们自定义这个过程。

持久化了一首歌曲后，使用 Core Data Lab 检查数据库，我们可以看到属性被相应保存：

更新模型

当前版本的模型存在一些可扩展性问题：

  1. 模型仅允许每个曲目有一个艺术家，而实际上，一个曲目可以有多个艺术家。
  2. 模型存储一个表示曲目数据的原始 JSON 字符串，这不太高效，当应用程序需要解析 JSON 字符串以显示曲目数据以获取艺术家列表时，可能会导致性能问题。

为了解决这些问题，让我们删除 artistName 和 json 属性，采用一个新的 Artist 实体，该实体将与 Track 实体建立一对多的关系。

Artist 实体将具有一个表示艺术家名称的 name 属性，以及 id 和 imageURL 属性，我们将从原始 JSON 字符串中获取它们。

创建一个新的模型版本

首先，让我们通过选择 .xcdatamodeld 文件，然后从菜单栏中选择 Editor > Add Model Version... 来创建一个新的模型版本。

给它起一个名称，并以第一个模型版本为基础：

现在，让我们创建 Artist 实体并添加所有字段：

也让我们为新的 Artist 实体创建 NSManagedObject 子类，Artist.swift 代码如下：

Copy code
import Foundation
import CoreData

@objc(Artist)
public class Artist: NSManagedObject, Identifiable {
    @nonobjc public class func fetchRequest() -> NSFetchRequest<Artist> {
        return NSFetchRequest<Artist>(entityName: "Artist")
    }

    @NSManaged public var name: String?
    @NSManaged public var id: String?
    @NSManaged public var imageURL: String?
    @NSManaged public var tracks: NSSet?

    @objc(addTracksObject:)
    @NSManaged public func addToTracks(_ value: Track)

    @objc(removeTracksObject:)
    @NSManaged public func removeFromTracks(_ value: Track)

    @objc(addTracks:)
    @NSManaged public func addToTracks(_ values: NSSet)

    @objc(removeTracks:)
    @NSManaged public func removeFromTracks(_ values: NSSet)
}

正如你在上面的示例中看到的那样，我们将向 Track 实体添加一个对多的 artists 关系，还将向 Artist 实体添加一个对多的 tracks 关系。

现在，让我们为 Track 实体添加缺失的关系，并删除 artistName 和 json 属性：

并更新 NSManagedObject 子类以反映更改，Track.swift 文件代码如下：

import Foundation
import CoreData

@objc(Track)
public class Track: NSManagedObject, Identifiable {
    @nonobjc public class func fetchRequest() -> NSFetchRequest<Track> {
        return NSFetchRequest<Track>(entityName: "Track")
    }

    @NSManaged public var imageURL: String?
    @NSManaged public var lastPlayedAt: Date?
    @NSManaged public var title: String?
    @NSManaged public var artists: NSSet?

    @objc(addArtistsObject:)
    @NSManaged public func addToArtists(_ value: Artist)

    @objc(removeArtistsObject:)
    @NSManaged public func removeFromArtists(_ value: Artist)

    @objc(addArtists:)
    @NSManaged public func addToArtists(_ values: NSSet)

    @objc(removeArtists:)
    @NSManaged public func removeFromArtists(_ values: NSSet)
}

最后但并非最不重要的，让我们将新的模型设置为 .xcdatamodeld 文件的当前模型：

创建映射模型

由于我们告诉 Core Data 不要自动推断映射模型，所以我们将不得不创建一个映射模型文件来在两个版本之间建立桥梁。

从菜单栏中选择 File > New > File...，然后选择 Mapping Model。

然后，选择源模型：

最后，选择目标模型：

编写自定义迁移策略

默认情况下，Core Data 将尽力映射属性，并且大部分工作都将由它自动完成（包括已删除的属性）。

然而，由于我们创建了一个新的实体，并且我们希望保留现有数据，因此我们需要告诉 Core Data 如何迁移。

我们将创建一个新的类，该类继承自 NSEntityMigrationPolicy，并在旧的 Track 实体上创建并链接一个新的关系到 Artist 实体，V2MigrationPolicy.swift 文件代码如下：

Copy code
import CoreData

struct Song: Decodable {
    let artists: [Artist]

    struct Artist: Decodable {
        let id: String
        let name: String
        let imageURL: String
    }
}

class V2MigrationPolicy: NSEntityMigrationPolicy {
    private let decoder = JSONDecoder()

    override func createDestinationInstances(forSource sInstance: NSManagedObject, in mapping: NSEntityMapping, manager: NSMigrationManager) throws {
        // 1
        let sourceKeys = sInstance.entity.attributesByName.keys
        let sourceValues = sInstance.dictionaryWithValues(forKeys: sourceKeys.map { $0 as String })

        // 2
        let destinationInstance = NSEntityDescription.insertNewObject(forEntityName: mapping.destinationEntityName!, into: manager.destinationContext)
        let destinationKeys = destinationInstance.entity.attributesByName.keys.map { $0 as String }

        // 3
        for key in destinationKeys {
            if let value = sourceValues[key] {
                destinationInstance.setValue(value, forKey: key)
            }
        }

        if let jsonString = sInstance.value(forKey: "json") as? String {
            // 3
            let jsonData = Data(jsonString.utf8)
            let object = try? decoder.decode(Song.self, from: jsonData)
            // 4
            let artists: [NSManagedObject] = object?.artists.map { jsonArtist in
                // 5
                let request = Artist.fetchRequest()
                request.fetchLimit = 1
                request.predicate = NSPredicate(format: "name == %@", jsonArtist.name)
                // Do not add duplicates to the list...
                if let matchedArtists = try? manager.destinationContext.fetch(request), let matchedArtist = matchedArtists.first {
                    return matchedArtist
                }
                // 6
                let artist = NSEntityDescription.insertNewObject(forEntityName: "Artist", into: manager.destinationContext)

                artist.setValue(jsonArtist.name, forKey: "name")
                artist.setValue(jsonArtist.imageURL, forKey: "imageURL")
                artist.setValue(jsonArtist.id, forKey: "id")

                return artist
            } ?? []

            // 7
            destinationInstance.setValue(Set<NSManagedObject>(artists), forKey: "artists")
        }

        // 8
        manager.associate(sourceInstance: sInstance, withDestinationInstance: destinationInstance, for: mapping)
    }
}

让我们逐步解释上面的代码：

  1. 获取源实体的属性名称和值。
  2. 创建与源实体相同类型的全新目标实体。
  3. 将源实体的属性值复制到目标实体。
  4. 如果源实体具有 json 属性，则将其解析为 Song 对象。
  5. 为避免重复项，请检查艺术家是否已经存在于目标上下文中。
  6. 如果艺术家不存在，则创建一个新的 Artist 实体，将其插入到上下文中，并设置其属性。
  7. 设置目标实体上的新艺术家关系。
  8. 将源和目标实例关联起来。

最后，让我们将此自定义策略添加到映射模型中：

现在，如果我们再次运行应用程序并使用 Core Data Lab 检查数据库，我们可以看到一个新的实体已经填充了正确的数据。

总结

文章介绍了在应用程序发展过程中，数据模型可能需要进行更改的情况下，如何使用 Core Data 迁移来保持数据的一致性和完整性。首先，它解释了什么是 Core Data 迁移，以及为什么需要进行迁移。接着，通过一个示例应用程序，详细介绍了如何更新数据模型，添加新实体和关系，以解决现有模型的可扩展性问题。然后，文章介绍了如何创建映射模型来定义不同模型版本之间的映射关系，并演示了如何编写自定义迁移策略来处理特定情况，例如将旧模型数据迁移到新模型的新关系中。最后，通过将自定义迁移策略添加到映射模型中，完成了整个迁移过程。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1894898.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

大语言模型融合知识图谱的问答系统研究

大语言模型融合知识图谱的问答系统研究

文章目录 题目摘要方法实验消融实验 题目 大语言模型融合知识图谱的问答系统研究 论文地址&#xff1a;http://fcst.ceaj.org/CN/10.3778/j.issn.1673-9418.2308070 项目地址&#xff1a;https://github.com/zhangheyi-1/llmkgqas-tcm/ 摘要 问答系统&#xff08;Question Ans…
阅读更多...
vue css 链式布局模式

vue css 链式布局模式

<div class"pp-wrap"> <div class"pp-left"><!--跳活动反思--><div class"even-box" v-for"(item,index) in trackingPtoPLeftList" :key"index" click"jumpReview(item)"><div …
阅读更多...
3D虚拟会议室打破传统会议局限，提供沉浸式会议体验

3D虚拟会议室打破传统会议局限，提供沉浸式会议体验

一、身临其境的虚拟会议体验 1、沉浸感提升参会效果 3D虚拟会议室借助虚拟现实技术为用户创造出一个仿佛置身真实会议场所的感觉。用户可以进入一个虚拟的会议室&#xff0c;感受到空间的深度和互动性。这种身临其境的体验&#xff0c;使得参会者不仅仅是被动地观看屏幕&…
阅读更多...
Zoom使用的基本步骤和注意事项

Zoom使用的基本步骤和注意事项

Zoom是一款功能强大的视频会议软件&#xff0c;广泛应用于远程办公、在线教育、团队协作等多个场景。以下是Zoom使用的基本步骤和注意事项&#xff1a; 一、注册与登录 注册Zoom账户&#xff1a; 访问Zoom官方网站&#xff08;如zoom.us&#xff09;&#xff0c;点击“注册”…
阅读更多...
后端之路——阿里云OSS云存储

后端之路——阿里云OSS云存储

一、何为阿里云OSS 全名叫“阿里云对象存储OSS”&#xff0c;就是云存储&#xff0c;前端发文件到服务器&#xff0c;服务器不用再存到本地磁盘&#xff0c;可以直接传给“阿里云OSS”&#xff0c;存在网上。 二、怎么用 大体逻辑&#xff1a; 细分的话就是&#xff1a; 1、准…
阅读更多...
泰国内部安全行动司令部数据泄露

泰国内部安全行动司令部数据泄露

BreachForums 论坛的一名成员宣布发生一起重大数据泄露事件&#xff0c;涉及泰国内部安全行动司令部 (ISOC)&#xff0c;该机构被称为泰国皇家武装部队的政治部门。 目前&#xff0c;我们无法准确确认此次泄露的真实性&#xff0c;因为该组织尚未在其网站上发布有关该事件的任…
阅读更多...
【ESP32】打造全网最强esp-idf基础教程——15.WiFi连接STA模式

【ESP32】打造全网最强esp-idf基础教程——15.WiFi连接STA模式

WiFi连接STA模式 一、ESP32的WiFi功能介绍 前面章节内容&#xff0c;基本上都是描述了ESP32强大的MCU能力&#xff0c;这些MCU能力使得ESP32可以替换许多类型的单片机工作&#xff0c;而自己承担这部分功能&#xff1b;当然ESP32的IOT能力才是它的主业&#xff0c;从硬件配置来…
阅读更多...
2024年中国网络安全市场全景图 -百度下载

2024年中国网络安全市场全景图 -百度下载

是自2018年开始&#xff0c;数说安全发布的第七版全景图。 企业数智化转型加速已经促使网络安全成为全社会关注的焦点&#xff0c;在网络安全边界不断扩大&#xff0c;新理念、新产品、新技术不断融合发展的进程中&#xff0c;数说安全始终秉承科学的方法论&#xff0c;以遵循…
阅读更多...
深入探索PHP中的多维数组：构建复杂数据结构的艺术

深入探索PHP中的多维数组：构建复杂数据结构的艺术

深入探索PHP中的多维数组&#xff1a;构建复杂数据结构的艺术 引言 在PHP开发中&#xff0c;数组&#xff08;Array&#xff09;是一种非常重要的数据类型&#xff0c;它允许我们存储多个值&#xff0c;并且这些值可以是不同类型的。而多维数组&#xff08;Multidimensional …
阅读更多...
康姿百德磁性床垫好不好，效果怎么样靠谱吗

康姿百德磁性床垫好不好，效果怎么样靠谱吗

康姿百德典雅款床垫&#xff0c;打造舒适睡眠新体验 康姿百德床垫是打造舒适睡眠新体验的首选&#xff0c;其设计能够保护脊椎健康&#xff0c;舒展脊椎&#xff0c;让您享受一夜好眠。康姿百德床垫的面料选择也非常重要&#xff0c;其细腻亲肤的针织面料给您带来柔软舒适的触…
阅读更多...
IT专业入门，高考假期预习指南—初识产品经理BRD、MRD 和 PRD

IT专业入门，高考假期预习指南—初识产品经理BRD、MRD 和 PRD

七月来临&#xff0c;各省高考分数已揭榜完成。而高考的完结并不意味着学习的结束&#xff0c;而是新旅程的开始。对于有志于踏入IT领域的高考少年们&#xff0c;这个假期是开启探索IT世界的绝佳时机。作为该领域的前行者和经验前辈&#xff0c;你是否愿意为准新生们提供一份全…
阅读更多...
【常用工具】Linux命令行Restful接口调试神器——curl脚本

【常用工具】Linux命令行Restful接口调试神器——curl脚本

最近的工作经常要涉及到在Linux服务器端和外部系统联调接口&#xff0c;由于Postman无法在命令行使用&#xff0c;这里浅记一个curl脚本模板&#xff1a; #!/bin/bash # 请求标题 TITLE # token信息 TOKEN # url信息 URL # 请求方式 METHODPOST # Restful请求报文 BODYecho -e…
阅读更多...
多模态合规分析平台，保障AIGC营销新时代对客服务高质合规

多模态合规分析平台，保障AIGC营销新时代对客服务高质合规

随着生成式人工智能技术加速应用于人类日常生产生活&#xff0c;AIGC&#xff08;人工智能生成内容&#xff09;正逐渐成为营销领域的新选择。 与此同时&#xff0c;全渠道数字化时代来临&#xff0c;企业与客户的互动形式更加丰富&#xff0c;包括线上营销平台、私域微信运营…
阅读更多...
告别高查重率，AI降重工具帮你快速过关

告别高查重率，AI降重工具帮你快速过关

高查重率是许多毕业生的困扰。通常&#xff0c;高查重率源于过度引用未经修改的参考资料和格式错误。传统的降重方法&#xff0c;如修改文本和增添原创内容&#xff0c;虽必要但耗时且成效不一。 鉴于此&#xff0c;应用AI工具进行AIGC降重成为了一个高效的解决方案。这些工具…
阅读更多...
Vue的介绍与使用

Vue的介绍与使用

1.Vue的介绍 内容讲解 【1】Vue介绍 1.vue属于一个前端框架&#xff0c;底层使用原生js编写的。主要用来进行前端和后台服务器之间的一个交互。 2.Vue是一套构建用户界面的渐进式前端框架。 “渐进式框架”简单的来说你可以将Vue作为你的应用一部分嵌入其中&#xff0c;代理…
阅读更多...
Python 项目依赖离线管理 pip + requirements.txt

Python 项目依赖离线管理 pip + requirements.txt

背景 项目研发环境不支持联网&#xff0c;无法通过常规 pip install 来安装依赖&#xff0c;此时需要在联网设备下载依赖&#xff0c;然后拷贝到离线设备进行本地安装。 两台设备的操作系统、Python 版本尽可能一致。 离线安装依赖 # 在联网设备上安装项目所需的依赖 # -d …
阅读更多...
T113基于评估板SDK配置PD引脚异常

T113基于评估板SDK配置PD引脚异常

使用PD0/PD1/PD2作为IO输入时，发现输入检测到的值异常，断开输入的信号，直接示波器打IO口，还能发现波形信号，猜测该引脚存在引脚复用情况。 原因 这三个引脚在默认系统是作为显示相关引脚功能。 解决方法 1 ) Uboot修改
阅读更多...
Unity 实现UGUI 简单拖拽吸附

Unity 实现UGUI 简单拖拽吸附

获取鼠标当前点击的UI if(RectTransformUtility.RectangleContainsScreenPoint(rectTransform, Input.mousePosition)) {return rectTransform.gameObject; } 拖拽 在Update 中根据鼠标位置实时更新拖拽的图片位置。 itemDrag.transform.position Input.mousePosition; …
阅读更多...
最大奖品数-第13届蓝桥杯省赛Python真题精选

最大奖品数-第13届蓝桥杯省赛Python真题精选

[导读]&#xff1a;超平老师的Scratch蓝桥杯真题解读系列在推出之后&#xff0c;受到了广大老师和家长的好评&#xff0c;非常感谢各位的认可和厚爱。作为回馈&#xff0c;超平老师计划推出《Python蓝桥杯真题解析100讲》&#xff0c;这是解读系列的第91讲。 最大奖品数&#…
阅读更多...
langchain框架轻松实现本地RAG

langchain框架轻松实现本地RAG

一 什么是RAG? RAG&#xff08;Retrieval-Augmented Generation&#xff09;是一种结合了检索和生成模型的方法&#xff0c;主要用于解决序列到序列的任务&#xff0c;如问答、对话系统、文本摘要等。它的核心思想是通过从大量文档中检索相关信息&#xff0c;然后利用这些信息…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023