Json转模型1--SwiftyJson

JSON是移动端开发常用的应用层数据交换协议。最常见的场景便是，客户端向服务端发起网络请求，服务端返回JSON文本，然后客户端解析这个JSON文本，再把对应数据展现到页面上。
但在编程的时候，处理JSON是一件麻烦事。在不引入任何轮子的情况下，我们通常需要先把JSON转为Dictionary，然后还要记住每个数据对应的Key，用这个Key在Dictionary中取出对应的Value来使用。这个过程我们会犯各种错误：

* Key拼写错了
* 路径写错了
* 类型搞错了
* 没拿到值懵逼了
* 某一天和服务端约定的某个字段变更了，没能更新所有用到它的地方
* ...

为了解决这些问题，很多处理JSON的开源库应运而生。在Swift中，这些开源库主要朝着两个方向努力:

1. 保持JSON语义，直接解析JSON，但通过封装使调用方式更优雅、更安全
2. 预定义Model类，将JSON反序列化为类实例，再使用这些实例

对于1，使用最广、评价最好的库非 SwiftyJSON 莫属，它很能代表这个方向的核心。它本质上仍然是根据JSON结构去取值，使用起来顺手、清晰。但也正因如此，这种做法没能妥善解决上述的几个问题，因为Key、路径、类型仍然需要开发者去指定；

对于2，我个人觉得这是更合理的方式。由于Model类的存在，JSON的解析和使用都受到了定义的约束，只要客户端和服务端约定好了这个Model类，客户端定义后，在业务中使用数据时就可以享受到语法检查、属性预览、属性补全等好处，而且一旦数据定义变更，编译器会强制所有用到的地方都改过来才能编译通过，非常安全。这个方向上，开源库们做的工作，主要就是把JSON文本反序列化到Model类上了。这一类JSON库有 ObjectMapper、JSONNeverDie、HandyJSON 等。

今天我们先来看看SwiftyJSON的用法。

通常我们拿到数据会进行非常麻烦的optinonal（可选类型）进行拆包（Wrapping ）操作，
SwiftyJson内部会自动对optional进行拆包，大大简化了代码，解析非常方便，拿到的json数据data直接扔进去

//转成JSON对象
let jsonData = JSON.init(data)

不管需要什么数据只要通过对jsonData进行路径读取
例如：

let build_name = jsonData[0]["build_name"].stringValue

值得一提的是，不需要考虑服务器给我们返回的是什么类型，比如去请求一个房屋的栋数"build_num": 588我们想要获得Int类型或者String类型都可以

let room_num1 = jsonData[0]["build_num"].stringValue
let room_num2 = jsonData[0]["build_num"].intValue
// room_num1 = 588   String类型
// room_num2 = 588   Int类型

这样通过.stringValue .intValue 就可以获得不可选值类型，如果没有获取到数据的话就会返回一个默认值即.stringValue获得空字符串""，.intValue得到0，.arrayValue获得空数组[]，我们就不用判断拆包了。

当然某些场景可能需要你得到可选值类型并自己判断是否存在，那么我们可以通过.string .int .bool .float .array .dictionary等等方法获取，例如：

//String
if let build_name = jsonData[0]["build_name"].string {
    print(build_name)
} else {
    //打印错误信息
    print(jsonData[0]["build_name"])
}

解析数据是真的非常简单。详细使用可以看看SwiftyJSON的使用详解（附样例）
或者移步GitHub-SwiftyJson
但是对于项目而言我们需要对数据进行转换为模型，仅仅是对data进行JSON读取是远远不够的，想想，如果遇到许多地方都用到了build_name值，但是当服务器给我们返回的字段名字改了，我们改项目时就会显得麻烦，甚至造成改不完全，所以我们队数据封装一下转为模型，这样修改时只用改一个地方就是model的赋值就好了。

那我的方法是：

//这是模拟数据
let baseInfo: [String : Any] = ["build_name":"置信·原墅",
                                  "build_address":"学院中路与金桥路交汇处东北侧",
                                  "build_num": 12,
                                  "room_num": 588,
                                  "area_address":"浙江省温州市鹿城区五马街道"]

创建struct模型，当然Class也可以，但是如果不需要继承也不复杂推荐struct（-。-不多解释了）
并写好创建方法

import SwiftyJSON

struct BuildBaseInfoModel {
    var build_name: String?
    var build_address: String?
    var build_num: String?
    var room_num: String?
    var area_address: String?
    
    init(jsonData: JSON) {
        build_name    = jsonData["build_name"].stringValue
        build_address = jsonData["build_address"].stringValue
        area_address  = jsonData["area_address"].stringValue
        room_num      = jsonData["room_num"].stringValue
        build_num     = jsonData["build_num"].stringValue
    }
}

调用：

let jsonData = JSON(baseInfo)
let model = BuildBaseInfoModel.init(jsonData: jsonData)
// 会得到创建好的 BuildBaseInfoModel类型的 对象model
// 也可以这样写
let model = BuildBaseInfoModel(jsonData: jsonData)

当然这只是普通的模型，经常会遇到复杂模型，例如：

// 面积中89是Int， 109和129是String
let baseInfo: [String : Any] = ["build_name":"置信·原墅",
                                  "build_address":"学院中路与金桥路交汇处东北侧",
                                  "area_address":"浙江省温州市鹿城区五马街道",
                                  "area":[89,"109","129"],
                                  "detail_address":["province":"浙江省",
                                                    "city":"温州市",
                                                    "district":"鹿城区",
                                                    "street":"五马街道"],
                                  "build_num": 12,
                                  "room_num": 588]

这时候模型就应该有两个

struct BuildBaseInfoModel {
    
    var build_name: String?
    var build_address: String?
    var build_num: String?
    var room_num: String?
    var area_address: String?
    var detail_address: DetailAddressModel
    var area:[Any]?
    // 这里面积area中就不能再用arrayValue获取了，因为arrayValue获取的为JSON类型，我们需要转为我们需要的对象
    init(jsonData: JSON) {
        build_name    = jsonData["build_name"].stringValue
        build_address = jsonData["build_address"].stringValue
        area_address  = jsonData["area_address"].stringValue
        room_num      = jsonData["room_num"].stringValue
        build_num     = jsonData["build_num"].stringValue
        area          = jsonData["area"].arrayObject
        detail_address = DetailAddressModel(jsonData: jsonData["detail_address"])
    }
}
struct DetailAddressModel {
    var province: String?
    var city: String?
    var district: String?
    var street: String?
    
    init(jsonData: JSON) {
        province = jsonData["province"].stringValue
        city = jsonData["city"].stringValue
        district = jsonData["district"].stringValue
        street = jsonData["street"].stringValue
    }
    
}

let model = BuildBaseInfoModel(jsonData: jsonData)
DPrint(message: model.detail_address.city)
DPrint(message: model.area?.first)
DPrint(message: model.area?[1])
// xxxxxxxxx.swift[21], updateRoomsData(index:): Optional("温州市")
// xxxxxxxxx.swift[22], updateRoomsData(index:): Optional(89)
// xxxxxxxxx.swift[22], updateRoomsData(index:): Optional("109")

好了，完成，虽然解析Json数据非常方便，但是创建模型的时候，还是略显繁琐。不过不管怎么说目的达到了