HTTP 서버 만들기
ListenAndServe, HandlerFunc 및 ServeMux
HTTP 서버 만들기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
net/http 패키지
Go의 표준 라이브러리 net/http는 외부 의존성 없이 운영 환경에 사용할 수 있는 HTTP/1.1 및 HTTP/2 서버를 제공합니다.
기본 서버
http.HandleFunc으로 핸들러를 등록하고 http.ListenAndServe로 수신을 시작합니다:
http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello, World!")
})
log.Fatal(http.ListenAndServe(":8080", nil))http.Handler 인터페이스
ServeHTTP(ResponseWriter, *Request)를 구현하는 모든 타입은 http.Handler입니다. 데이터베이스나 구성을 포함하는 상태 저장 핸들러에 사용하십시오.
type App struct{ db *sql.DB }
func (a *App) ServeHTTP(w http.ResponseWriter, r *http.Request) {
// use a.db
}ServeMux
http.NewServeMux()는 독립적인 라우터를 만듭니다. 전역 기본 멀티플렉서를 피하려면 이를 http.ListenAndServe에 전달하십시오(라이브러리에서 더 안전합니다).
mux := http.NewServeMux()
mux.HandleFunc("/api/users", usersHandler)
http.ListenAndServe(":8080", mux)상태 코드로 응답하기
본문을 작성하기 전에 w.WriteHeader(code)로 상태 코드를 작성하십시오. w.Write만 호출하면 상태 코드는 기본적으로 200이 됩니다.
w.WriteHeader(http.StatusCreated)
w.Write([]byte("created"))JSON 응답 작성
본문을 작성하기 전에 Content-Type을 설정한 다음 json.Encoder로 인코딩합니다:
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(data)요청 읽기
*Request 구조체를 통해 메서드, URL, 헤더, 쿼리 매개변수 및 본문에 접근할 수 있습니다.
r.Method // "GET", "POST", ...
r.URL.Path // "/api/users"
r.URL.Query().Get("id") // query param
r.Header.Get("Authorization")JSON 요청 본문 파싱
json.Decoder로 요청 본문을 디코딩하십시오. 메모리 고갈을 방지하려면 http.MaxBytesReader로 본문 크기를 제한하십시오.
r.Body = http.MaxBytesReader(w, r.Body, 1<<20)
var req CreateUserRequest
json.NewDecoder(r.Body).Decode(&req)서버 구성
느린 클라이언트 공격을 방지하려면 사용자 지정 http.Server로 시간 제한을 구성하십시오:
srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 120 * time.Second,
}
srv.ListenAndServe()HTTPS
srv.ListenAndServeTLS(certFile, keyFile)을 사용해 HTTPS를 제공합니다. 인증서는 자체 서명 인증서(개발 환경)일 수도 있고, Let's Encrypt에서 발급한 인증서( golang.org/x/crypto/acme/autocert를 사용하는 운영 환경)일 수도 있습니다.
핸들러 조합
핸들러를 감싸면 업무 로직을 수정하지 않고 공통 관심사(로깅, 인증, 복구)를 추가할 수 있습니다. 수정한 다음 핸들러를 반환하십시오.
빠른 확인
http.Server에 ReadTimeout과 WriteTimeout을 설정해야 하는 이유는 무엇인가요?
복습: HTTP 서버 만들기
핵심 내용:
- 간단한 서버에는 HandleFunc + ListenAndServe 사용
- 운영 환경에서는 시간 제한이 있는 사용자 지정 http.Server 사용
- 독립적인 라우팅에는 ServeMux 사용
- JSON 응답에는 json.NewEncoder(w) 사용
자주 묻는 질문
“HTTP 서버 만들기” 강의는 무료인가요?
네 — “HTTP 서버 만들기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“HTTP 서버 만들기”에서 뭘 배우나요?
ListenAndServe, HandlerFunc 및 ServeMux 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“HTTP 서버 만들기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- HTTP 서버 만들기
- 라우팅과 경로 매개변수
- 미들웨어 패턴
- 우아한 종료