간단한 것부터 복잡한 것까지 Golang에서 웹 서버 개발

XNUMX년 전에 나는 시작했다 고피시를 개발하다, Golang 학습을 가능하게 했습니다. 나는 Go가 많은 라이브러리에 의해 보완되는 강력한 언어라는 것을 깨달았습니다. Go는 다재다능합니다. 특히 서버 측 애플리케이션을 쉽게 개발할 수 있습니다.

이 문서는 Go로 서버를 작성하는 방법에 관한 것입니다. "Hello world!"와 같은 간단한 것부터 시작하여 다음 기능을 갖춘 애플리케이션으로 마무리해 보겠습니다.

- HTTPS에 대해 Let's Encrypt를 사용합니다.
- API 라우터로 작동합니다.
— 미들웨어 작업.
- 정적 파일을 처리합니다.
- 올바른 종료.

Skillbox는 다음을 권장합니다. 실기 코스 "처음부터 Python 개발자".

알림: "Habr"의 모든 독자를 위한 - "Habr" 프로모션 코드를 사용하여 Skillbox 과정에 등록할 때 10 루블 할인.

안녕, 세상!

Go에서 웹 서버를 만드는 것은 매우 빠를 수 있습니다. 다음은 위에서 약속한 "Hello, world!"를 반환하는 핸들러를 사용하는 예입니다.

package main
 
import (
"fmt"
"net/http"
)
 
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello World!")
})
http.ListenAndServe(":80", nil)
}

그 후 어플리케이션을 실행하고 페이지를 열면 로컬 호스트, 그러면 "Hello, world!"라는 텍스트가 즉시 표시됩니다. (물론 모든 것이 올바르게 작동하는 경우).

우리는 다음에서 핸들러를 반복적으로 사용할 것이지만 먼저 모든 것이 어떻게 작동하는지 이해합시다.

넷/http

패키지를 사용한 예 net/http는 서버와 HTTP 클라이언트를 모두 개발하기 위한 Go의 기본 도구입니다. 코드를 이해하기 위해 http.Handler, http.ServeMux 및 http.Server의 세 가지 중요한 요소의 의미를 이해합시다.

HTTP 핸들러

요청을 받으면 핸들러가 이를 구문 분석하고 응답을 생성합니다. Go의 핸들러는 다음과 같이 구현됩니다.

type Handler interface {
        ServeHTTP(ResponseWriter, *Request)
}

첫 번째 예에서는 http.HandleFunc 도우미 함수를 사용합니다. 이는 ServeHTTP에서 http.ResponseWriter 및 http.Request를 차례로 수락하는 또 다른 함수를 래핑합니다.

즉, Golang의 핸들러는 프로그래머에게 많은 기회를 제공하는 단일 인터페이스로 표현됩니다. 예를 들어 미들웨어는 처리기를 사용하여 구현되며 여기서 ServeHTTP는 먼저 작업을 수행한 다음 다른 처리기의 ServeHTTP 메서드를 호출합니다.

위에서 언급했듯이 핸들러는 단순히 요청에 대한 응답을 구성합니다. 그러나 특정 시간에 어떤 핸들러를 사용해야 합니까?

라우팅 요청

올바른 선택을 하려면 HTTP 멀티플렉서를 사용하십시오. 여러 라이브러리에서 muxer 또는 라우터라고 하지만 모두 동일합니다. 멀티플렉서의 기능은 요청 경로를 분석하고 적절한 핸들러를 선택하는 것입니다.

복잡한 라우팅에 대한 지원이 필요한 경우 타사 라이브러리를 사용하는 것이 좋습니다. 가장 진보 된 것 중 하나 고릴라/먹스 и 고치/치, 이러한 라이브러리를 사용하면 문제 없이 중간 처리를 구현할 수 있습니다. 이들의 도움으로 와일드카드 라우팅을 설정하고 기타 여러 작업을 수행할 수 있습니다. 이들의 장점은 표준 HTTP 처리기와의 호환성입니다. 결과적으로 나중에 수정할 수 있는 간단한 코드를 작성할 수 있습니다.

