Swift实践：使用CoreData完成一个通讯录存储

CoreData作为Apple的亲儿子，依然在App需要存储结构化数据上发挥着重要的作用。CoreData已经超过十年了，而且亲爹还在积极的维护着它。

image.png

在Monster、Indeed这些海外主流招聘网站看一下iOS的职位，基本上都会大大写着要求会熟练使用CoreData。

然而这么一个成熟，被实践检验过的代码库反而在国内使用并不是特别多。FMDB、Realm等等在被广泛使用。经常在面试的时候问iOSer是不是了解数据库，回答都是了解。再一细问，很多人也都是只使用到了FMDB，对于CoreData却是了解甚少。

后来想了想，可能是因为CoreData的入门成本有点高，而且相关的中文资料比较少的缘故吧。

为了写这个系列，还专门买来了objc.io的CoreData这本书。读完之后受益匪浅。

这个系列要写多少篇还没有想好，大概也还是会从基本到高级的一个过渡。

第一篇通过一个通讯录实现数据库的读取。第二篇会存储更多类型的数据。

最终实现结果：

CoreDataDemo.gif

1. Core Data架构

一个基本的 Core Data 栈由四个主要部分组成：托管对象 (NSManagedObject)，托管对象上下文 (NSManagedObjectContext)，持久化存储协调器 (NSPersistentStoreCoordinator)，以及持久化存储 (NSPersistentStore)。

image.png

• NSManagedObject是我们的数据模型，也就是我们存储的对象。这些对象都保存在NSManagedObjectContext中，每个存储对象都知道自己对应哪个上下文。
• NSManagedObjectContext ：日常打交道的都是这个。其他三个在数据迁移的时候才会看到。
• NSPersistenStoreCoordinator ： 是模型和存储数据库之间的桥梁，负责两者之间最复杂的细节隐藏。

关于Context想多说点，因为是天天都打交道的嘛。它其实是内存中的一块区域，对象所有的操作都需要一个context。直到save之前，都是在内存中，不会对数据库中的内容有任何影响。每一个托管对象都对应一个Context，一个对象只会跟一个特定的Context打交道。直到生命周期结束。

Context是线程不安全的。

2. CoreData的基本读取操作

2. 1 获取CoreData已经保存数据的五个步骤

1. 获取总代理和托管对象总管
2. 从Entity获取一个fetchRequest
3. 根据fetchRequest，从managedContext中查询数据
4. 保存。保存过程中可能会出错，要做一下处理。
5. 添加到数组中

2.2 基本存储

1. 获取总代理和托管对象总管
2. 建立一个Entity
3. 保存内容
4. 保存Entity到托管对象。如果保存失败，进行处理
5. 保存到数组中，更新UI

3. 更新一个通讯录的列表页Demo

需求：完成一个通讯录的列表页。要求：

1. 从本地数据库中读取名字列表
2. 点击增加可以添加一个名字
3. 添加的名字可以保存到本地数据库中

好，接下来咱们来一步一步实现这个需求。为了突出重点，咱们先从最简单的开始，使用默认带数据库的工程进行着手。

3.1 Xcode创建默认带数据库的工程

image.png

在 Xcode 创建工程时，提供了创建 CoreData 的模板，只需要我们在创建时，勾选 CoreData 选项，Xcode 就会自动创建出数据模型文件。

这个Demo用这个创建，纯粹是为了简单直奔主题。不然还要一开始分享很多其他的内容，看官们会觉得腻的。

但是，实际开发中不建议使用这种方式创建。通常情况下我们都会把生成的模板代码都删除的。

3.2 创建本地数据库模板

image.png

勾选完成之后，会看到一个后缀名是"xcdatamodeld"的文件，这个就是咱们的数据库模板啦。

当然，现在里面是还不能存数据的，还需要我们设置一下字段名称。

image.png

第一步，要添加一个Entity，这个就相当于是数据库中的一张表。

第二步，对新建的Entity命名。

第三步，设计Entity里面的属性。咱们这个Demo的需求里面只需要一个人名，所以就只设置了一个名字叫做name的属性，类型是String。

其他更多的属性类型，我们会在下面一篇文章分享。

3.3 查询本地数据

咦？在最开始的不是说一个基本的 Core Data 栈由四个主要部分组成嘛？怎么没有看到呐？

来来来，这就是最开始我们使用Xcode创建默认带数据库的工程的原因。使用了这个选项，会自动的在AppDelegate中生成相应的代码。确实简化了咱们第一次学习的成本，但是就像没人会把所有代码都写在Controller里面一样，在APPDelegate也不会写这些东西。

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        //        步骤一：获取总代理和托管对象总管
        let appDelegate = UIApplication.shared.delegate as! AppDelegate
        
        let managedObectContext = appDelegate.persistentContainer.viewContext
        
//        步骤二：建立一个获取的请求
        let fetchRequest = NSFetchRequest<NSFetchRequestResult>(entityName: "Person")
        
//        步骤三：执行请求
        do {
            let fetchedResults = try managedObectContext.fetch(fetchRequest) as? [NSManagedObject]
            if let results = fetchedResults {
                people = results
                
                tableView.reloadData()
            }
            
        } catch  {
            fatalError("获取失败")
        }
    }

3.4 插入并保存数据至本地数据库

private func saveName(text: String) {
    //        步骤一：获取总代理和托管对象总管
    let appDelegate = UIApplication.shared.delegate as! AppDelegate
    
    let managedObectContext = appDelegate.persistentContainer.viewContext
    
    //        步骤二：建立一个entity
    let entity = NSEntityDescription.entity(forEntityName: "Person", in: managedObectContext)
    
    let person = NSManagedObject(entity: entity!, insertInto: managedObectContext)
    
    //        步骤三：保存文本框中的值到person
    person.setValue(text, forKey: "name")
    
    //        步骤四：保存entity到托管对象中。如果保存失败，进行处理
    do {
        try managedObectContext.save()
    } catch  {
        fatalError("无法保存")
    }
    
    //        步骤五：保存到数组中，更新UI
    people.append(person)
}

所有的源代码在这里哈： https://github.com/Stanbai/CoreDataDemo.git