Chuyển JSON thành các struct Swift tuân theo Codable. Property được khai báo bằng let và đổi tên sang camelCase, và enum CodingKeys chỉ được tạo cho những struct có tên khác với key JSON.
Dùng nó khi app iOS hay macOS cần model để decode response của URLSession bằng JSONDecoder, hoặc khi bạn muốn có kiểu khớp với JSON giả đứng sau một SwiftUI preview.
Tên kiểu là tên struct cấp cao nhất (ví dụ EpisodePage).import Foundation đã có sẵn.try JSONDecoder().decode(EpisodePage.self, from: data).{
"podcast": "Swift Talk",
"episodes": [
{ "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
{ "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
],
"total_count": 2
}import Foundation
struct EpisodePage: Codable {
let podcast: String
let episodes: [Episode]
let totalCount: Int
enum CodingKeys: String, CodingKey {
case podcast
case episodes
case totalCount = "total_count"
}
}
struct Episode: Codable {
let id: Int
let title: String
let duration: Double
let explicit: Bool
let guestName: String?
enum CodingKeys: String, CodingKey {
case id
case title
case duration
case explicit
case guestName = "guest_name"
}
}
Phần tử của mảng episodes thành struct Episode. duration trộn số nguyên (1840) và số thập phân (2215.5) nên là Double; guest_name, chỉ có ở tập thứ hai, là guestName: String?. Struct nào có field bị đổi tên đều nhận enum CodingKeys liệt kê toàn bộ key của nó.
Codable; property là let bất biến.enum CodingKeys: String, CodingKey mới được thêm vào cùng các key gốc.String, Int, Double, Bool, và [T] cho mảng.null là Optional (String?), nên key bị thiếu vẫn decode được.JSONValue được tạo kèm, có thể decode.default, class hay self được bọc trong backtick.typealias Root = [RootItem].Chỉ từ một response mẫu, bạn có model để decode ngay ở dòng sau let (data, _) = try await URLSession.shared.data(from: url).
Thêm Identifiable vào struct được tạo (khi nó có field id) và truyền thẳng vào List(page.episodes) { ... }.
Đưa JSON mẫu từ giai đoạn thiết kế vào app bundle và decode bằng cùng model đó, để dựng màn hình trước khi API thật sẵn sàng.
String. Để có Date, đổi kiểu property và đặt chiến lược như decoder.dateDecodingStrategy = .iso8601.DecodingError.keyNotFound. Hãy thêm ? cho field mà API có thể bỏ qua, kể cả khi mẫu của bạn luôn có chúng.let; đổi sang var cho model bạn thay đổi như view state.Identifiable hay Hashable.JSONValue là code hỗ trợ cho kiểu lẫn lộn; nếu dự án đã có kiểu tương đương, hãy xóa nó và dùng cái của bạn.keyDecodingStrategy = .convertFromSnakeCase, có xóa CodingKeys được không?Được, khi đó decoder tự chuyển guest_name ↔ guestName. Nhưng đừng kết hợp cả hai: decoder chuyển key sang camelCase trước rồi mới so với raw value "guest_name" trong CodingKeys, nên việc so khớp thất bại.
Coi model response là value type là quy ước thông thường của Swift, và struct có sẵn memberwise initializer, giúp dựng dữ liệu test dễ dàng. Nếu cần ngữ nghĩa tham chiếu, hãy đổi thành final class và thêm initializer.
Double.Khi một key chứa cả số nguyên lẫn số thập phân, Double tránh mất độ chính xác. Ngược lại, nếu mọi giá trị mẫu đều như 4.0, JSON parser của trình duyệt đọc nó thành số nguyên và bạn có thể nhận Int, nên hãy kiểm tra giá trị thật của API.
CodingKeys cũng được dùng khi encode, nên JSONEncoder lại ghi ra guest_name. Property optional đang là nil bị bỏ khỏi output.