Swift4 JSON解析指南

╰+攻爆jí腚メ 2023-10-17 14:08 33阅读 0赞

原文链接[点击打开链接][Link 1]

Apple 终于在 Swift 4 的 Foundation 的模块中添加了对 JSON 解析的原生支持。

虽然已经有很多第三方类库实现了 JSON 解析，但是能够看到这样一个功能强大、易于使用的官方实现还是不免有些兴奋。

值得注意的是，官方的实现方式适用于任何 Encoder/Decoder ，例如 PropertyListEncoder 。当然如果你需要 XML 格式的内容，可以进行自定义实现。在接下来的内容中，我们将专注于 JSON 格式的解析，因为这是 iOS 开发中最常见的数据格式。

**基础**

如果你的 JSON 数据结构和你使用的 Model 对象结构一致的话，那么解析过程将会非常简单。

下面是一个 JSON 格式的啤酒说明：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"name"</code> 
      <code>:&nbsp;</code> 
      <code>"Endeavor"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"abv"</code> 
      <code>:&nbsp;8.9,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"brewery"</code> 
      <code>:&nbsp;</code> 
      <code>"Saint&nbsp;Arnold"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"style"</code> 
      <code>:&nbsp;</code> 
      <code>"ipa"</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

对应的 Swift 数据结构如下：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>enum&nbsp;BeerStyle&nbsp;:&nbsp;String&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>ipa</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>stout</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>kolsch</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>//&nbsp;...</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>struct&nbsp;Beer&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;name:&nbsp;String</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;brewery:&nbsp;String</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;style:&nbsp;BeerStyle</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

为了将 JSON 字符串转化为 Beer 类型的实例，我们需要将 Beer 类型标记为 Codable。

Codable 实际上是 Encodable & Decodable 两个协议的组合类型，所以如果你只需要单向转换的话，你可以只选用其中一个。该功能也是 Swift 4 中引入的最重要新特性之一。

Codable 带有默认实现，所以在大多数情形下，你可以直接使用该默认实现进行数据转换。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>enum&nbsp;BeerStyle&nbsp;:&nbsp;String,&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code> 
      <code>//&nbsp;...</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>struct&nbsp;Beer&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code> 
      <code>//&nbsp;...</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

下面只需要创建一个解码器：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>let&nbsp;jsonData&nbsp;=&nbsp;jsonString.data(encoding:&nbsp;.utf8)!</code> 
     </div> 
     <div> 
      <code>let&nbsp;decoder&nbsp;=&nbsp;JSONDecoder()</code> 
     </div> 
     <div> 
      <code>let&nbsp;beer&nbsp;=&nbsp;</code> 
      <code>try</code> 
      <code>!&nbsp;decoder.decode(Beer.self,&nbsp;</code> 
      <code>for</code> 
      <code>:&nbsp;jsonData)</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

这样我们就将 JSON 数据成功解析为了 Beer 实例对象。因为 JSON 数据的 Key 与 Beer 中的属性名一致，所以这里不需要进行自定义操作。

需要注意的是，这里直接使用了 try! 操作。因为这里只是简单示例，所以在真实程序中你应该对错误进行捕获并作出对应的处理。

但是，现实中不可能一直都是完美情形，很大几率存在 Key 值与属性名不匹配的情形。

**自定义键值名**

通常情形下，API 接口设计时会采用 snake-case 的命名风格，但是这与 Swift 中的编程风格有着明显的差异。

为了实现自定义解析，我们需要先去看下 Codable 的默认实现机制。

默认情形下 Keys 是由编译器自动生成的枚举类型。该枚举遵守 CodingKey 协议并建立了属性和编码后格式之间的关系。

为了解决上面的风格差异需要对其进行自定义，实现代码：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>struct&nbsp;Beer&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>//&nbsp;...</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>enum&nbsp;CodingKeys&nbsp;:&nbsp;String,&nbsp;CodingKey&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>name</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>abv&nbsp;=&nbsp;</code> 
      <code>"alcohol_by_volume"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>brewery&nbsp;=&nbsp;</code> 
      <code>"brewery_name"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>style</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

现在我们将 Beer 实例转化为 JSON ，看看自定义之后的 JSON 数据格式：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>let&nbsp;encoder&nbsp;=&nbsp;JSONEncoder()</code> 
     </div> 
     <div> 
      <code>let&nbsp;data&nbsp;=&nbsp;</code> 
      <code>try</code> 
      <code>!&nbsp;encoder.encode(beer)</code> 
     </div> 
     <div> 
      <code>print(String(data:&nbsp;data,&nbsp;encoding:&nbsp;.utf8)!)</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

输出如下：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
      <code>"style"</code> 
      <code>:</code> 
      <code>"ipa"</code> 
      <code>,</code> 
      <code>"name"</code> 
      <code>:</code> 
      <code>"Endeavor"</code> 
      <code>,</code> 
      <code>"alcohol_by_volume"</code> 
      <code>:8.8999996185302734,</code> 
      <code>"brewery_name"</code> 
      <code>:</code> 
      <code>"Saint&nbsp;Arnold"</code> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

上面的输出格式对阅读起来并不是太友好。不过我们可以设置 JSONEncoder 的 **outputFormatting** 属性来定义输出格式。

默认 **outputFormatting** 属性值为 **.compact**，输出效果如上。如果将其改为**.prettyPrinted** 后就能获得更好的阅读体检。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>encoder.outputFormatting&nbsp;=&nbsp;.prettyPrinted</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

效果如下：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"style"</code>&nbsp; 
      <code>:&nbsp;</code> 
      <code>"ipa"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"name"</code>&nbsp; 
      <code>:&nbsp;</code> 
      <code>"Endeavor"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"alcohol_by_volume"</code>&nbsp; 
      <code>:&nbsp;8.8999996185302734,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"brewery_name"</code>&nbsp; 
      <code>:&nbsp;</code> 
      <code>"Saint&nbsp;Arnold"</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

JSONEncoder 和 JSONDecoder 其实还有很多选项可以自定义设置。其中有一个常用的需求就是自定义时间格式的解析。

**时间格式处理**

JSON 没有数据类型表示日期格式，因此需要客户端和服务端对序列化进行约定。通常情形下都会使用 ISO 8601 日期格式并序列化为字符串。

**提示：nsdateformatter.com 是一个非常有用的网站，你可以查看各种日期格式的字符串表示，包括 ISO 8601。**

其他格式可能是参考日期起的总秒（或毫秒）数，并将其序列化为 JSON 格式中的数字类型。

之前，我们必须自己处理这个问题。在数据结构中使用属性接收该字符串格式日期，然后使用 DateFormatter 将该属性转化为日期，反之亦然。

不过 JSONEncoder 和 JSONDecoder 自带了该功能。默认情况下，它们使用 .deferToDate 处理日期，如下：

当然，我们也可以选用 **.iso8601** 格式：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>encoder.dateEncodingStrategy&nbsp;=&nbsp;.iso8601</code> 
     </div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"date"</code>&nbsp; 
      <code>:&nbsp;</code> 
      <code>"2017-06-21T15:29:32Z"</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

其他日期编码格式选择如下：

*  **.formatted(DateFormatter)** \- 当你的日期字符串是非标准格式时使用。需要提供你自己的日期格式化器实例。
 *  **.custom((Date, Encoder) throws** \-> Void ) - 当你需要真正意义上的自定义时，使用一个闭包进行实现。
 *  **.millisecondsSince1970、 .secondsSince1970** \- 这在 API 设计中不是很常见。 由于时区信息完全不在编码表示中，所以不建议使用这样的格式，这使得人们更容易做出错误的假设。

对日期进行 Decoding 时基本上是相同的选项，但是 .custom 形式是 .custom((Decoder) throws -> Date )，所以我们给了一个解码器并将任意类型转换为日期格式。

**浮点类型处理**

浮点是 JSON 与 Swift 另一个存在不匹配情形的类型。如果服务器返回的事无效的 "NaN" 字符串会发生什么？无穷大或者无穷大？这些不会映射到 Swift 中的任何特定值。

默认的实现是 .throw，这意味着如果上述数值出现的话就会引发错误，不过对此我们可以自定义映射。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div> 
    <div>
      14 
    </div> 
    <div>
      15 
    </div> 
    <div>
      16 
    </div> 
    <div>
      17 
    </div> 
    <div>
      18 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code> 
      <code>"a"</code> 
      <code>:&nbsp;</code> 
      <code>"NaN"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code> 
      <code>"b"</code> 
      <code>:&nbsp;</code> 
      <code>"+Infinity"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;</code> 
      <code>"c"</code> 
      <code>:&nbsp;</code> 
      <code>"-Infinity"</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div> 
      <code>struct&nbsp;Numbers&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>let&nbsp;a:&nbsp;Float</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>let&nbsp;b:&nbsp;Float</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>let&nbsp;c:&nbsp;Float</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
     <div> 
      <code>decoder.nonConformingFloatDecodingStrategy&nbsp;=</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>.convertFromString(</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>positiveInfinity:&nbsp;</code> 
      <code>"+Infinity"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>negativeInfinity:&nbsp;</code> 
      <code>"-Infinity"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>nan:&nbsp;</code> 
      <code>"NaN"</code> 
      <code>)</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>let&nbsp;numbers&nbsp;=&nbsp;</code> 
      <code>try</code> 
      <code>!&nbsp;decoder.decode(Numbers.elf,&nbsp;from:&nbsp;jsonData)</code> 
     </div> 
     <div> 
      <code>dump(numbers)</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

上述处理后：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>__lldb_expr_71.Numbers</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>-&nbsp;a:&nbsp;inf</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>-&nbsp;b:&nbsp;-inf</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>-&nbsp;c:&nbsp;nan</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

当然，我们也可以使用 JSONEncoder 的 nonConformingFloatEncodingStrategy 进行反向操作。

虽然大多数情形下上述处理不太可能出现，但是以防万一也不给过。

**Data 处理**

有时候服务端 API 返回的数据是 base64 编码过的字符串。

对此，我们可以在 JSONEncoder 使用以下策略：

*  .base64
 *  .custom((Data, Encoder) throws -> Void)

反之，编码时可以使用：

*  .base64
 *  .custom((Decoder) throws -> Data)

显然，.base64 时最常见的选项，但如果需要自定义的话可以采用 block 方式。

**Wrapper Keys**

通常 API 会对数据进行封装，这样顶级的 JSON 实体 始终是一个对象。

例如：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>"beers"</code> 
      <code>:&nbsp;[&nbsp;{...}&nbsp;]</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

在 Swift 中我们可以进行对应处理：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>struct&nbsp;BeerList&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;beers:&nbsp;[Beer]</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

因为键值与属性名一致，所有上面代码已经足够了。

**Root Level Arrays**

如果 API 作为根元素返回数组，对应解析如下所示：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>let&nbsp;decoder&nbsp;=&nbsp;JSONDecoder()</code> 
     </div> 
     <div> 
      <code>let&nbsp;beers&nbsp;=&nbsp;</code> 
      <code>try</code>&nbsp; 
      <code>decoder.decode([Beer].self,&nbsp;from:&nbsp;data)</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

需要注意的是，我们在这里使用 Array 作为类型。只要 T 可解码，Array 就可解码。

**Dealing with Object Wrapping Keys**

另一个常见的场景是，返回的数组对象里的每一个元素都被包装为字典类型对象。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>[</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"beer"</code>&nbsp; 
      <code>:&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"id"</code> 
      <code>:&nbsp;</code> 
      <code>"uuid12459078214"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"name"</code> 
      <code>:&nbsp;</code> 
      <code>"Endeavor"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"abv"</code> 
      <code>:&nbsp;8.9,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"brewery"</code> 
      <code>:&nbsp;</code> 
      <code>"Saint&nbsp;Arnold"</code> 
      <code>,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"style"</code> 
      <code>:&nbsp;</code> 
      <code>"ipa"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>]</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

你可以使用上面的方法来捕获此 Key 值，但最简单的方式就是认识到该结构的可编码的实现形式。

如下：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>[[String:Beer]]</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

或者更易于阅读的形式：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>Array</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

与上面的 Array 类似，如果 K 和 T 是可解码 Dictionary就能解码。

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>let&nbsp;decoder&nbsp;=&nbsp;JSONDecoder()</code> 
     </div> 
     <div> 
      <code>let&nbsp;beers&nbsp;=&nbsp;</code> 
      <code>try</code>&nbsp; 
      <code>decoder.decode([[String:Beer]].self,&nbsp;from:&nbsp;data)</code> 
     </div> 
     <div> 
      <code>dump(beers)</code> 
     </div> 
     <div> 
      <code>&nbsp;</code> 
      <code>1&nbsp;element</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;</code> 
      <code>?&nbsp;1&nbsp;key/value&nbsp;pair</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>?&nbsp;(2&nbsp;elements)</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>-&nbsp;key:&nbsp;</code> 
      <code>"beer"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>?&nbsp;value:&nbsp;__lldb_expr_37.Beer</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>-&nbsp;name:&nbsp;</code> 
      <code>"Endeavor"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>-&nbsp;brewery:&nbsp;</code> 
      <code>"Saint&nbsp;Arnold"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>-&nbsp;abv:&nbsp;8.89999962</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>-&nbsp;style:&nbsp;__lldb_expr_37.BeerStyle.ipa</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

**更复杂的嵌套**

有时候 API 的响应数据并不是那么简单。顶层元素不一定只是一个对象，而且通常情况下是多个字典结构。

例如：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div> 
    <div>
      14 
    </div> 
    <div>
      15 
    </div> 
    <div>
      16 
    </div> 
    <div>
      17 
    </div> 
    <div>
      18 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"meta"</code> 
      <code>:&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"page"</code> 
      <code>:&nbsp;1,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"total_pages"</code> 
      <code>:&nbsp;4,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"per_page"</code> 
      <code>:&nbsp;10,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"total_records"</code> 
      <code>:&nbsp;38</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>},</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"breweries"</code> 
      <code>:&nbsp;[</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"id"</code> 
      <code>:&nbsp;1234,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"name"</code> 
      <code>:&nbsp;</code> 
      <code>"Saint&nbsp;Arnold"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>},</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"id"</code> 
      <code>:&nbsp;52892,</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>"name"</code> 
      <code>:&nbsp;</code> 
      <code>"Buffalo&nbsp;Bayou"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>]</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

在 Swift 中我们可以进行对应的嵌套定义处理：

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div>
      1 
    </div> 
    <div>
      2 
    </div> 
    <div>
      3 
    </div> 
    <div>
      4 
    </div> 
    <div>
      5 
    </div> 
    <div>
      6 
    </div> 
    <div>
      7 
    </div> 
    <div>
      8 
    </div> 
    <div>
      9 
    </div> 
    <div>
      10 
    </div> 
    <div>
      11 
    </div> 
    <div>
      12 
    </div> 
    <div>
      13 
    </div> 
    <div>
      14 
    </div> 
    <div>
      15 
    </div> 
    <div>
      16 
    </div> 
    <div>
      17 
    </div> 
    <div>
      18 
    </div> 
    <div>
      19 
    </div> 
    <div>
      20 
    </div> 
    <div>
      21 
    </div> 
    <div>
      22 
    </div> </td> 
   <td> 
    <div> 
     <div> 
      <code>struct&nbsp;PagedBreweries&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>struct&nbsp;Meta&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;page:&nbsp;Int</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;totalPages:&nbsp;Int</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;perPage:&nbsp;Int</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;totalRecords:&nbsp;Int</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>enum&nbsp;CodingKeys&nbsp;:&nbsp;String,&nbsp;CodingKey&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>page</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>totalPages&nbsp;=&nbsp;</code> 
      <code>"total_pages"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>perPage&nbsp;=&nbsp;</code> 
      <code>"per_page"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>case</code>&nbsp; 
      <code>totalRecords&nbsp;=&nbsp;</code> 
      <code>"total_records"</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>struct&nbsp;Brewery&nbsp;:&nbsp;Codable&nbsp;{ </code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;id:&nbsp;Int</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;name:&nbsp;String</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>}</code> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;meta:&nbsp;Meta</code> 
     </div> 
     <div> 
      <code>&nbsp;&nbsp;&nbsp;&nbsp;</code> 
      <code>let&nbsp;breweries:&nbsp;[Brewery]</code> 
     </div> 
     <div> 
      <code>}</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

该方法的最大优点就是对同一类型的对象做出不同的响应（可能在这种情况下，“brewery” 列表响应中只需要 id 和 name 属性，但是如果查看详细内容的话则需要更多属性内容）。因为该情形下 Brewery 类型是嵌套的，我们依旧可以在其他地方进行不同的 Brewery 类型实现。

**结论**

Swift 4 中基础 Codable API 的内容已经介绍差不多了。更多的内容可以查看 [ Codable.swift][Codable.swift]、[Using JSON with Custom Types][] 。

[Link 1]: http://www.cocoachina.com/swift/20170630/19691.html
[Codable.swift]: https://github.com/apple/swift/blob/master/stdlib/public/core/Codable.swift
[Using JSON with Custom Types]: https://developer.apple.com/documentation/foundation/archives_and_serialization/using_json_with_custom_types