背景:

很多時候,我們從服務(wù)端請求下的數(shù)據(jù)都是Json格式,我們需要拿這些數(shù)據(jù)顯示到我們的UI界面。

因此,我們的做法基本都會先將json轉(zhuǎn)為方便使用的數(shù)據(jù)模型,或者也可以直接轉(zhuǎn)字典解決。

 

在OC中,我們有很多優(yōu)秀的第三方庫幫助我們實現(xiàn),比如MJExtension、JSONModel等,這些庫基本都是利用runtime實現(xiàn)讀取屬性名并利用kvc重新賦值屬性。

在Swift中,由于runtime的局限,比較出名的有SwiftyJSON、ObjectMapper等。

其中:

1、SwiftyJSON本質(zhì)上仍然是根據(jù)JSON結(jié)構(gòu)去取值,使用起來順手、清晰;

但這種做法沒能妥善解決上述的幾個問題,因為它不是機遇model的,我們使用的時候,依然必須制定key去獲取value,這在一定程度上不是很友好。

2、ObjectMapper實現(xiàn)了JSON直接轉(zhuǎn)Model的功能,不過使用起來,代碼量會多一點,因為我們必須遵循Mappable協(xié)議,制定json內(nèi)的每一個key和model屬性的對應(yīng)關(guān)系。

比如:構(gòu)造的class必須滿足這三個紅框的內(nèi)容,這對于使用習(xí)慣了直接定義Model屬性的同學(xué)來說,可能會有點不習(xí)慣。

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

那么,今天的主角 HandyJSON就出現(xiàn)了,這個庫是阿里一位大神推出的,能夠做到JSON轉(zhuǎn)Model一步到位,而且使用起來,非常簡潔方便。

關(guān)于HandyJSON原理:

摘自網(wǎng)上一段說明如下:

HandyJSON另辟蹊徑,采用Swift反射+內(nèi)存賦值的方式來構(gòu)造Model實例,保持原汁原味的Swift類定義。

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

// 假設(shè)這是服務(wù)端返回的統(tǒng)一定義的response格式class BaseResponse<T: HandyJSON>: HandyJSON {    var code: Int? // 服務(wù)端返回碼
    var data: T? // 具體的data的格式和業(yè)務(wù)相關(guān),故用泛型定義

    public required init() {}
}// 假設(shè)這是某一個業(yè)務(wù)具體的數(shù)據(jù)格式定義struct SampleData: HandyJSON {    var id: Int?}

let sample = SampleData(id: 2)
let resp = BaseResponse<SampleData>()
resp.code = 200resp.data = sample

let jsonString = resp.toJSONString()! // 從對象實例轉(zhuǎn)換到JSON字符串print(jsonString) // print: {"code":200,"data":{"id":2}}if let mappedObject = JSONDeserializer<BaseResponse<SampleData>>.deserializeFrom(json: jsonString) { // 從字符串轉(zhuǎn)換為對象實例
    print(mappedObject.data?.id)
}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

關(guān)于HandyJSON 如何集成使用:

GitHub下載鏈接: https://github.com/alibaba/HandyJSON

 1、pod引入

pod 'HandyJSON'

2、使用時,先頭部import

import HandyJSON

 

 

正文: 

1、HandyJSON支持 JSON直接轉(zhuǎn)Model,定義class時,有兩點注意:

 - 必須遵循HandyJSON協(xié)議        

 - 需要實現(xiàn)空的initializer  (當(dāng)然Struct結(jié)構(gòu)體 可以不需要init(),下文有說明)

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

class BasicTypes: HandyJSON {    var int: Int = 2
    var doubleOptional: Double?    var stringImplicitlyUnwrapped: String!

    required init() {}
}

