Go Web 编程入门：路由

2022 年 5 月 12 日
本文字数：1606 字
阅读完需：约 5 分钟

引言

Go 的 net/http 包为 HTTP 协议提供了很多功能。它做得不好的一件事是复杂的请求路由，例如将请求 url 分割成单个参数。

幸运的是，有一个非常流行的包，它在 Go 社区中以良好的代码质量而闻名。在此示例中，您将看到如何使用 gorilla/mux 包创建具有命名参数、GET/POST 处理程序和域限制的路由。

安装 gorilla/mux 包

gorilla/mux 是一个适配 Go 的默认 HTTP 路由器的包。它具有许多功能，可在编写 Web 应用程序时提高生产力。它还符合 Go 的默认请求处理程序签名 func (w http.ResponseWriter, r *http.Request)，因此该包可以与其他 HTTP 库（如中间件或现有应用程序）混合和加工。使用 go get 命令从 GitHub 安装包，如下所示：

go get -u github.com/gorilla/mux

复制代码

创建新路由

首先创建一个新的请求路由器。路由器是您的 Web 应用程序的主路由器，稍后将作为参数传递给服务器。它将接收所有 HTTP 连接并将其传递给您将在其上注册的请求处理程序。您可以像这样创建一个新路由器：

r := mux.NewRouter()

复制代码

注册请求处理程序

一旦你有了一个新的路由器，你就可以像往常一样注册请求处理程序。唯一的区别是，不是调用 http.HandleFunc(...)，而是在路由器上调用 HandleFunc，如下所示：r.HandleFunc(...)。

URL 参数

gorilla/mux 路由器的最大优势是能够从请求 URL 中提取段。例如，这是您的应用程序中的 URL：

/books/go-programming-blueprint/page/10

复制代码

此 URL 有两个动态段：

书名 slug (go-programming-blueprint)
页 (10)

要让请求处理程序与上面提到的 URL 匹配，您可以使用 URL 模式中的占位符替换动态段，如下所示：

r.HandleFunc("/books/{title}/page/{page}", func(w http.ResponseWriter, r *http.Request) {    // get the book    // navigate to the page})

复制代码

最后一件事是从这些段中获取数据。该包附带函数 mux.Vars(r)，它以 http.Request 作为参数并返回段的映射。

func(w http.ResponseWriter, r *http.Request) {    vars := mux.Vars(r)    vars["title"] // the book title slug    vars["page"] // the page}

复制代码

设置 HTTP 服务器的路由器

有没有想过 http.ListenAndServe(":80", nil) 中的 nil 是什么？它是 HTTP 服务器的主路由器的参数。默认为 nil，表示使用 net/http 包的默认路由器。要使用您自己的路由器，请将 nil 替换为您的路由器 r 的变量。

http.ListenAndServe(":80", r)

复制代码

代码（用于复制/粘贴）

这是完整的代码，您可以使用它来尝试在此示例中学到的东西。

package main
import (    "fmt"    "net/http"
    "github.com/gorilla/mux")
func main() {    r := mux.NewRouter()
    r.HandleFunc("/books/{title}/page/{page}", func(w http.ResponseWriter, r *http.Request) {        vars := mux.Vars(r)        title := vars["title"]        page := vars["page"]
        fmt.Fprintf(w, "You've requested the book: %s on page %s\n", title, page)    })
    http.ListenAndServe(":80", r)}

复制代码

总结

gorilla/mux 路由器的特点。

‎将请求处理程序限制为特定的 HTTP 方法。

r.HandleFunc("/books/{title}", CreateBook).Methods("POST")r.HandleFunc("/books/{title}", ReadBook).Methods("GET")r.HandleFunc("/books/{title}", UpdateBook).Methods("PUT")r.HandleFunc("/books/{title}", DeleteBook).Methods("DELETE")

复制代码

主机名和子域

将请求处理程序限制为特定的主机名或子域。

r.HandleFunc("/books/{title}", BookHandler).Host("www.mybookstore.com")

复制代码

Schemes

将请求处理程序限制为 http/https。

r.HandleFunc("/secure", SecureHandler).Schemes("https")r.HandleFunc("/insecure", InsecureHandler).Schemes("http")

复制代码

路径前缀和子路由器

将请求处理程序限制为特定的路径前缀。‎

bookrouter := r.PathPrefix("/books").Subrouter()bookrouter.HandleFunc("/", AllBooks)bookrouter.HandleFunc("/{title}", GetBook)

复制代码

发布于: 刚刚阅读数: 2

原文链接:【http://xie.infoq.cn/article/9f85c1d0d30d967eb74f02cd6】。

宇宙之一粟

关注

宇宙古今无有穷期，一生不过须臾，当思奋争 2020.05.07 加入

🏆InfoQ写作平台-第二季签约作者 🏆 混迹于江湖，江湖却没有我的影子热爱技术，专注于后端全栈，轻易不换岗拒绝内卷，工作于软件工程师，弹性不加班热衷分享，执着于阅读写作，佛系不水文

发布

暂无评论

创作场景

Go Web 编程入门：路由

引言

设置 HTTP 服务器的路由器

总结

宇宙之一粟

评论