일반적인 상황에서 복잡한 프레임워크로 작업하려면 표준 솔루션이 필요하지 않으며 이는 기본 처리기 사용을 크게 복잡하게 만듭니다. 기본 라이브러리와 간단한 라우터의 조합으로 대부분의 응용 프로그램을 만들 수 있습니다.

쿼리 처리

또한 들어오는 연결을 "수신"하고 모든 요청을 올바른 처리기로 리디렉션하는 구성 요소가 필요합니다. http.Server는 이 작업에 쉽게 대처할 수 있습니다.

다음은 서버가 연결 처리와 관련된 모든 작업을 담당함을 보여줍니다. 예를 들어 이것은 TLS 프로토콜에서 작동합니다. 표준 HTTP 서버는 http.ListenAndServer 호출을 구현하는 데 사용됩니다.

이제 좀 더 복잡한 예를 살펴보겠습니다.

Let's Encrypt 추가

기본적으로 애플리케이션은 HTTP 프로토콜을 통해 실행되지만 HTTPS 프로토콜을 사용하는 것이 좋습니다. Go에서는 문제 없이 수행할 수 있습니다. 인증서와 개인 키를 받았다면 올바른 인증서와 키 파일로 ListenAndServeTLS를 작성하면 됩니다.

http.ListenAndServeTLS(":443", "cert.pem", "key.pem", nil)

당신은 항상 더 잘할 수 있습니다.

암호화하자. 자동 갱신 가능성이 있는 무료 인증서를 제공합니다. 서비스를 이용하기 위해서는 패키지가 필요합니다. autocert.

설정하는 가장 쉬운 방법은 http.Serve와 함께 autocert.NewListener 메서드를 사용하는 것입니다. 이 방법을 사용하면 HTTP 서버가 요청을 처리하는 동안 TLS 인증서를 수신하고 갱신할 수 있습니다.

http.Serve(autocert.NewListener("example.com"), nil)

브라우저에서 열면 example.com, HTTPS 응답 "Hello, world!"를 얻습니다.

더 자세한 구성이 필요한 경우 autocert.Manager를 사용해야 합니다. 그런 다음 자체 http.Server 인스턴스를 만들고(지금까지 기본적으로 사용함) 관리자를 TLSConfig 서버에 추가합니다.

m := &autocert.Manager{
Cache:      autocert.DirCache("golang-autocert"),
Prompt:     autocert.AcceptTOS,
HostPolicy: autocert.HostWhitelist("example.org", "www.example.org"),
}
server := &http.Server{
    Addr:      ":443",
    TLSConfig: m.TLSConfig(),
}
server.ListenAndServeTLS("", "")

이것은 자동 인증서 갱신으로 완전한 HTTPS 지원을 구현하는 쉬운 방법입니다.

사용자 지정 경로 추가

표준 라이브러리에 포함된 기본 라우터는 훌륭하지만 매우 기본적입니다. 대부분의 애플리케이션에는 중첩 및 와일드카드 경로 또는 경로 패턴 및 매개변수 설정 절차를 포함하여 더 복잡한 라우팅이 필요합니다.

이 경우 패키지를 사용해야 합니다. 고릴라/먹스 и 고치/치. 후자로 작업하는 방법을 배웁니다. 예가 아래에 나와 있습니다.

API에 대한 경로가 포함된 api/v1/api.go 파일이 제공됩니다.

/ HelloResponse is the JSON representation for a customized message
type HelloResponse struct {
Message string `json:"message"`
}
 
// HelloName returns a personalized JSON message
func HelloName(w http.ResponseWriter, r *http.Request) {
name := chi.URLParam(r, "name")
response := HelloResponse{
Message: fmt.Sprintf("Hello %s!", name),
}
jsonResponse(w, response, http.StatusOK)
}
 
