动手写个 JSON-Model Mapping 库

Swift 在 JSON解析方面有个比较有名的第三方库——SwiftyJSON,之前我也一直用的它。虽然用着还不错,但是它主要是为了避免手动解析 JSON 数据时大量的解包操作,降低解包不当导致 crash 的风险,感觉主要是注重安全性,易用性方面还是差了点。它支持下标操作,但毕竟是以字符串为键取值,IDE 不能自动补全,不仅麻烦还容易写错,而且用下标取到的值是JSON类型,一般还需要再进行类型转换,终究没有操作一个 Model 来得方便。所以我一直想写一个 JSON-Model 的映射器,我想要的效果是这样的:

  • 定义一个 Model :
class JSONModel {
    var error = ""
    var count = 0
    var posts = []
}
  • 发送网络请求后取得数据,然后直接转换成 JSONModel :
let jsonModel = data => JSOMModel.self

就这点需求,换个动态语言那根本不是事儿,哪怕在 C# 这样的静态语言中也能很简单地实现,只要用到反射特性就行了。然而 Swift 的反射实在是太弱了,运行期只能查看属性却不能给属性赋值。这简直无解,我读了一下 SwiftyJSON 的源码希望能找点灵感,然后发现 SwfityJSON 的流程是这样的(以直接解析 NSData 数据为例):

  • 以一个 NSData 类型的数据作为构造器参数实例化一个 JSON(一个 struct ),在构造器中调用 NSJSONSerialization.JSONObjectWithData(...)方法,如果 data 能被反序列化成一个 AnyObject 类型的对象的话,就调用另一个构造器,把这个对象赋值给实例属性 object ,否则就给object赋一个NSNull()

  • object是一个计算属性,在给它赋值时,会对它的类型进行判断,然后把它的类型信息存储到实例属性type中(type是一个自定义的枚举类型,这个枚举类型基本对应了 Swift 中的几种基本类型),最后把object的值进行类型转化后赋值给JSON中的一个特定类型的私有属性,譬如是数组的话就赋值给rawArray,是字符串的话就赋值给rawString,等等。

  • 在获取object时会先判断实例属性type,根据type的值返回对应的 rawValue,譬如 type == .String的话,就返回 rawString。然后像arrayarrayValue这样的都是计算属性,array的话会先去判断type是不是.Array,是就返回rawArray,否则返回nil,而arrayValue不会返回nil,若类型不匹配则返回一个空数组[]

别的当然还有一些内容,譬如自定义下标,实现各种协议(字符串字面量协议、判等协议、比较协议、打印协议等等),代码很优雅,但似乎没有我想要的东西。

最终我觉得,用 Swfit 的原生语法应该是办不到了,只能借助于 OC 的 runtime。主要是要用到 KVC,这样一来所有的 Model 都得继承自 NSObject。我写了个 Demo,从联网获取数据到显示数据的整个流程如下:

  • 先看看JSON数据的结构:
JSON.png
  • 定义两个Model:
class JSONModel: NSObject {
    var error = ""
    var count = 0
    var posts = []
}
class PostModel: NSObject {
    var id = 0
    var date = NSDate()
    var name = ""
    var pic = ""
    var publishtime = ""
    var count = 0
    var excerpt = ""
}
  • 发送网络请求(你可以使用 Alamore 或别的什么库,我这边是自己简单封装了一下 NSURLSession 直接用了),然后将取得的数据先转化成 JSONModel(直接使用=>符号),保存到实例属性jsonModel中:
getDataFromUrl(Constant.DemoAPI, method: .GET, parameter: nil) { data, error in
    if let jsonData = data {
        self.jsonModel = jsonData => JSONModel.self
    }
    
    if let httpError = error {
        print(httpError)
    }
}
  • jsonModel一旦被赋值就会刷新tableView,看一下配置cell的方法:
func configCell(cell: UITableViewCell, indexPath: NSIndexPath) -> UITableViewCell {
    
    if let model = jsonModel, post = model.posts[indexPath.section] => PostModel.self {
        cell.textLabel?.text = post.excerpt
    }
    
    return cell
}

override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCellWithIdentifier(Constant.ReuseIdentifier, forIndexPath: indexPath)
    
    // Configure the cell...
    return configCell(cell, indexPath: indexPath)
    
}

也是用=>直接把posts数组中的元素都转化为PostModel类型的实例了,然后直接cell.textLabel?.text = post.excerpt,就把我们想显示的内容放到cell里了。

显示数据.png

使用就是这么简单,只要新建一个NSObject的子类,属性名保证跟 JSON 中的一致,并给各个属性一个初始值。如果想另取属性名也是可以的,用计算属性就好了,譬如 Demo 中 publishtime 是不符合 Swift 属性命名规范的,我们不去改原 Model,而是用一个扩展:

extension PostModel {
    var publishTime: String {
        return publishtime
    }
}

这虽然不是很完美(因为publishtime还在),但也凑合能用了。

转换器主要是用到了反射( Mirror 实现)和 KVC ,代码就不贴了,大家可以去 Github直接看源码,clone 下来跑一下 Demo 看看。要用到自己的项目中的话直接把 JSONModelMapper.swift文件或者连同HTTPManager.swift一起拖到项目中好了,因为实在“超轻量级”(简陋……),我觉得这样最方便了。

觉得还算有用的话随手点个 Star 可好……当然有什么意见或建议的话欢迎指教。源码在这里

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 201,552评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,666评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,519评论 0 334
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,180评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,205评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,344评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,781评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,449评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,635评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,467评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,515评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,217评论 3 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,775评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,851评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,084评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,637评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,204评论 2 341

推荐阅读更多精彩内容