使用 Swift 4 中的 Encodable / Decodable 对结构进行编码 / 解码

Question

我不太习惯结构体，我知道使用结构体的唯一方法就是这样......

struct UserDetails {
  let name: String
  let message: String

  init(name: String, message: String) {
    self.name = name
    self.message = message
  }
}

name一旦我收到和的值message，我就会将它们添加到结构中，如下所示......

let userDetails = UserDetails(name: theName, message: theMessage)

然后将其添加到结构类型的数组中，如下所示......

self.userDetailsArray.append(userDetails) 

现在终于，当我想获取个人姓名或消息时，我会这样得到......

let user = userDetailsArray[indexPath.row]
cell.userNameLabel.text = user.name
cell.messageLabel.text = user.message

这也很好用。但我担心的是......我上面指定的是一种非常古老的方法，因为 swift 已经提出了NSCoding，然后Codable协议也提出了。但我不知道如何实施它们。

希望有人可以展示我如何将NSCoding/Codable协议应用到我上面提到的示例中......

Answer 1

你的代码没问题。要应用 Codable 来解析/存储/检索用户详细信息列表，您需要像下面这样定义结构，

struct UserDetails: Codable {
    let name: String
    let message: String

    enum CodingKeys: String, CodingKey {
        //Uncomment the following commentted lines, if your JSON formatted data comes with different keys like bellow
        case name       //= "user_name"
        case message    //= "user_message"
    }

    init(name: String, message: String) {
        self.name = name
        self.message = message
    }

    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(name, forKey: .name)
        try container.encode(message, forKey: .message)
    }

    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        name = try container.decode(String.self, forKey: .name)
        message = try container.decode(String.self, forKey: .message)
    }
}

要解析 Web api 调用的响应，您可以使用以下函数

func makeAPICall(){
    guard let url = URL(string: "https://www.your-web-api") else { return }
    URLSession.shared.dataTask(with: url) { (data, response, error) in
        guard let data = data else { return }
        do {
            let decoder = JSONDecoder()
            let userDetails = try decoder.decode([UserDetails].self, from: data)
            print(userDetails)
        } catch let err {
            print("Error", err)
        }
    }.resume()
}

要存储您的用户详细信息列表，您可以像这样编写函数

func storeUserDetails(userDetails: [UserDetails]) {
    do {
        let data = try PropertyListEncoder().encode(userDetails)
        let success = NSKeyedArchiver.archiveRootObject(data, toFile: filePath(key: "file.archive"))
        print(success ? "Successful save" : "Save Failed")
    } catch {
        print("Save Failed")
    }
}

要检索您的用户详细信息列表，请使用此功能

func retrieveUserDetails() -> [UserDetails]? {
    guard let data = NSKeyedUnarchiver.unarchiveObject(withFile: filePath(key: "file.archive")) as? Data else { return nil }
    do {
        let products = try PropertyListDecoder().decode([UserDetails].self, from: data)
        return products
    } catch {
        print("Retrieve Failed")
        return nil
    }
}

以及获取文件路径的辅助函数

func filePath(key:String) -> String {
    let manager = FileManager.default
    let url = manager.urls(for: .documentDirectory, in: .userDomainMask).first
    return (url!.appendingPathComponent(key).path)
}

一些好的读物：

1. 编码和解码自定义类型
2. Swift 4 中的编码、解码和序列化
3. 关于 Swift 4 中 Codable 的一切