[Swift]SwiftyJSON的使用：解析JSON

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公眾號：山青詠芝（shanqingyongzhi）
➤博客園地址：山青詠芝（https://www.cnblogs.com/strengthen/ ）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10709048.html 
➤如果鏈接不是山青詠芝的博客園地址，則可能是爬取作者的文章。
➤原文已修改更新！強烈建議點擊原文地址閱讀！支持作者！支持原創！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

用法

初始化Initialization

import SwiftyJSON

let json = JSON(data: dataFromNetworking)

或者

let json = JSON(jsonObject)

或者

if let dataFromString = jsonString.data(using: .utf8, allowLossyConversion: false) {
    let json = JSON(data: dataFromString)
}

下標Subscript

//從JSON數組中獲取Double
let name = json[0].double
//從JSON數組中獲取字符串數組
let arrayNames =  json["users"].arrayValue.map {$0["name"].stringValue}
//從JSON字典中獲取字符串
let name = json["name"].stringValue
//使用元素的路徑獲取字符串
let path: [JSONSubscriptType] = [1,"list",2,"name"]
let name = json[path].string
// 相同
let name = json[1]["list"][2]["name"].string
// 或者
let name = json[1,"list",2,"name"].string
//使用困難的方式
let name = json[].string
//使用自定義方式
let keys:[JSONSubscriptType] = [1,"list",2,"name"]
let name = json[keys].string

循環Loop

//如果json是.Dictionary
for (key,subJson):(String, JSON) in json {
   // Do something you want
}

即使JSON是一個數組，第一個元素也總是一個String

//如果json是.Array 
// `index`是0 .. <json.count的字符串值
for (index,subJson):(String, JSON) in json {
    // Do something you want
}

錯誤Error

SwiftyJSON 4.x

SwiftyJSON 4.x的引入稱為枚舉類型SwiftyJSONError，其中包括unsupportedType，indexOutOfBounds，elementTooDeep，wrongType，notExist和invalidJSON，在同一時間，ErrorDomain正在被更換SwiftyJSONError.errorDomain。注意：這些舊的錯誤類型在SwiftyJSON 4.x中已棄用，將在以后的版本中刪除。

SwiftyJSON 3.x

使用下標來獲取/設置數組或字典中的值

如果JSON是：

• 一個數組，應用程序可能會崩潰“索引越界”。
• 一本字典，它將被nil無故分配。
• 不是數組或字典，應用程序可能會崩潰“無法識別的選擇器”異常。

這在SwiftyJSON中永遠不會發生。

let json = JSON(["name", "age"])
if let name = json[999].string {
    // Do something you want
} else {
    print(json[999].error!) // "Array[999] is out of bounds"
}

let json = JSON(["name":"Jack", "age": 25])
if let name = json["address"].string {
    // Do something you want
} else {
    print(json["address"].error!) // "Dictionary["address"] does not exist"
}

let json = JSON(12345)
if let age = json[0].string {
    // Do something you want
} else {
    print(json[0])       // "Array[0] failure, It is not an array"
    print(json[0].error!) // "Array[0] failure, It is not an array"
}

if let name = json["name"].string {
    // Do something you want
} else {
    print(json["name"])       // "Dictionary[\"name"] failure, It is not an dictionary"
    print(json["name"].error!) // "Dictionary[\"name"] failure, It is not an dictionary"
}

可選的getter

// NSNumber
if let id = json["user"]["favourites_count"].number {
   // Do something you want
} else {
   // Print the error
   print(json["user"]["favourites_count"].error!)
}

// String
if let id = json["user"]["name"].string {
   // Do something you want
} else {
   // Print the error
   print(json["user"]["name"].error!)
}

// Bool
if let id = json["user"]["is_translator"].bool {
   // Do something you want
} else {
   // Print the error
   print(json["user"]["is_translator"].error!)
}

// Int
if let id = json["user"]["id"].int {
   // Do something you want
} else {
   // Print the error
   print(json["user"]["id"].error!)
}
...

非可選的getter

非可選的getter被命名 xxxValue

//如果不是Number或nil，則返回0
let id: Int = json["id"].intValue
//如果不是String或nil，則返回“”
let name: String = json["name"].stringValue
//如果不是數組或者為nil，則返回[]
let list: Array<JSON> = json["list"].arrayValue
//如果不是Dictionary或nil，返回[:]
let user: Dictionary<String, JSON> = json["user"].dictionaryValue

Setter

json["name"] = JSON("new-name")
json[0] = JSON(1)
json["id"].int =  1234567890
json["coordinate"].double =  8766.766
json["name"].string =  "Jack"
json.arrayObject = [1,2,3,4]
json.dictionaryObject = ["name":"Jack", "age":25]

