[Swift]Swift原生：JSON转换Model

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（let_us_code）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址： https:////www.cnblogs.com/strengthen/p/12381682.html
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

Apple 在 Swift  的 Foundation 的模块中添加了对 JSON 解析成Model的原生支持。

虽然之前也有ObjectMapper和SwiftyJSON这样的解决方案，但是Swift 中添加了原生支持还是不免让人兴奋，使用起来也相对方便了许多。

简单使用

如果你的 JSON 数据结构和你使用的 Model 对象结构一致的话，那么解析过程将会非常简单。只需要让Model声明 Codable 协议即可。

JSON数据：

{
    "userInfos": [
        {
            "userName": "小名",
            "age": 18,
            "height": 178.56,
            "sex": true
        },
        {
            "userName": "小方",
            "age": 18,
            "height": 162.56,
            "sex": false
        }
    ]
}

Model对象：

struct UserList: Codable {

    let userInfos: [UserInfo]

    struct UserInfo: Codable {

        let userName: String
        let age: Int
        let height: Float
        let sex: Bool
    }
}

JSON转Model：

    let jsonDecoder = JSONDecoder()
    let modelObject = try? jsonDecoder.decode(UserList.self, from: jsonData)

Model转JSON：

    let jsonEncoder = JSONEncoder()
    let jsonData = try? jsonEncoder.encode(modelObject)

关于 Codable

/// A type that can convert itself into and out of an external representation.
public typealias Codable = Decodable & Encodable

Codable 同时声明了 Decodable 和 Encodable 两个协议，只需要单向处理的话可以只声明其中一个协议。

需要注意的是，使用时必须保证 JSON 数据结构和你使用的 Model 对象结构一致，任何不一致都会导致解析失败。

但是实际开发过程中，往往不会总是这样满足我们的需要，有时也需要我们对解析过程做一些改变。

自定义键值名

为了保持风格一致，我们有时候不得不改变key成为我们需要的key值。

仍然使用上面的例子，现在我们把Model中的key height 改为 bodyHeight

struct UserList: Codable {

    let userInfos: [UserInfo]
    
    struct UserInfo: Codable {
        
        let userName: String
        let age: Int
        let bodyHeight: Float
        let sex: Bool
        
        private enum CodingKeys: String, CodingKey {
            case userName
            case age
            case bodyHeight = "height"
            case sex
        }
    }
}

格式处理

JSONEncoder 和 JSONDecoder 本身也提供了对时间格式的处理，Data的处理，浮点不匹配的处理。可以根据自己的需要设置自己想要的格式。

    /// The strategy to use in decoding dates. Defaults to `.deferredToDate`.
    open var dateDecodingStrategy: JSONDecoder.DateDecodingStrategy

    /// The strategy to use in decoding binary data. Defaults to `.base64`.
    open var dataDecodingStrategy: JSONDecoder.DataDecodingStrategy

    /// The strategy to use in decoding non-conforming numbers. Defaults to `.throw`.
    open var nonConformingFloatDecodingStrategy: JSONDecoder.NonConformingFloatDecodingStrategy

JSONEncoder 在生成 JSON 的时候默认的格式是

{"userInfos":[{"age":18,"sex":true,"height":178.55999755859375,"userName":"小名"},{"age":18,"sex":false,"height":162.55999755859375,"userName":"小方"}]}

如果想要提高阅读体验, 可以设置属性 outputFormatting

open var outputFormatting: JSONEncoder.OutputFormatting

let jsonEncoder = JSONEncoder()
jsonEncoder.outputFormatting = .prettyPrinted

然后生成的JSON格式就会变成这样

{
  "userInfos" : [
    {
      "age" : 18,
      "sex" : true,
      "height" : 178.55999755859375,
      "userName" : "小名"
    },
    {
      "age" : 18,
      "sex" : false,
      "height" : 162.55999755859375,
      "userName" : "小方"
    }
  ]
}

JSON中 没有 Model 所需要的 Key

如果JSON的数据结构中，有些 Key - Value 不一定出现，Model中对应的要实用可选类型

JSON数据：

{
    "userInfos": [
        {
            "userName": "小名",
            "age": 18,
            "sex": true
        },
        {
            "userName": "小方",
            "age": 18,
            "height": 162.56,
            "sex": false
        }
    ]
}

Model对象：

struct UserList: Codable {

    let userInfos: [UserInfo]

    struct UserInfo: Codable {

        let userName: String
        let age: Int
        let height: Float?
        let sex: Bool
    }
}