Swift Academy · 강의

JSONEncoder로 인코딩하기

Swift 값에서 JSON 데이터를 생성합니다.

JSONEncoder로 인코딩하기은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

JSONEncoder 생성

JSONEncoder는 모든 Encodable 값을 JSON Data로 변환하는 핵심 도구입니다. 하나를 만든 다음 값에 encode(_:)를 호출합니다.

import Foundation

struct Movie: Codable {
    var title: String
    var year: Int
}

let encoder = JSONEncoder()
let data = try encoder.encode(Movie(title: "Up", year: 2009))
print(data.count, "bytes")

Data에서 읽을 수 있는 문자열로

encode(_:)는 바이너리 Data를 반환합니다. 이를 읽으려면 String(data:encoding:)을 사용해 바이트를 UTF-8로 디코딩합니다.

import Foundation

struct Movie: Codable {
    var title: String
    var year: Int
}

let data = try JSONEncoder().encode(Movie(title: "Up", year: 2009))
let text = String(data: data, encoding: .utf8)!
print(text)

보기 좋게 정렬된 출력

기본적으로 JSON은 압축된 형태입니다. outputFormatting = .prettyPrinted를 설정하면 들여쓰기와 줄 바꿈이 추가되어 사람이 결과를 읽기 쉬워집니다.

import Foundation

struct Movie: Codable {
    var title: String
    var year: Int
}

let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted
let data = try encoder.encode(Movie(title: "Up", year: 2009))
print(String(data: data, encoding: .utf8)!)

안정적인 출력을 위한 키 정렬

배열을 사용해 옵션을 조합할 수 있습니다. .sortedKeys를 추가하면 키가 알파벳순으로 정렬되어 출력이 항상 일정해집니다. 테스트와 스냅샷에 특히 유용합니다.

import Foundation

struct Movie: Codable {
    var title: String
    var year: Int
    var rating: Double
}

let encoder = JSONEncoder()
encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
let data = try encoder.encode(Movie(title: "Up", year: 2009, rating: 4.8))
print(String(data: data, encoding: .utf8)!)

배열 인코딩

컬렉션을 직접 인코딩할 수 있습니다. Encodable 값의 배열은 JSON 배열이 됩니다.

import Foundation

struct Movie: Codable {
    var title: String
    var year: Int
}

let list = [Movie(title: "Up", year: 2009),
            Movie(title: "Coco", year: 2017)]
let data = try JSONEncoder().encode(list)
print(String(data: data, encoding: .utf8)!)

사전 인코딩

[String: Encodable-element] 사전은 JSON 객체로 인코딩됩니다. .sortedKeys를 추가하지 않으면 키 순서는 보장되지 않는다는 점에 유의하세요.

import Foundation

let scores: [String: Int] = ["alice": 90, "bob": 75]
let encoder = JSONEncoder()
encoder.outputFormatting = .sortedKeys
let data = try encoder.encode(scores)
print(String(data: data, encoding: .utf8)!)

중첩 구조 인코딩

중첩된 Codable 타입은 재귀적으로 인코딩되어 중첩된 JSON 객체를 자동으로 생성합니다.

import Foundation

struct Author: Codable { var name: String }
struct Post: Codable {
    var title: String
    var author: Author
}

let p = Post(title: "Hello", author: Author(name: "Mae"))
let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted
print(String(data: try encoder.encode(p), encoding: .utf8)!)

인코더 재사용

설정한 JSONEncoder는 여러 값에 재사용할 수 있습니다. 한 번 설정한 뒤 코드 전체에서 동일한 형식 설정을 계속 적용하세요.

import Foundation

struct Tag: Codable { var name: String }

let encoder = JSONEncoder()
encoder.outputFormatting = .sortedKeys
for t in [Tag(name: "swift"), Tag(name: "json")] {
    let data = try encoder.encode(t)
    print(String(data: data, encoding: .utf8)!)
}

숫자와 불리언 인코딩

숫자 및 불리언 프로퍼티는 JSON 리터럴로 인코딩되므로 따옴표가 붙지 않습니다. 문자열에는 따옴표가 붙지만 Int, Double, Bool에는 붙지 않습니다.

import Foundation

struct Stats: Codable {
    var count: Int
    var ratio: Double
    var enabled: Bool
}

let data = try JSONEncoder().encode(Stats(count: 3, ratio: 0.75, enabled: true))
print(String(data: data, encoding: .utf8)!)

옵셔널 인코딩

기본적으로 nil인 옵셔널은 JSON에서 완전히 제외됩니다. nil이 아닌 옵셔널은 감싸고 있는 값으로 인코딩됩니다.

import Foundation

struct Item: Codable {
    var name: String
    var note: String?
}

let data = try JSONEncoder().encode(Item(name: "Pen", note: nil))
print(String(data: data, encoding: .utf8)!)

종합하기

일반적인 인코딩 흐름은 값을 만들고, 인코더를 설정하고, encode를 호출한 다음, 기록이나 전송을 위해 Data를 String으로 변환하는 것입니다.

import Foundation

struct Order: Codable {
    var id: Int
    var items: [String]
}

let order = Order(id: 42, items: ["a", "b"])
let encoder = JSONEncoder()
encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
let data = try encoder.encode(order)
print(String(data: data, encoding: .utf8)!)

빠른 확인: JSONEncoder

인코딩에 대한 지식을 테스트해 보세요.

복습: JSONEncoder로 인코딩하기

Swift 값을 JSON으로 변환하는 방법을 배웠습니다:

encode(_:)는 Data를 반환하며, String(data:encoding:)으로 변환할 수 있습니다.
.prettyPrinted 및 .sortedKeys와 함께 사용하는 outputFormatting으로 형식을 제어합니다.
배열, 사전, 중첩 타입, 숫자, 불리언, 옵셔널을 모두 적절하게 인코딩할 수 있습니다.
설정한 인코더를 여러 값에 재사용할 수 있습니다.

자주 묻는 질문

“JSONEncoder로 인코딩하기” 강의는 무료인가요?

네 — “JSONEncoder로 인코딩하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“JSONEncoder로 인코딩하기”에서 뭘 배우나요?

Swift 값에서 JSON 데이터를 생성합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“JSONEncoder로 인코딩하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Swift Academy(으)로 돌아가기