0Pricing
Swift Academy · 강의

콘텐츠와 JSON 인코딩

요청 및 응답 본문을 디코딩하고 인코딩합니다.

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

Content 프로토콜

HTTP를 통해 전달되는 Vapor 모델은 Content를 준수합니다. Content는 Swift의 Codable을 기반으로 하며, 요청 본문에서 디코딩하고 응답으로 자동 인코딩하는 기능을 추가합니다.

import Vapor

struct Todo: Content {
    var id: Int?
    var title: String
    var done: Bool
}

응답을 JSON으로 인코딩하기

처리기에서 어떤 Content 값이든 반환하면 Vapor가 이를 JSON으로 인코딩하고 올바른 Content-Type 헤더를 대신 설정합니다.

app.get("todo") { req -> Todo in
    Todo(id: 1, title: "Learn Vapor", done: false)
}

요청 본문 디코딩하기

req.content.decode(_:)를 사용해 들어오는 요청에서 형식이 지정된 페이로드를 읽으십시오. Vapor는 Content-Type을 확인하고 그에 맞게 JSON(또는 폼 데이터)을 구문 분석합니다.

app.post("todo") { req -> Todo in
    let incoming = try req.content.decode(Todo.self)
    return incoming
}

콘텐츠로 사용하는 배열

Content 형식의 컬렉션은 자동으로 JSON 배열로 인코딩됩니다. [Todo]를 반환하면 클라이언트는 JSON 목록을 받습니다.

app.get("todos") { req -> [Todo] in
    [Todo(id: 1, title: "A", done: false),
     Todo(id: 2, title: "B", done: true)]
}

사용자 지정 코딩 키

Content는 Codable이므로 CodingKeys를 사용해 Swift 속성 이름을 다른 JSON 키에 매핑할 수 있습니다. snake_case API에 유용합니다.

struct User: Content {
    var firstName: String
    enum CodingKeys: String, CodingKey {
        case firstName = "first_name"
    }
}

JSON 인코더 구성하기

ContentConfiguration을 통해 전역 인코딩 전략을 설정할 수 있습니다. 예를 들어 모든 키를 snake_case로 변환하거나 날짜를 ISO-8601 형식으로 지정할 수 있습니다.

let encoder = JSONEncoder()
encoder.keyEncodingStrategy = .convertToSnakeCase
encoder.dateEncodingStrategy = .iso8601
ContentConfiguration.global.use(encoder: encoder, for: .json)

디코딩한 콘텐츠 검증하기

Vapor의 Validatable 프로토콜을 사용하면 검증 규칙을 선언할 수 있습니다. 디코딩하기 전에 try Todo.validate(content: req)를 호출하면 잘못된 입력을 명확한 400 오류와 함께 거부할 수 있습니다.

extension Todo: Validatable {
    static func validations(_ v: inout Validations) {
        v.add("title", as: String.self, is: !.empty)
    }
}

처리기에서 검증 사용하기

먼저 검증한 다음 디코딩하십시오. 검증에 실패하면 Vapor가 자동으로 오류를 던지고 클라이언트는 자세한 오류 응답을 받습니다.

app.post("todo") { req -> Todo in
    try Todo.validate(content: req)
    return try req.content.decode(Todo.self)
}

요청과 응답 데이터 전송 객체 분리하기

입력과 출력에 서로 다른 형식을 사용하는 것이 좋습니다. 예를 들어 요청에는 id가 없는 CreateTodo를 사용하고, 응답에는 완전한 Todo를 사용할 수 있습니다. 이렇게 하면 API와 내부 모델을 분리할 수 있습니다.

struct CreateTodo: Content {
    var title: String
}
struct TodoResponse: Content {
    var id: Int
    var title: String
}

쿼리 문자열 인코딩하기

동일한 Content 메커니즘을 사용하면 req.query.decode(_:)를 통해 쿼리 문자열을 구조체로 디코딩할 수 있어 filter/페이지 매김 매개변수에 적합합니다.

struct Page: Content {
    var page: Int?
    var size: Int?
}
app.get("items") { req -> String in
    let p = try req.query.decode(Page.self)
    return "page=" + String(p.page ?? 1)
}

콘텐츠와 함께 사용자 지정 상태 반환하기

본문과 상태를 모두 제어하려면 Response를 구성하고 그 안에 콘텐츠를 인코딩하거나 튜플과 유사한 구문을 반환하십시오. 아래 코드는 JSON 본문과 함께 201(생성됨)을 설정합니다.

app.post("todo") { req -> Response in
    let todo = try req.content.decode(Todo.self)
    let res = Response(status: .created)
    try res.content.encode(todo)
    return res
}

빠른 확인: 콘텐츠와 JSON

인코딩 지식을 확인해 보십시오.

복습: 콘텐츠와 JSON 인코딩

Vapor에서 데이터가 네트워크를 통해 전달되는 방법을 배웠습니다:

  • 모델이 Content(Codable 기반)를 준수하도록 합니다.
  • 콘텐츠를 반환해 JSON으로 인코딩하고, req.content.decode를 사용해 본문을 읽습니다.
  • CodingKeys와 ContentConfiguration을 통해 키와 날짜를 사용자 지정합니다.
  • Validatable로 입력을 검증하고 요청 및 응답 데이터 전송 객체를 분리하는 방안을 고려합니다.

자주 묻는 질문

“콘텐츠와 JSON 인코딩” 강의는 무료인가요?

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

“콘텐츠와 JSON 인코딩”에서 뭘 배우나요?

요청 및 응답 본문을 디코딩하고 인코딩합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“콘텐츠와 JSON 인코딩” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 라우팅과 요청 처리
  2. 콘텐츠와 JSON 인코딩
  3. Fluent ORM과 모델
  4. 미들웨어와 인증
← Swift Academy(으)로 돌아가기