Swift Codable协议之原生JSON和Model转换

Swift4.0 原生JSON和Model转换

一：引言

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

虽然也有ObjectMapper 、SwiftyJSON、HandyJSON等解决方案，但相比起来原生的使用方便、快捷，不依赖三方库的更新，相对更加稳定

关于 Codable：

public typealias Codable = Decodable & Encodable

通过查看定义可以看到，Codable 其实是一个组合协议，由 Decodable （解码用于JSON转Model）和 Encodable（编码用于Model转JSON） 两个协议组成：

Swift 中的基本数据类型比如 String、Int、Float 等都已经实现了 Codable 协议，因此如果你的数据类型只包含这些基本数据类型的属性，只需要在类型声明中加上 Codable 协议就可以了，不需要写任何实际实现的代码

二：简单使用

JSON数据：

{
    "class_id" = 2;
    "sub_classes" =     (
                {
            "class_id" = 1;
            title = "\U7279\U5c55";
        }
    );
    title = "\U7279\U5c55";
    type = 2;
}

Model对象：

struct GoodsModel: Codable {
    
    var class_id  : Int?
    var type      : Int?
    var title     : String?
    
    var price : String?
    var list_img : String?
    var wenchuang_id : Int?
    var sub_classes  : [Sub_classes]?
    
}

struct Sub_classes: Codable {
    var class_id  : Int?
    var title     : String?
}

注意：有些字段有可能会是空值，所以可将不确定是否有值得声明为可选值（？）

JSON转Model：

let jsonDecoder = JSONDecoder()
let jsonData = try? JSONSerialization.data(withJSONObject: jsonDic, options: [])
let model: GoodsModel = try! jsonDecoder.decode(GoodsModel.self, from: jsonData)

Model转JSON：

let jsonEncoder = JSONEncoder()
let jsonData = try? jsonEncoder.encode(modelObject)
let json = try JSONSerialization.jsonObject(with: jsonData, options: .mutableContainers)

三： 自定义键值名

对于一些系统关键字或者key不匹配时需要自定义键值名

JSON数据：

{
    "id" = 2;
    "sub_classes" =     (
                {
            "class_id" = 1;
            title = "\U7279\U5c55";
        }
    );
    description = "\U7279\U5c55";
    type = 2;
}

Model对象：

struct GoodsModel: Codable {
    
    var class_id  : Int?
    var type      : Int?
    var title     : String?
    
    var price : String?
    var list_img : String?
    var wenchuang_id : Int?
    var sub_classes  : [Sub_classes]?
    
    //自定义键值名
     enum CodingKeys: String, CodingKey {
        case class_id = "id" //关键字替换
        case type
        case title     = "description"
        
        case price
        case list_img
        case wenchuang_id
        case sub_classes
    }
}

struct Sub_classes: Codable {
    var class_id  : Int?
    var title     : String?
}

需要注意的是，即使属性名称与 JSON 中的字段名称一致，如果自定义了 CodingKeys，这些属性也是无法省略的，否则会得到一个 Type 'GoodsModel' does not conform to protocol 'Codable' 的编译错误，这一点还是有点坑的

四： 不确定数据类型解析（是Int或String类型）

声明一个跨类型解析类TStrInt：

一个含有int，string的类，可用于解析后台返回类型不确定的字段。

即：把int\string解析成TStrInt且解析后TStrInt的int和string都有值

struct TStrInt: Codable {
    var int:Int {
        didSet {
            let stringValue = String(int)
            if  stringValue != string {
                string = stringValue
            }
        }
    }
    
    var string:String {
        didSet {
            if let intValue = Int(string), intValue != int {
                int = intValue
            }
        }
    }
    
    //自定义解码(通过覆盖默认方法实现)
    init(from decoder: Decoder) throws {
        let singleValueContainer = try decoder.singleValueContainer()
        
        if let stringValue = try? singleValueContainer.decode(String.self)
        {
            string = stringValue
            int = Int(stringValue) ?? 0
            
        } else if let intValue = try? singleValueContainer.decode(Int.self)
        {
            int = intValue
            string = String(intValue);
        } else
        {
            int = 0
            string = ""
        }
    }
}

使用方法：

struct GoodsModel: Codable {
    
    var class_id  : TStrInt?
    var type      : TStrInt?
    var title     : String?
    
    var price : String?
    var list_img : String?
    var wenchuang_id : TStrInt?
    var sub_classes  : [Sub_classes]?
    
}

struct Sub_classes: Codable {
    var class_id  : TStrInt?
    var title     : String?
}


调用：
self.model!.class_id!.string //获取字符串类型
self.model!.class_id!.int //获取int类型