使用SwiftyJSON进行自定义转换

SwiftyJSON 简化了 Swift 中的 JSON 处理，但有时你需要执行自定义转换，以使 JSON 数据适应应用程序的需求。自定义转换允许你将 JSON 值转换为更适合你的用例的特定 Swift 类型或格式。本章探讨如何使用 SwiftyJSON 实现自定义转换。

为什么需要自定义转换

JSON 数据的格式通常与应用程序的数据模型不完全一致。例如：

• JSON 可能将日期表示为字符串，但你的应用需要 Date 对象。
• JSON 中的数值可能需要转换为枚举或自定义类型。
• 嵌套的 JSON 结构可能需要展平或重新构造。

自定义转换弥合了这一差距，使你能够以适合应用程序逻辑的方式处理 JSON 数据。

基本自定义转换示例

让我们从一个简单的示例开始：将表示日期的 JSON 字符串转换为 Swift Date 对象。假设 JSON 如下所示：

{
  "event": "Conference",
  "date": "2023-10-15T14:30:00Z"
}

以下是将 date 字符串转换为 Date 对象的方法：

import SwiftyJSON
import Foundation

// 示例 JSON 字符串
let jsonString = """
{
  "event": "Conference",
  "date": "2023-10-15T14:30:00Z"
}
"""

// 使用 SwiftyJSON 解析 JSON
if let json = try? JSON(data: jsonString.data(using: .utf8)!) {
    // 定义日期格式化器以解析 ISO 8601 日期字符串
    let dateFormatter = ISO8601DateFormatter()
    
    // 从 JSON 中获取日期字符串
    if let dateString = json["date"].string {
        // 将字符串转换为 Date 对象
        if let date = dateFormatter.date(from: dateString) {
            print("活动：\(json["event"].stringValue)，日期：\(date)")
        } else {
            print("解析日期失败")
        }
    } else {
        print("未找到 date 键或其不是字符串类型")
    }
}

在这个示例中，我们使用 ISO8601DateFormatter 将 JSON 字符串转换为 Date 对象。这是一个基本的转换，但它展示了核心概念。

转换 JSON 数组

处理 JSON 数组时，自定义转换也很有用。例如，考虑一个表示摄氏度温度的 JSON 数组，你希望将其转换为华氏度：

{
  "temperatures": [20, 25, 30, 15]
}

以下是转换该数组的方法：

import SwiftyJSON

// 示例 JSON 字符串
let jsonString = """
{
  "temperatures": [20, 25, 30, 15]
}
"""

// 使用 SwiftyJSON 解析 JSON
if let json = try? JSON(data: jsonString.data(using: .utf8)!) {
    // 获取温度数组
    if let temperatures = json["temperatures"].array {
        // 将摄氏度转换为华氏度
        let fahrenheitTemperatures = temperatures.map { ($0.doubleValue * 9/5) + 32 }
        print("华氏度温度：\(fahrenheitTemperatures)")
    } else {
        print("未找到 temperatures 键或其不是数组类型")
    }
}

这个示例使用 map 函数对数组中的每个元素应用转换。

高级自定义转换

对于更复杂的场景，你可能需要转换嵌套的 JSON 结构或应用多个转换。考虑以下 JSON：

{
  "user": {
    "name": "John Doe",
    "age": 30,
    "preferences": {
      "theme": "dark",
      "notifications": true
    }
  }
}

假设你想展平这个结构，并将 preferences 对象转换为自定义的 UserPreferences 类型：

import SwiftyJSON

// 定义自定义的 UserPreferences 类型
struct UserPreferences {
    let theme: String
    let notifications: Bool
}

// 示例 JSON 字符串
let jsonString = """
{
  "user": {
    "name": "John Doe",
    "age": 30,
    "preferences": {
      "theme": "dark",
      "notifications": true
    }
  }
}
"""

// 使用 SwiftyJSON 解析 JSON
if let json = try? JSON(data: jsonString.data(using: .utf8)!) {
    // 获取嵌套的 preferences 对象
    if let preferences = json["user"]["preferences"].dictionary {
        // 将 preferences 字典转换为 UserPreferences 对象
        let userPreferences = UserPreferences(
            theme: preferences["theme"]?.stringValue ?? "light",
            notifications: preferences["notifications"]?.boolValue ?? false
        )
        print("用户偏好：\(userPreferences)")
    } else {
        print("未找到 preferences 键或其不是字典类型")
    }
}

这个示例展示了如何提取嵌套的 JSON 数据并将其转换为自定义的 Swift 类型。

处理转换中的可选值

执行自定义转换时，安全地处理可选值非常重要。SwiftyJSON 提供了 .stringValue、.intValue 和 .boolValue 等方法，以安全地解包带有默认 fallback 的值。例如：

import SwiftyJSON

// 示例 JSON 字符串
let jsonString = """
{
  "name": "Jane Doe",
  "age": null
}
"""

// 使用 SwiftyJSON 解析 JSON
if let json = try? JSON(data: jsonString.data(using: .utf8)!) {
    // 使用默认 fallback 安全地获取可选值
    let name = json["name"].stringValue // 如果缺失，默认为空字符串
    let age = json["age"].intValue // 如果缺失或为 null，默认为 0
    print("姓名：\(name)，年龄：\(age)")
}

这种方法确保你的转换具有鲁棒性，并能优雅地处理缺失或无效的数据。

组合转换

在实际应用中，你通常需要组合多个转换。例如，你可能需要解析 JSON 对象数组，转换每个对象，然后过滤结果。以下是一个示例：

{
  "products": [
    { "name": "Laptop", "price": 1200 },
    { "name": "Phone", "price": 800 },
    { "name": "Tablet", "price": 600 }
  ]
}

假设你想过滤价格高于 700 美元的产品，并将它们转换为自定义的 Product 类型：

import SwiftyJSON

// 定义自定义的 Product 类型
struct Product {
    let name: String
    let price: Double
}

// 示例 JSON 字符串
let jsonString = """
{
  "products": [
    { "name": "Laptop", "price": 1200 },
    { "name": "Phone", "price": 800 },
    { "name": "Tablet", "price": 600 }
  ]
}
"""

// 使用 SwiftyJSON 解析 JSON
if let json = try? JSON(data: jsonString.data(using: .utf8)!) {
    // 获取 products 数组
    if let products = json["products"].array {
        // 转换并过滤产品
        let filteredProducts = products.compactMap { productJSON in
            let price = productJSON["price"].doubleValue
            guard price > 700 else { return nil }
            return Product(
                name: productJSON["name"].stringValue,
                price: price
            )
        }
        print("过滤后的产品：\(filteredProducts)")
    } else {
        print("未找到 products 键或其不是数组类型")
    }
}

这个示例结合了过滤和转换，以产生精确的结果。

自定义转换的最佳实践

1. 使用描述性变量名：为变量和类型选择有意义的名称，以提高代码的可读性。
2. 优雅地处理错误：在转换中始终考虑缺失或无效的数据。
3. 利用 SwiftyJSON 的便捷方法：使用 .stringValue、.intValue 和类似方法简化可选值的解包。
4. 保持转换的模块化：将复杂的转换分解为更小的函数或方法，以提高可维护性。

通过掌握自定义转换，你可以使 SwiftyJSON 成为处理 Swift 应用程序中 JSON 数据的更强大工具。