// NewRouter returns an HTTP handler that implements the routes for the API
func NewRouter() http.Handler {
r := chi.NewRouter()
r.Get("/{name}", HelloName)
return r
}

기본 파일의 경로에 대해 api/vq 접두사를 설정합니다.

그런 다음 이를 기본 애플리케이션의 api/v1/ 접두사 아래에 있는 기본 라우터에 마운트할 수 있습니다.

// NewRouter returns a new HTTP handler that implements the main server routes
func NewRouter() http.Handler {
router := chi.NewRouter()
    router.Mount("/api/v1/", v1.NewRouter())
    return router
}
http.Serve(autocert.NewListener("example.com"), NewRouter())

Go에서 복잡한 경로로 쉽게 작업할 수 있으므로 크고 복잡한 애플리케이션의 구조화 및 유지 관리를 단순화할 수 있습니다.

미들웨어 작업

중간 처리의 경우 하나의 HTTP 핸들러를 다른 HTTP 핸들러로 래핑하여 인증, 압축, 로깅 및 기타 기능을 빠르게 수행할 수 있습니다.

예를 들어 http.Handler 인터페이스를 고려하여 서비스 사용자를 인증하는 핸들러를 작성해 보겠습니다.

func RequireAuthentication(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if !isAuthenticated(r) {
            http.Redirect(w, r, "/login", http.StatusTemporaryRedirect)
            return
        }
        // Assuming authentication passed, run the original handler
        next.ServeHTTP(w, r)
    })
}

미들웨어 기능을 확장할 수 있는 chi와 같은 타사 라우터가 있습니다.

정적 파일 작업

Go의 표준 라이브러리에는 JavaScript 및 CSS 파일뿐만 아니라 이미지를 포함한 정적 콘텐츠 작업을 위한 기능이 포함되어 있습니다. http.FileServer 기능을 통해 액세스할 수 있습니다. 특정 디렉터리에서 파일을 배포하는 처리기를 반환합니다.

func NewRouter() http.Handler {
    router := chi.NewRouter()
    r.Get("/{name}", HelloName)
 
// Настройка раздачи статических файлов
staticPath, _ := filepath.Abs("../../static/")
fs := http.FileServer(http.Dir(staticPath))
    router.Handle("/*", fs)
    
    return r

기본 index.html 파일이 포함되어 있지 않은 경우 http.Dir은 디렉토리의 내용을 표시한다는 점을 기억하십시오. 이 경우 디렉토리가 손상되는 것을 방지하기 위해 패키지를 사용해야 합니다. unindexed.

올바른 종료

Go에는 HTTP 서버의 정상적인 종료와 같은 기능도 있습니다. Shutdown() 메서드를 사용하여 이 작업을 수행할 수 있습니다. 서버는 goroutine에서 시작된 다음 인터럽트 신호를 수신하기 위해 채널을 청취합니다. 신호를 수신하자마자 서버가 꺼지지만 즉시는 아니지만 몇 초 후에 꺼집니다.

handler := server.NewRouter()
srv := &http.Server{
    Handler: handler,
}
 
go func() {
srv.Serve(autocert.NewListener(domains...))
}()
 
// Wait for an interrupt
c := make(chan os.Signal, 1)
signal.Notify(c, os.Interrupt)
<-c
 
// Attempt a graceful shutdown
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
srv.Shutdown(ctx)

결론으로서

Go는 거의 보편적인 표준 라이브러리를 갖춘 강력한 언어입니다. 기본 기능은 매우 광범위하며 인터페이스의 도움으로 강화할 수 있습니다. 이를 통해 진정으로 신뢰할 수 있는 HTTP 서버를 개발할 수 있습니다.

Skillbox는 다음을 권장합니다.

• XNUMX년 실습 코스 "저는 PRO 웹 개발자입니다".
• 교육용 온라인 과정 "직업 자바 개발자".
• 실기 코스 "0에서 PRO로의 PHP 개발자".

출처 : habr.com