JSON을 Codable을 채택한 Swift struct로 변환합니다. 프로퍼티는 let으로 선언되고 이름은 camelCase로 바뀌며, JSON 키와 이름이 달라지는 struct에만 CodingKeys enum을 만들어 줍니다.
iOS·macOS 앱에서 URLSession으로 받은 응답을 JSONDecoder로 디코딩할 모델이 필요할 때, SwiftUI 미리보기용 목업 JSON에 맞는 타입을 빠르게 만들고 싶을 때 유용합니다.
타입 이름에 최상위 struct 이름을 적습니다(예: EpisodePage).import Foundation이 포함되어 있습니다.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"
}
}
episodes 배열 요소는 Episode struct가 되었습니다. duration은 정수(1840)와 소수(2215.5)가 섞여 Double, 두 번째 에피소드에만 있는 guest_name은 guestName: String?입니다. 이름이 바뀐 필드가 있는 struct에는 모든 키를 나열한 CodingKeys가 생깁니다.
Codable 채택, 프로퍼티는 불변 let.enum CodingKeys: String, CodingKey로 원래 키를 지정합니다.String, Int, Double, Bool, 배열은 [T].null이 섞인 필드는 Optional(String?)이 되어 키가 없어도 디코딩됩니다.JSONValue enum을 함께 만들어 그 타입으로 둡니다.default, class, self 같은 Swift 키워드 키는 백틱으로 감쌉니다.typealias Root = [RootItem]을 만듭니다.let (data, _) = try await URLSession.shared.data(from: url) 다음 줄에 바로 JSONDecoder().decode를 쓸 수 있는 모델을 응답 예시 하나로 만들 수 있습니다.
생성된 struct에 Identifiable만 추가하면(id 필드가 있는 경우) List(page.episodes) { ... }에 바로 넘길 수 있습니다.
디자인 단계에서 받은 샘플 JSON을 앱 번들에 넣고 같은 모델로 디코딩하면, 실제 API가 준비되기 전에도 화면을 만들 수 있습니다.
String으로 나옵니다. Date로 받으려면 프로퍼티 타입을 바꾸고 decoder.dateDecodingStrategy = .iso8601 같은 전략을 설정하세요.DecodingError.keyNotFound가 납니다. 예시에 항상 있던 필드라도 API에서 빠질 수 있다면 ?를 붙이세요.let이라 값을 바꿔야 하는 화면 상태용 모델이라면 var로 바꿔야 합니다.Identifiable, Hashable 같은 추가 프로토콜은 채택하지 않습니다.JSONValue enum은 섞인 타입을 처리하기 위한 보조 코드라, 이미 프로젝트에 비슷한 타입이 있다면 지우고 그 타입을 쓰면 됩니다.keyDecodingStrategy = .convertFromSnakeCase를 쓰면 CodingKeys를 지워도 되나요?네, 그렇게 하면 guest_name ↔ guestName 변환을 디코더가 해 줍니다. 단, 두 방식을 같이 쓰면 디코더가 키를 먼저 camelCase로 바꾼 뒤 CodingKeys의 "guest_name"과 비교해서 매칭에 실패하니 하나만 쓰세요.
응답 모델은 값 타입으로 다루는 것이 Swift의 일반적인 관례이고, struct는 멤버와이즈 이니셜라이저가 자동으로 생겨 테스트 데이터를 만들기도 쉽습니다. 참조 의미가 필요하면 final class로 바꾸고 이니셜라이저를 추가하세요.
Double로 나온 필드가 있어요.같은 키에 정수와 소수가 섞여 있으면 정보 손실이 없도록 Double이 됩니다. 반대로 예시의 값이 모두 4.0처럼 소수점 아래가 0이면 브라우저 JSON 파서가 정수로 읽어 Int가 될 수 있으니, 실제 API 값을 확인하세요.
CodingKeys가 인코딩에도 쓰이므로 JSONEncoder로 다시 직렬화하면 guest_name처럼 원래 키로 나옵니다. Optional 값이 nil이면 해당 키는 생략됩니다.