原始對象Raw object

let rawObject: Any = json.object
let rawValue: Any = json.rawValue
//將JSON轉換為原始NSData
do {
    let rawData = try json.rawData()
  //Do something you want
} catch {
    print("Error \(error)")
}
//將JSON轉換為原始String
if let rawString = json.rawString() {
  //Do something you want
} else {
    print("json.rawString is nil")
}

存在Existence

//顯示是否在JSON中指定了值
if json["name"].exists()

文字敞篷車

有關文字敞篷車的更多信息：Swift Literal Convertibles

// StringLiteralConvertible
let json: JSON = "I'm a json"
// IntegerLiteralConvertible 
let json: JSON =  12345
// BooleanLiteralConvertible
let json: JSON =  true
// FloatLiteralConvertible
let json: JSON =  2.8765
// DictionaryLiteralConvertible
let json: JSON =  ["I":"am", "a":"json"]
// ArrayLiteralConvertible
let json: JSON =  ["I", "am", "a", "json"]
//使用數組中的下標
var json: JSON =  [1,2,3]
json[0] = 100
json[1] = 200
json[2] = 300
json[999] = 300  //別擔心，什么都不會發生
//使用字典中的下標
var json: JSON =  ["name": "Jack", "age": 25]
json["name"] = "Mike"
json["age"] = "25" // It's OK to set String
json["address"] = "L.A." // Add the "address": "L.A." in json
//數組和字典
var json: JSON =  ["name": "Jack", "age": 25, "list": ["a", "b", "c", ["what": "this"]]]
json["list"][3]["what"] = "that"
json["list",3,"what"] = "that"
let path: [JSONSubscriptType] = ["list",3,"what"]
json[path] = "that"
//使用其他JSON對象
let user: JSON = ["username" : "Steve", "password": "supersecurepassword"]
let auth: JSON = [
  "user": user.object, // use user.object instead of just user
  "apikey": "supersecretapitoken"
]

合並Merging

可以將一個JSON合並到另一個JSON中。將JSON合並到另一個JSON中會將所有非現有值添加到僅存在於otherJSON中的原始JSON。

如果兩個JSON都包含相同鍵的值，則大多數此值會被原始JSON覆蓋，但有兩種情況會提供一些特殊處理：

• 如果兩個值都是值，那么JSON.Type.array在otherJSON中找到的數組會附加到原始JSON的數組值。
• 如果兩個值都是JSON.Type.dictionary兩個JSON值，那么合並的方式與封裝JSON的合並方式相同。

如果JSON中的兩個字段具有不同的類型，則該值將始終被覆蓋。

合並有兩種不同的方式：merge修改原始JSON，而merged在副本上非破壞性地工作。

let original: JSON = [
    "first_name": "John",
    "age": 20,
    "skills": ["Coding", "Reading"],
    "address": [
        "street": "Front St",
        "zip": "12345",
    ]
]

let update: JSON = [
    "last_name": "Doe",
    "age": 21,
    "skills": ["Writing"],
    "address": [
        "zip": "12342",
        "city": "New York City"
    ]
]

let updated = original.merge(with: update)
// [
//     "first_name": "John",
//     "last_name": "Doe",
//     "age": 21,
//     "skills": ["Coding", "Reading", "Writing"],
//     "address": [
//         "street": "Front St",
//         "zip": "12342",
//         "city": "New York City"
//     ]
// ]

字符串表示

有兩種選擇：

• 使用默認的Swift
• 使用一個可以很好地處理選項的自定義表示nil為"null"：

let dict = ["1":2, "2":"two", "3": nil] as [String: Any?]
let json = JSON(dict)
let representation = json.rawString(options: [.castNilToNSNull: true])
 // 表示為“{\”1 \“：2，\”2 \“：\”two \“，\”3 \“：null}”，表示{“1”：2，“2”：“two” “3”：空}

與Alamofire合作

SwiftyJSON很好地包裝了Alamofire JSON響應處理程序的結果：

Alamofire.request(url, method: .get).validate().responseJSON { response in
    switch response.result {
    case .success(let value):
        let json = JSON(value)
        print("JSON: \(json)")
    case .failure(let error):
        print(error)
    }
}

我們還提供了Alamofire的擴展，用於將NSData序列化為SwiftyJSON的JSON。

請參閱：Alamofire-SwiftyJSON

與Moya合作

SwiftyJSON將數據解析為JSON：

let provider = MoyaProvider<Backend>()
provider.request(.showProducts) { result in
    switch result {
    case let .success(moyaResponse):
        let data = moyaResponse.data
        let json = JSON(data: data) //將網絡數據轉換為json
        print(json)
    case let .failure(error):
        print("error: \(error)")
    }
}