如何组织 gorilla mux 路线？

Question

我正在使用 Gorilla Mux 编写 REST API，但我在组织路由时遇到了麻烦，目前我的所有路由都在 main.go 文件中定义，如下所示

//main.go
package main

import (
    "NovAPI/routes"
    "fmt"
    "github.com/gorilla/mux"
    "net/http"
)

func main() {

    router := mux.NewRouter().StrictSlash(true)

    router.HandleFunc("/hello", func(res http.ResponseWriter, req *http.Request) {
        fmt.Fprintln(res, "Hello")
    })

    router.HandleFunc("/user", func(res http.ResponseWriter, req *http.Request) {
        fmt.Fprintln(res, "User")
    })

    router.HandleFunc("/route2", func(res http.ResponseWriter, req *http.Request) {
        fmt.Fprintln(res, "Route2")
    })

    router.HandleFunc("/route3", func(res http.ResponseWriter, req *http.Request) {
        fmt.Fprintln(res, "Route3")
    })

    // route declarations continue like this

    http.ListenAndServe(":1128", router)

}

所以我想要做的是取出这个路由声明并将其拆分为多个文件，我将如何去做呢？ 提前致谢。

Answer 1

这样的事情怎么样？

//main.go
package main

import (
    "NovAPI/routes"
    "fmt"
    "github.com/gorilla/mux"
    "net/http"
)

func main() {

    router := mux.NewRouter().StrictSlash(true)

    router.HandleFunc("/hello", HelloHandler)
    router.HandleFunc("/user", UserHandler)
    router.HandleFunc("/route2", Route2Handler)
    router.HandleFunc("/route3", Route3Handler)
    // route declarations continue like this

    http.ListenAndServe(":1128", router)

}

func HelloHandler(res http.ResponseWriter, req *http.Request) {
    fmt.Fprintln(res, "Hello")
}

func UserHandler(res http.ResponseWriter, req *http.Request) {
    fmt.Fprintln(res, "User")
}

func Route2Handler(res http.ResponseWriter, req *http.Request) {
    fmt.Fprintln(res, "Route2")
}

func Route3Handler(res http.ResponseWriter, req *http.Request) {
    fmt.Fprintln(res, "Route3")
}

这样您就可以将处理程序放在其他文件中，甚至是其他包中。

如果你最终得到了像数据库这样的额外依赖项，你甚至可以使用构造函数技巧来避免对全局变量的需要：

//main.go

func main() {
    db := sql.Open(…)

    //...

    router.HandleFunc("/hello", NewHelloHandler(db))

    //...
}

func NewHelloHandler(db *sql.DB) func(http.ResponseWriter, *http.Request) {
    return func(res http.ResponseWriter, req *http.Request) {
        // db is in the local scope, and you can even inject it to test your
        // handler
        fmt.Fprintln(res, "Hello")
    }
}

Answer 2

我喜欢查看 github 中的其他项目以获取有关如何做事的想法，对于这些情况，我通常先查看Docker repo。他们就是这样做的：

对于system 的路由，在system_routes.go 中定义所有处理程序，然后在system.go 中的NewRouter 函数上初始化这些路由。

type systemRouter struct {
    backend Backend
    routes  []router.Route
}

func NewRouter(b Backend) router.Router {
    r := &systemRouter{
        backend: b,
    }

    r.routes = []router.Route{
        local.NewOptionsRoute("/", optionsHandler),
        local.NewGetRoute("/_ping", pingHandler),
        local.NewGetRoute("/events", r.getEvents),
        local.NewGetRoute("/info", r.getInfo),
        local.NewGetRoute("/version", r.getVersion),
        local.NewPostRoute("/auth", r.postAuth),
    }

    return r
}

// Routes return all the API routes dedicated to the docker system.
func (s *systemRouter) Routes() []router.Route {
    return s.routes
}

注意systemRouter实现了router.Router接口，Routes函数返回一个[]router.Route，它们的handler定义为

func(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error

代替 Go 的标准 http 处理程序：

func(w http.ResponseWriter, r *http.Request)

所以他们的额外代码可以在makeHttpHandler 函数中将 Docker API 处理程序转换为 Go HTTP 处理程序。

最后，为了将这些路由添加到他们的多路复用路由器，在他们的 server.go 上，他们实现了几个其他函数到 add middleware 到他们的处理程序。

如果您认为这是您正在寻找的东西，那么请花点时间分析 Docker 代码中的路线，如果您需要我详细说明或者如果我遗漏了任何内容，请发表评论。

Answer 3

您可以将您的路由器独立模块化成不同的包，并将它们安装在主路由器上

在下面的issue 上稍微详细说明一下，您可以提出这种方法，这使得它非常可扩展（并且在某种程度上更容易测试）

/api/router.go

package api

import (
    "net/http"

    "github.com/gorilla/mux"
)

func Router() *mux.Router {
    router := mux.NewRouter()
    router.HandleFunc("/", home)
    return router
}

func home(w http.ResponseWriter, req *http.Request) {
    w.Write([]byte("hello from API"))
}

/main.go

package main

import (
    "log"
    "net/http"
    "strings"

    "github.com/...yourPath.../api"
    "github.com/...yourPath.../user"
    "github.com/gorilla/mux"
)

func main() {
    router := mux.NewRouter()

    router.HandleFunc("/", home)
    mount(router, "/api", api.Router())
    mount(router, "/user", user.Router())

    log.Fatal(http.ListenAndServe(":8080", router))
}

func mount(r *mux.Router, path string, handler http.Handler) {
    r.PathPrefix(path).Handler(
        http.StripPrefix(
            strings.TrimSuffix(path, "/"),
            handler,
        ),
    )
}

func home(w http.ResponseWriter, req *http.Request) {
    w.Write([]byte("Home"))
}