使用 Codable 归档 Swift 对象

UserDefaults非常适合存储简单的设置，例如整数和布尔值，但是当涉及复杂数据时——例如自定义Swift类型——我们需要做更多的工作。

我们可以使用以下简单的User数据结构：

struct User { 
    var firstName: String 
    var lastName: String 
} 

它有两个字符串，但并不特殊——它们只是一段文本。整数，布尔值(真或假)和Double也是如此。这些值的数组和字典也很容易想到：一个字符串，然后是另一个，然后是第三个，依此类推。

当使用这样的数据时，Swift为我们提供了一个很棒的协议，称为Codable：一种专门用于存档和取消存档数据的协议，这是一种“将对象转换为纯文本然后再次转换”的奇特方式。

我们将在未来的项目中更多地研究Codable，但是目前我们的需求很简单：我们想要归档一个自定义类型，以便可以将其放入UserDefaults中，然后在从UserDefaults中返回时将其取消存档。

当使用仅具有简单属性的类型(字符串，整数，布尔值，字符串数组等)时，支持归档和取消归档的唯一需要做的就是向Codable添加一致性，如下所示：

struct User: Codable { 
    var firstName: String 
    var lastName: String 
} 

Swift将自动为我们生成一些代码，这些代码将根据需要为我们存档和取消存档User实例，但是我们仍然需要告诉Swift何时存档以及如何处理数据。

该过程的这一部分由称为JSONEncoder的新类型提供支持。它的工作是获取符合Codable的内容，然后以 JavaScript Object Notation(JSON)的形式发送回该对象。该名称暗示它特定于JavaScript，但实际上，我们都使用它，因为它是如此的快速和简单。

Codable协议不需要我们使用JSON，实际上可以使用其他格式，但这是迄今为止最常见的格式。在这种情况下，我们实际上并不在乎使用哪种数据，因为它们只会存储在UserDefaults中。

要将用户数据转换为JSON数据，我们需要在JSONEncoder上调用encode()方法。这可能会引发错误，因此应使用try或try?进行调用来整齐地处理错误。例如，如果我们有一个属性来存储User实例，如下所示：

@State private var user = User(firstName: "Taylor", lastName: "Swift") 

然后，我们可以创建一个将用户存档的按钮，并将其保存到UserDefaults中，如下所示：

Button("Save User") { 
    let encoder = JSONEncoder() 
 
    if let data = try? encoder.encode(self.user) { 
        UserDefaults.standard.set(data, forKey: "UserData") 
    } 
} 

该数据常量是一种新的数据类型，可能会让人感到困惑。它旨在存储您可以想到的任何类型的数据，例如字符串，图像，zip文件等。不过，在这里，我们只关心它是可以直接写入UserDefaults中的数据类型之一。

当我们返回另一种方式时(当我们拥有JSON数据并且想要将其转换为Swift Codable类型时)，我们应该使用JSONDecoder而不是JSONEncoder，但是过程大致相同。

这使我们进入了项目概述的末尾，因此继续进行，将您的项目重置为其初始状态，以便进行构建。

本文转载自微信公众号「Swift社区」，可以通过以下二维码关注。转载本文请联系Swift社区公众号。