콘텐츠와 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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 라우팅과 요청 처리
- 콘텐츠와 JSON 인코딩
- Fluent ORM과 모델
- 미들웨어와 인증