Swift 4 JSON 解析指南
Apple 终于在 Swift 4 的 Foundation 的模块中添加了对 JSON 解析的原生支持。 虽然已经有很多第三方类库实现了 JSON 解析,但是能够看到这样一个功能强大、易于使用的官方实现还是不免有些兴奋。 值得注意的是,官方的实现方式适用于任何 Encoder/Decoder ,例如 PropertyListEncoder 。当然如果你需要 XML 格式的内容,可以进行自定义实现。在接下来的内容中,我们将专注于 JSON 格式的解析,因为这是 iOS 开发中最常见的数据格式。 基础如果你的 JSON 数据结构和你使用的 Model 对象结构一致的话,那么解析过程将会非常简单。 下面是一个JSON 格式的啤酒说明:
对应的 Swift 数据结构如下: enum BeerStyle String ? ?case ipa stout kolsch ? ?// ...}structBeerlet name brewery styleBeerStyle为了将 JSON 字符串转化为 Beer 类型的实例,我们需要将 Beer 类型标记为 Codable。 这样我们就将 JSON 数据成功解析为了 Beer 实例对象。因为 JSON 数据的 Key 与 Beer 中的属性名一致,所以这里不需要进行自定义操作。 需要注意的是,这里直接使用了 try! 操作。因为这里只是简单示例,所以在真实程序中你应该对错误进行捕获并作出对应的处理。 但是,现实中不可能一直都是完美情形,很大几率存在 Key 值与属性名不匹配的情形。 自定义键值名通常情形下,API 接口设计时会采用 snake-case 的命名风格,但是这与 Swift 中的编程风格有着明显的差异。 为了实现自定义解析,我们需要先去看下 Codable 的默认实现机制。 默认情形下 Keys 是由编译器自动生成的枚举类型。该枚举遵守 CodingKey 协议并建立了属性和编码后格式之间的关系。 为了解决上面的风格差异需要对其进行自定义,实现代码: ? ? ?// ... ? ? ?CodingKeysCodingKey ? ? ? ? ? name abv "alcohol_by_volume" brewery "brewery_name" style ? ?}现在我们将 Beer 实例转化为 JSON ,看看自定义之后的 JSON 数据格式:encoderJSONEncoder data encoderencodebeer)print data encoding)!) 输出如下: {:"alcohol_by_volume":8.8999996185302734"brewery_name"上面的输出格式对阅读起来并不是太友好。不过我们可以设置 JSONEncoder 的 outputFormatting 属性来定义输出格式。 效果如下: ?"style""name"JSONEncoder 和 JSONDecoder 其实还有很多选项可以自定义设置。其中有一个常用的需求就是自定义时间格式的解析。 "date"519751611.12542897当然,我们也可以选用 .iso8601 格式:dateEncodingStrategyiso8601 "2017-06-21T15:29:32Z"其他日期编码格式选择如下:
.millisecondsSince1970、 .secondsSince1970?- 这在 API 设计中不是很常见。 由于时区信息完全不在编码表示中,所以不建议使用这样的格式,这使得人们更容易做出错误的假设。 对日期进行 Decoding 时基本上是相同的选项,但是 .custom 形式是 .custom( (Decoder) throws -> Date ),所以我们给了一个解码器并将任意类型转换为日期格式。 浮点类型处理浮点是 JSON 与 Swift 另一个存在不匹配情形的类型。如果服务器返回的事无效的 "NaN" 字符串会发生什么?无穷大或者无穷大?这些不会映射到 Swift 中的任何特定值。 默认的实现是 .throw,这意味着如果上述数值出现的话就会引发错误,不过对此我们可以自定义映射。 ? "a""NaN""b""+Infinity""c""-Infinity"} Numbers ? aFloat b cFloat}decodernonConformingFloatDecodingStrategy ?convertFromString ? ? ?positiveInfinity ? ? ?negativeInfinity ? ? ?nan numbers Numberselffromdumpnumbers上述处理后:__lldb_expr_71.- infinf nan 当然,我们也可以使用 JSONEncoder 的 nonConformingFloatEncodingStrategy 进行反向操作。 虽然大多数情形下上述处理不太可能出现,但是以防万一也不给过。 Data 处理有时候服务端 API 返回的数据是 base64 编码过的字符串。 对此,我们可以在 JSONEncoder 使用以下策略:
反之,编码时可以使用:
显然,.base64 时最常见的选项,但如果需要自定义的话可以采用 block 方式。 Wrapper Keys通常 API 会对数据进行封装,这样顶级的 JSON 实体 始终是一个对象。 例如: "beers"[{...}]在 Swift 中我们可以进行对应处理:BeerListbeers[因为键值与属性名一致,所有上面代码已经足够了。 你可以使用上面的方法来捕获此 Key 值,但最简单的方式就是认识到该结构的可编码的实现形式。 如下: [[:]] 或者更易于阅读的形式: Array<Dictionary>> 与上面的 Array
([[]].beers1 element? key/value pair(2 elements) ? ? ? value __lldb_expr_37 ? ? ? ?"Endeavor""Saint Arnold" abv8.89999962ipa 更复杂的嵌套有时候 API 的响应数据并不是那么简单。顶层元素不一定只是一个对象,而且通常情况下是多个字典结构。 "meta" ? ? ? ?"page"1"total_pages"4"per_page"10"total_records"38},84); line-height: 20px; font-size: 13px !important; white-space: inherit !important;">"breweries" ? ? ? ? ? ?123452892"Buffalo Bayou"在 Swift 中我们可以进行对应的嵌套定义处理: PagedBreweriesMeta ? ? ? ? pageInt totalPages perPage totalRecords ? ? ? ? ? ? page totalPages "total_pages" perPage "per_page" totalRecords "total_records"Brewery id meta breweriesBrewery该方法的最大优点就是对同一类型的对象做出不同的响应(可能在这种情况下,“brewery” 列表响应中只需要 id 和 name 属性,但是如果查看详细内容的话则需要更多属性内容)。因为该情形下 Brewery 类型是嵌套的,我们依旧可以在其他地方进行不同的 Brewery 类型实现。 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |