10.2 使用JSONDecoder解析JSON数据

使用 JSONDecoder 解析 JSON 数据，就像拆开一份精心包装的礼物🎁！ 你会发现，这是一种将 JSON 数据转换成 Swift 数据模型的强大且便捷的方式。 让我们一起深入了解如何使用它吧！

JSONDecoder 简介

JSONDecoder 是 Swift Codable 协议的一部分，它的主要任务是将 JSON 数据解码成 Swift 对象。 简单来说，就是把从网络请求或其他来源获取的 JSON 字符串，转换成你可以直接在代码中使用的结构体或类。 这样，你就可以轻松访问和操作数据啦！

基本用法

使用 JSONDecoder 非常简单。 首先，你需要一个符合 Decodable 协议的 Swift 数据模型。 假设你有一个 User 结构体：

struct User: Decodable {
    let id: Int
    let name: String
    let email: String
}

接下来，你可以使用 JSONDecoder 将 JSON 数据转换成 User 对象：

let jsonString = """
{
    "id": 1,
    "name": "张三",
    "email": "zhangsan@example.com"
}
"""

let jsonData = jsonString.data(using: .utf8)!
let decoder = JSONDecoder()

do {
    let user = try decoder.decode(User.self, from: jsonData)
    print("用户ID：\(user.id)，用户名：\(user.name)，邮箱：\(user.email)")
} catch {
    print("解析JSON失败：\(error)")
}

这段代码首先将 JSON 字符串转换成 Data 对象，然后创建一个 JSONDecoder 实例。 接着，使用 decode(_:from:) 方法将 Data 对象解码成 User 对象。 如果一切顺利，你就可以访问 User 对象的属性了。 如果解析失败，catch 块会捕获错误并打印出来。

处理数组

JSONDecoder 也能轻松处理 JSON 数组。 假设你有一个包含多个 User 对象的 JSON 数组：

let jsonString = """
[
    {
        "id": 1,
        "name": "张三",
        "email": "zhangsan@example.com"
    },
    {
        "id": 2,
        "name": "李四",
        "email": "lisi@example.com"
    }
]
"""

let jsonData = jsonString.data(using: .utf8)!
let decoder = JSONDecoder()

do {
    let users = try decoder.decode([User].self, from: jsonData)
    for user in users {
        print("用户ID：\(user.id)，用户名：\(user.name)，邮箱：\(user.email)")
    }
} catch {
    print("解析JSON失败：\(error)")
}

只需要将 decode(_:from:) 方法的第一个参数改为 [User].self，就可以将 JSON 数组解码成 User 对象的数组啦！ 这样，你就可以遍历数组并访问每个 User 对象。

错误处理

在使用 JSONDecoder 时，错误处理至关重要。 JSON 数据可能不完整、格式不正确，或者与你的数据模型不匹配。 因此，务必使用 do-catch 块来捕获可能发生的错误。 常见的错误包括：

• DecodingError.dataCorrupted: JSON 数据损坏或格式不正确。
• DecodingError.keyNotFound: JSON 中缺少某个键。
• DecodingError.typeMismatch: JSON 中某个值的类型与数据模型不匹配。

通过仔细检查错误信息，你可以快速定位问题并进行修复。 例如，如果 JSON 中缺少 email 键，你可以提供一个默认值，或者将 email 属性声明为可选类型 (String?)。

总结

JSONDecoder 是一个非常强大的工具，可以帮助你轻松地将 JSON 数据转换成 Swift 对象。 掌握它的基本用法和错误处理技巧，可以让你在处理网络请求和数据持久化时更加得心应手。 记住，实践是最好的老师！ 多尝试不同的 JSON 数据和数据模型，你会越来越熟练的！ 💪