요청 바인딩과 검증
ShouldBindJSON, 바인딩 태그 및 validator
요청 바인딩과 검증은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
요청 본문 바인딩
Gin은 binding 구조체 태그와 c.ShouldBind* 함수를 사용하여 JSON, XML, 폼 데이터 및 쿼리 문자열을 Go 구조체에 바인딩할 수 있습니다:
type CreateUserRequest struct {
Name string `json:"name" binding:"required"`
Email string `json:"email" binding:"required,email"`
Age int `json:"age" binding:"gte=0,lte=150"`
}
func createUser(c *gin.Context) {
var req CreateUserRequest
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
}ShouldBind와 MustBind 비교
ShouldBind*는 오류를 반환하므로 직접 처리할 수 있습니다. Bind*(Must 변형)는 오류가 발생하면 400 응답을 자동으로 작성하고 중단합니다. 사용자 지정 오류 응답에는 ShouldBind를 사용하십시오.
쿼리 바인딩
c.ShouldBindQuery로 쿼리 문자열 매개변수를 구조체에 바인딩합니다:
type ListRequest struct {
Page int `form:"page" binding:"gte=1"`
Limit int `form:"limit" binding:"gte=1,lte=100"`
}
var q ListRequest
c.ShouldBindQuery(&q)경로 매개변수 바인딩
c.ShouldBindUri로 경로 매개변수를 구조체에 바인딩합니다:
type IDParam struct {
ID int64 `uri:"id" binding:"required,gt=0"`
}
var p IDParam
c.ShouldBindUri(&p)유효성 검사 태그
Gin은 github.com/go-playground/validator/v10을 사용합니다. 일반적인 태그는 required, email, min, max, gte, lte, len, oneof입니다.
사용자 지정 유효성 검사기
binding.Validator.Engine()으로 사용자 지정 유효성 검사 함수를 등록합니다:
validate := binding.Validator.Engine().(*validator.Validate)
validate.RegisterValidation("username", validateUsername)유효성 검사 오류 응답
필드 이름과 메시지를 포함하는 사용자 친화적인 응답으로 검사기 오류를 변환합니다:
var ve validator.ValidationErrors
if errors.As(err, &ve) {
errs := make([]string, len(ve))
for i, e := range ve {
errs[i] = fmt.Sprintf("%s: %s", e.Field(), e.Tag())
}
c.JSON(400, gin.H{"errors": errs})
}멀티파트 폼 파일
c.FormFile로 파일 업로드를 처리합니다:
file, _ := c.FormFile("avatar")
c.SaveUploadedFile(file, "./uploads/"+file.Filename)Content-Type 협상
Gin의 ShouldBind는 Content-Type에 따라 바인딩을 자동으로 선택합니다(application/json에는 JSON, application/x-www-form-urlencoded에는 폼).
요청 본문 최대 크기
메모리 고갈을 방지하려면 요청 본문 크기를 제한합니다:
r.MaxMultipartMemory = 8 << 20 // 8 MiB for multipart중첩 구조체 유효성 검사
유효성 검사는 중첩된 구조체에 재귀적으로 적용됩니다. 슬라이스 요소를 검사하려면 dive를 사용합니다:
Tags []string `json:"tags" binding:"required,dive,min=1,max=30"`빠른 확인
Gin에서 c.ShouldBindJSON과 c.BindJSON의 차이점은 무엇입니까?
요약: 요청 바인딩
핵심 내용:
- 형식이 지정된 바인딩에는 ShouldBindJSON/ShouldBindQuery/ShouldBindUri를 사용합니다
- go-playground/validator를 통한 binding:"required,email,gte=0" 태그
- binding.Validator.Engine()을 통한 사용자 지정 유효성 검사기
- 필드 수준 오류 메시지를 위해 ValidationErrors를 변환합니다
자주 묻는 질문
“요청 바인딩과 검증” 강의는 무료인가요?
네 — “요청 바인딩과 검증” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“요청 바인딩과 검증”에서 뭘 배우나요?
ShouldBindJSON, 바인딩 태그 및 validator 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“요청 바인딩과 검증” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.