0Pricing
Go Academy · 강의

응답 도우미와 상태 코드

c.JSON, c.AbortWithError 및 오류 응답

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

c.JSON

c.JSON(statusCode, obj)는 obj를 JSON으로 직렬화하고 Content-Type을 application/json으로 설정합니다. 가장 일반적으로 사용하는 응답 메서드입니다.

c.JSON(http.StatusOK, gin.H{
    "id":   user.ID,
    "name": user.Name,
})

gin.H

gin.H는 map[string]any의 간단한 표기입니다. 구조체를 정의하지 않고 즉석에서 JSON 객체를 만들 때 사용합니다.

c.JSON(200, gin.H{"message": "created", "id": id})

HTTP 상태 상수

명확성을 위해 원시 숫자 대신 http.Status* 상수를 사용합니다:

c.JSON(http.StatusCreated, gin.H{"id": id})
c.JSON(http.StatusBadRequest, gin.H{"error": "invalid input"})
c.JSON(http.StatusInternalServerError, gin.H{"error": "internal error"})

c.String와 c.Data

c.String로 일반 텍스트를 보내거나 c.Data로 임의의 바이트를 보냅니다:

c.String(200, "Hello, %s!", name)
c.Data(200, "application/octet-stream", fileBytes)

c.File과 c.FileAttachment

디스크의 파일을 인라인으로 제공하거나 다운로드로 제공합니다:

c.File("./public/report.pdf")           // inline
c.FileAttachment("./report.pdf", "report.pdf") // download

c.Redirect

HTTP 리디렉션을 보냅니다(301 영구, 302 임시):

c.Redirect(http.StatusMovedPermanently, "/new-url")

c.AbortWithStatus

요청 처리 체인을 중지하고 지정된 상태 코드와 함께 빈 응답을 작성합니다. c.JSON과 달리 Abort를 호출하여 이후 처리기가 실행되지 않도록 합니다.

c.AbortWithStatus(http.StatusUnauthorized)

c.Error

응답을 작성하지 않고 Context에 오류를 연결합니다. 미들웨어가 이러한 오류를 모아 마지막에 통합된 오류 응답을 작성할 수 있습니다.

c.Error(fmt.Errorf("database error: %w", err))

응답 헤더

c.JSON 또는 c.Data를 호출하기 전에 사용자 지정 응답 헤더를 설정합니다:

c.Header("X-Request-ID", requestID)
c.Header("Cache-Control", "max-age=3600")

XML 렌더링

Gin은 XML 및 YAML 응답도 지원합니다:

c.XML(200, user) // requires xml struct tags
c.YAML(200, user)

사용자 지정 응답 구조체

모든 엔드포인트에서 일관된 형식을 유지하도록 표준 API 응답 래퍼를 정의합니다:

type APIResponse struct {
    Success bool   `json:"success"`
    Data    any    `json:"data,omitempty"`
    Error   string `json:"error,omitempty"`
}

빠른 확인

c.AbortWithStatus는 c.Status와 어떻게 다르게 동작합니까?

요약: 응답 도우미

핵심 내용:

  • c.JSON(statusCode, obj)는 기본 JSON 응답 메서드입니다
  • 명확성을 위해 http.Status* 상수를 사용합니다
  • c.AbortWithStatus는 처리기 체인을 중지합니다
  • 모든 엔드포인트에 일관된 APIResponse 래퍼를 정의합니다

자주 묻는 질문

“응답 도우미와 상태 코드” 강의는 무료인가요?

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

“응답 도우미와 상태 코드”에서 뭘 배우나요?

c.JSON, c.AbortWithError 및 오류 응답 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“응답 도우미와 상태 코드” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. Gin 라우터와 라우트 그룹
  2. 요청 바인딩과 검증
  3. 응답 도우미와 상태 코드
  4. Gin 미들웨어: 인증과 로깅
← Go Academy(으)로 돌아가기