let jsonString = "{\"doubleOptional\":1.1,\"stringImplicitlyUnwrapped\":\"hello\",\"int\":1}"if let object = BasicTypes.deserialize(from: jsonString) {    // …}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

這是最簡單的模型,只有三個屬性,對于復(fù)雜的嵌套結(jié)構(gòu),一樣這樣處理實現(xiàn),參考下文。

 

2、HandyJSON還支持Struct,使用方式與Class基本一致

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

struct BasicTypes: HandyJSON {    var int: Int = 2
    var doubleOptional: Double?    var stringImplicitlyUnwrapped: String!}

let jsonString = "{\"doubleOptional\":1.1,\"stringImplicitlyUnwrapped\":\"hello\",\"int\":1}"if let object = BasicTypes.deserialize(from: jsonString) {    // …}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 這里注意一下,雖然Struct自己已經(jīng)幫助構(gòu)造了init初始化,但如果我們需要重載init,構(gòu)造我們自己的初始化,還是需要寫一下的。

 

3、HandyJSON支持枚舉,只需要enum構(gòu)造時服從HandyJSONEnum協(xié)議即可。

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

enum AnimalType: String, HandyJSONEnum {    case Cat = "cat"
    case Dog = "dog"
    case Bird = "bird"}struct Animal: HandyJSON {    var name: String?    var type: AnimalType?}

let jsonString = "{\"type\":\"cat\",\"name\":\"Tom\"}"if let animal = Animal.deserialize(from: jsonString) {
    print(animal.type?.rawValue)
}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

4、此外,HandyJSON還支持一些非基礎(chǔ)類型、復(fù)雜類型,包括嵌套結(jié)構(gòu),如可選、隱式解包可選、集合等

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

class BasicTypes: HandyJSON {    var bool: Bool = true
    var intOptional: Int?    var doubleImplicitlyUnwrapped: Double!    var anyObjectOptional: Any?    var arrayInt: Array<Int> = []    var arrayStringOptional: Array<String>?    var setInt: Set<Int>?    var dictAnyObject: Dictionary<String, Any> = [:]    var nsNumber = 2
    var nsString: NSString?

    required init() {}
}

let object = BasicTypes()object.intOptional = 1object.doubleImplicitlyUnwrapped = 1.1object.anyObjectOptional = "StringValue"object.arrayInt = [1, 2]object.arrayStringOptional = ["a", "b"]object.setInt = [1, 2]object.dictAnyObject = ["key1": 1, "key2": "stringValue"]object.nsNumber = 2object.nsString = "nsStringValue"let jsonString = object.toJSONString()!if let object = JSONDeserializer<BasicTypes>.deserializeFrom(json: jsonString) {    // ...}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

5、HandyJSON支持指定從哪個具體路徑開始解析,反序列化到Model。

這個比較常用,因為正常情況下,接口一般都會返回包括錯誤碼,錯誤消息,正式請求數(shù)據(jù)等,但我們一般只需要把正式數(shù)據(jù)轉(zhuǎn)換成Model即可。

我們可以這樣實現(xiàn):

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

class Cat: HandyJSON {    var id: Int64!    var name: String!

    required init() {}
}

let jsonString = "{\"code\":200,\"msg\":\"success\",\"data\":{\"cat\":{\"id\":12345,\"name\":\"Kitty\"}}}"if let cat = JSONDeserializer<Cat>.deserializeFrom(json: jsonString, designatedPath: "data.cat") {
    print(cat.name)
}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

其中,直接通過 designatedPath 定位到我們需要的節(jié)點處。

 

6、handyJSON支持有繼承關(guān)系的Model類,就是說及時某個類沒有實現(xiàn)HandyJSON協(xié)議,只要父類有實現(xiàn),依然可以轉(zhuǎn)化model。

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

class Animal: HandyJSON {    var id: Int?    var color: String?

    required init() {}
}class Cat: Animal {    var name: String?

    required init() {}
}

let jsonString = "{\"id\":12345,\"color\":\"black\",\"name\":\"cat\"}"if let cat = JSONDeserializer<Cat>.deserializeFrom(json: jsonString) {
    print(cat)
}

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

7、上面都是基本在說JSON轉(zhuǎn)模型,那么反過來實現(xiàn)呢?

HandyJSON還支持對象轉(zhuǎn)字典、對象轉(zhuǎn)模型。

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

class BasicTypes: HandyJSON {    var int: Int = 2
    var doubleOptional: Double?    var stringImplicitlyUnwrapped: String!

    required init() {}
}

let object = BasicTypes()object.int = 1object.doubleOptional = 1.1object.stringImplicitlyUnwrapped = “hello"print(object.toJSON()!) // 序列化到字典print(object.toJSONString()!) // 序列化到JSON字符串print(object.toJSONString(prettyPrint: true)!) // 序列化為格式化后的JSON字符串

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

如果需要Demo,可以這樣:

1、下載官方Demo:https://github.com/alibaba/HandyJSON

2、下載我的測試Demo:https://github.com/TangledHusky/TestSwift

 大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)大學(xué)生就業(yè)培訓(xùn),高中生培訓(xùn),在職人員轉(zhuǎn)行培訓(xùn),企業(yè)團訓(xùn)

 

 

http://www.cnblogs.com/yajunLi/p/7121950.html