go rest-api 리뷰

[robert-min]

gorilla/mux를 활용한 rest-api 개발

gorilla/mux 링크

• mux는 "HTTP 요청 멀티플래서"를 의미하며 해당 패키지를 통해 들어오는 요청을 해당 핸들러와 일치시키기위해 라우터 및 디스패처를 구현
• http.Handler표준과 호환되도록 인터페이스를 구현  http.ServeMux.
• 요청은 URL 호스트, 경로, 경로 접두사, 체계, 헤더 및 쿼리 값, HTTP 메서드 또는 사용자 지정 일치자를 사용하여 일치시킬 수 있음.
• URL 호스트, 경로 및 쿼리 값은 선택적 정규식을 사용하는 변수 제공
• 등록된 URL은 리소스에 대한 참조를 유지 관리하는 데 도움이 되는 reversed 기능 제공
• 경로는 서브라우터로 제공. 중첩된 경로는 상위 경로가 일치하는 경우에만 테스트됩니다. 이는 호스트, 경로 접두사 또는 기타 반복되는 속성과 같은 공통 조건을 공유하는 경로 그룹을 정의하는 데 유용합

# 패키지 설치
go get github.com/gorilla/mux

// api/app.go
package api

import (
    "fmt"
    "net/http"

    "github.com/gorilla/mux"
)

func getHello(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "say hello")
}

func MakeHandler() *mux.Router {
    mux := mux.NewRouter()
    mux.HandleFunc("/hello", getHello).Methods("GET")

    return mux
}

// main.go
package main

import (
    "net/http"
    "project-go/login-api/backend/src/api"
)

func main() {
    router := api.MakeHandler()
    http.ListenAndServe(":8080", router)
}

# 실행 후 GET http://localhost:8080/hello 요청 후 결과 확인
go run main.go

negroni를 활용한 코드 개선

• net/http와 같이 사용할 수 있는 HTTP 미드웨어
• negroni.Recovery - Panic 복구용 미들웨어
• negroni.Logger - Request/Response 로깅 미들웨어
• negroni.Static - "public" 디렉터리 아래의 정적 파일 제공(serving)을 위한 미들웨어

// 설치
go get github.com/urfave/negroni

// api/app.go
package api

import (
    "fmt"
    "net/http"

    "github.com/gorilla/mux"
    "github.com/urfave/negroni"
)

type AppHandler struct {
    http.Handler
}

func (a *AppHandler) getHello(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "say hello")
}

func MakeHandler() *AppHandler {
    mux := mux.NewRouter()
    n := negroni.New(
        negroni.NewLogger(),    // Request/Response 로깅 미들웨어
        negroni.NewRecovery(),  // panic 복구용 미들웨어
    )
    n.UseHandler(mux)

    a := &AppHandler{
        Handler: n,
    }

    mux.HandleFunc("/hello", a.getHello).Methods("GET")

    return a
}

// main.go
package main

import (
    "net/http"
    "project-go/login-api/backend/src/api"
)

func main() {
    m := api.MakeHandler()
    http.ListenAndServe(":8080", m)
}