1. Codable协议深度解析
1.1 Codable的本质与设计哲学
Codable协议是Swift标准库中数据序列化的核心抽象,它实际上是Encodable和Decodable两个协议的类型别名。这种设计体现了Swift协议组合的强大能力,也反映了Swift团队对数据编解码这一常见任务的深刻思考。
swift复制public typealias Codable = Encodable & Decodable
标准库中的基础类型如Int、String、Double、Bool、Date、Data、URL等都默认遵循了Codable协议。这种设计使得开发者在使用这些基础类型进行数据交换时几乎不需要额外工作。Swift编译器会自动为符合Codable的简单结构体合成所需的编解码实现,这种特性被称为"自动合成"(automatic synthesis)。
提示:当你的类型所有存储属性都符合Codable时,编译器会自动生成encode(to:)和init(from:)实现。如果存在不符合Codable的属性,或者需要自定义编解码行为,则需要手动实现这些方法。
1.2 基础用法与自定义键名
让我们从一个典型的使用场景开始 - 用户数据模型的编解码:
swift复制struct User: Codable {
let id: Int
let name: String
let email: String
let createdAt: Date
// 自定义键名映射
enum CodingKeys: String, CodingKey {
case id, name, email
case createdAt = "created_at" // 将驼峰命名映射为下划线命名
}
}
在这个例子中,我们通过嵌套的CodingKeys枚举实现了Swift属性名与JSON字段名的映射。这在处理API响应时特别有用,因为后端接口通常使用下划线命名法,而Swift社区更倾向于驼峰命名法。
实际编解码操作示例:
swift复制let jsonData = """
{
"id": 1,
"name": "张三",
"email": "zhangsan@example.com",
"created_at": "2024-01-13T10:00:00Z"
}
""".data(using: .utf8)!
// 配置解码器
let decoder = JSONDecoder()
decoder.dateDecodingStrategy = .iso8601 // 处理日期格式
do {
let user = try decoder.decode(User.self, from: jsonData)
print("解码成功: \(user)")
// 编码回JSON
let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted
encoder.dateEncodingStrategy = .iso8601
let encodedData = try encoder.encode(user)
if let jsonString = String(data: encodedData, encoding: .utf8) {
print("编码结果:\n\(jsonString)")
}
} catch {
print("编解码错误: \(error)")
}
1.3 高级特性与自定义编解码
当标准编解码行为不能满足需求时,我们可以完全控制编解码过程。以下是几种常见的高级用法:
条件编码 - 只编码非nil值:
swift复制struct Product: Codable {
let id: Int
let name: String
var price: Double? // 可选价格
func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
try container.encode(id, forKey: .id)
try container.encode(name, forKey: .name)
// 只有当price有值时才会编码
try container.encodeIfPresent(price, forKey: .price)
}
}
类继承与Codable - 处理类层次结构:
swift复制class Vehicle: Codable {
var brand: String
var year: Int
// 必需实现的自定义解码
required init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
brand = try container.decode(String.self, forKey: .brand)
year = try container.decode(Int.self, forKey: .year)
}
}
class Car: Vehicle {
var numberOfDoors: Int
private enum CodingKeys: String, CodingKey {
case numberOfDoors
}
required init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
numberOfDoors = try container.decode(Int.self, forKey: .numberOfDoors)
try super.init(from: decoder)
}
override func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
try container.encode(numberOfDoors, forKey: .numberOfDoors)
try super.encode(to: encoder)
}
}
处理多态类型 - 当需要编码解码一个类层次结构时:
swift复制enum VehicleType: String, Codable {
case car, truck, motorcycle
}
struct Garage: Codable {
var vehicles: [Vehicle]
enum CodingKeys: String, CodingKey {
case vehicles
case vehicleType
}
init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
var vehiclesArray = try container.nestedUnkeyedContainer(forKey: .vehicles)
var decodedVehicles = [Vehicle]()
while !vehiclesArray.isAtEnd {
let vehicleContainer = try vehiclesArray.nestedContainer(keyedBy: CodingKeys.self)
let type = try vehicleContainer.decode(VehicleType.self, forKey: .vehicleType)
switch type {
case .car:
decodedVehicles.append(try vehiclesArray.decode(Car.self))
case .truck:
decodedVehicles.append(try vehiclesArray.decode(Truck.self))
case .motorcycle:
decodedVehicles.append(try vehiclesArray.decode(Motorcycle.self))
}
}
vehicles = decodedVehicles
}
func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
var vehiclesContainer = container.nestedUnkeyedContainer(forKey: .vehicles)
for vehicle in vehicles {
var vehicleContainer = vehiclesContainer.nestedContainer(keyedBy: CodingKeys.self)
if let car = vehicle as? Car {
try vehicleContainer.encode(VehicleType.car, forKey: .vehicleType)
try vehiclesContainer.encode(car)
}
// 其他类型处理类似...
}
}
}
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 字典(Dictionary)的全面剖析
2.1 字典基础与核心特性
字典是Swift中存储键值对集合的主要数据结构,它提供了基于键的快速查找能力。Swift字典是泛型类型,可以指定键和值的具体类型,这为类型安全提供了保障。
swift复制// 各种字典声明方式
var dict1: [String: Any] = [:] // 值类型为Any,可以存储任意类型
var dict2: [Int: String] = [:] // 键为Int,值为String
var dict3: Dictionary<String, Double> = [:] // 完整语法形式
// 字典字面量初始化
var userInfo: [String: Any] = [
"name": "李四",
"age": 25,
"scores": [85, 90, 78],
"isActive": true
]
字典的基本操作包括增
