编码数据到JSON

使用 JSONEncoder 将 Swift 数据结构转换为 JSON 格式是网络请求中的关键一步。这对于发送 POST 请求体至关重要。你将发现它非常直观且强大。🚀

这个过程确保你的 Swift 对象能够被服务器正确解析。大约 85% 的现代 API 都倾向于接收 JSON 数据。

JSONEncoder 的基本用法

JSONEncoder 是 Swift Codable 协议的一部分。它允许你轻松地将符合 Encodable 协议的 Swift 类型转换为 Data 对象。这个 Data 对象就是你的 JSON 请求体。

你只需要创建一个 JSONEncoder 实例，然后调用其 encode 方法。

let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted // 可选：为了可读性

将 Swift 对象编码为 Data

现在，让我们看看如何将你的 Swift 模型编码为 Data。假设你有一个 User 结构体，它符合 Encodable 协议。

struct User: Encodable {
    let name: String
    let email: String
}

let newUser = User(name: "张三", email: "zhangsan@example.com")

do {
    let jsonData = try encoder.encode(newUser)
    print(String(data: jsonData, encoding: .utf8)!)
} catch {
    print("编码失败: \(error)")
}

这个过程非常高效，通常在几毫秒内完成。

处理编码选项

JSONEncoder 提供了多种配置选项，以满足不同的需求。这些选项可以帮助你控制输出 JSON 的格式。

一些常用的 outputFormatting 选项包括：

• .prettyPrinted: 生成可读性更好的 JSON，带有缩进和换行。
• .sortedKeys: 按键的字母顺序排序 JSON 字典的键。

你还可以自定义日期和数据编码策略。例如，你可以指定日期如何被编码为字符串或时间戳。

1. 日期编码策略:
   • .deferredToDate
   • .iso8601
   • .formatted(formatter)
2. 数据编码策略:
   • .deferredToData
   • .base64

通过这些选项，你可以确保生成的 JSON 完全符合你的 API 规范。这大大提升了你处理复杂网络请求的能力。💪 掌握 JSONEncoder 将使你的网络请求代码更加健壮和灵活。