譯者 | 劉汪洋TiH28資訊網——每日最新資訊28at.com

審校 | 重樓TiH28資訊網——每日最新資訊28at.com

Go 的標準庫中包含一個穩定且成熟的 HTTP 服務器。然而，內置的請求路由器http.ServeMux 功能較為簡潔，因此你常常需要自己編寫路由代碼。TiH28資訊網——每日最新資訊28at.com

TiH28資訊網——每日最新資訊28at.com

其主要短板是，它并未支持 HTTP 方法的匹配（如GET和POST的區別），同時也無法持/users/{user}/settings這種類型的通配符路徑。然而，這兩個功能幾乎是所有 REST 風格的 API 服務器所必需的。TiH28資訊網——每日最新資訊28at.com

當然，你可以選擇自行實現這些功能。在我以前的一篇文章 Go 中不同的 HTTP 路由方法中，提到過有一些優秀的第三方包可以實現更高級的路由功能，并且只需 約 30 行代碼 就能夠在不借助任何第三方庫的情況下實現類似的功能。TiH28資訊網——每日最新資訊28at.com

但是，未來可能不再需要這些替代方案和第三方包?，F在有一個 活躍的提案 - 還包括一個旨在改進 ServeMux 參考實現 ，使其能夠匹配 HTTP 方法和通配符路徑。TiH28資訊網——每日最新資訊28at.com

Google 的 Go 團隊成員 Jonathan Amsterdam 主導了這個提案以及之前的 討論。Jonathan 曾成功提出將結構化日志添加到標準庫的提案 - Go 1.21 將包含他的log/slog包（預計 2023 年 8 月發布）。TiH28資訊網——每日最新資訊28at.com

現狀與變革

在目前的情況下，如果想將 GET 請求匹配到 /users/{user}/settings，你需要編寫以下的樣板代碼（盡管在實踐中你可能會使用第三方庫）：TiH28資訊網——每日最新資訊28at.com

mux.HandleFunc("/users/", func(w http.ResponseWriter, r *http.Request) {    if r.Method != "GET" {        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)        return    }    remainder := r.URL.Path[len("/users/"):]    userId, subPath, _ := strings.Cut(remainder, "/")    switch subPath {    case "settings":        fmt.Fprintf(w, "user %s", userId)    // 其他子路徑可以在這里添加    default:        http.NotFound(w, r)    }})

如果接受了這個提議，你可以更加簡單地實現一樣的功能：TiH28資訊網——每日最新資訊28at.com

mux.HandleFunc("GET /users/{user}/settings", func(w http.ResponseWriter, r *http.Request) {    fmt.Fprintf(w, "user %s", r.PathValue("user"))})

這樣的寫法明顯更為簡潔！TiH28資訊網——每日最新資訊28at.com

這與其他流行路由器使用的語法非常相似：TiH28資訊網——每日最新資訊28at.com

// github.com/go-chi/chirouter.Get("/users/{user}/settings", func(w http.ResponseWriter, r *http.Request) {    fmt.Fprintf(w, "user %s", chi.URLParam(r, "slug"))})// github.com/gorilla/muxrouter.HandleFunc("/users/{user}/settings", func(w http.ResponseWriter, r *http.Request) {    fmt.Fprintf(w, "user %s", mux.Vars(r)["user"])}).Methods("GET")// github.com/bmizerany/patrouter.Get("/users/:user/settings", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {    fmt.Fprintf(w, "user %s", r.URL.Query().Get(":user"))}))// github.com/gin-gonic/ginrouter.GET("/users/:user/settings", func(c *gin.Context) {    fmt.Fprintf(w, "user %s", c.Param("user"))})

提案中的一個有趣決定是，并沒有為 ServeMux 添加新的方法；而是對現有的 Handle 和 HandleFunc 方法進行了擴展，以支持方法前綴和 {wildcard} 路徑段。TiH28資訊網——每日最新資訊28at.com

我理解他們避免添加新方法的想法，但我對這個決定持保留態度。遺憾的是，舊版的 ServeMux 接受如 Handle("GET /foo", h) 的模式。這意味著為增強版 ServeMux 編寫的代碼將在舊版 Go 上能正常編譯和運行，但路由不會匹配到任何內容，這容易導致錯誤。我可能會添加新的方法，比如 HandleMatch / HandleMatchFunc 或 Route / RouteFunc。TiH28資訊網——每日最新資訊28at.com

該提議也詳細描述了處理兩個重疊模式的優先級，其核心規則簡單明了：“如果兩個模式有重疊（有共同的請求），則更具體的模式優先匹配”。TiH28資訊網——每日最新資訊28at.com

例如，如果你注冊了模式 /users/（匹配 /users/*）以及模式 /users/{user}，當一個 /users/ben 的請求進來時，它將匹配第二個，更具體的模式。這與現有的 ServeMux 中，特定主機的模式優先于沒有主機名的模式的行為一致。TiH28資訊網——每日最新資訊28at.com

URL 末尾通配符匹配

此提案為我們帶來了一個新的"特殊通配符" {$}，它專門用于匹配 URL 的末尾。對于那些僅希望匹配主頁路由的情況，這個新特性顯得非常實用。在此之前，要實現這一目標頗為麻煩，因為以 / 結尾的模式會匹配所有 / 之下的內容；這個規則對于只有 / 的模式同樣適用。TiH28資訊網——每日最新資訊28at.com

因此，以前若想匹配主頁，你需要這樣操作：TiH28資訊網——每日最新資訊28at.com

mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {    if r.URL.Path != "/" { // 確保路徑就是 "/"        http.NotFound(w, r)        return    }    serveHomepage(w, r)})mux.HandleFunc("/users", serveUsers)

這一過程頗為繁瑣。若你忘記了路徑檢查，那么你最終可能會將主頁用于所有其他的 URL，而不是顯示一個未找到的頁面，因為所有的內容都在 / 之下。TiH28資訊網——每日最新資訊28at.com

而根據新的提案，這個過程將變得更加簡潔：TiH28資訊網——每日最新資訊28at.com

mux.HandleFunc("/{$}", serveHomepage)mux.HandleFunc("/users", serveUsers)

實現參考

Jonathan 在 github.com/jba/muxpatterns 中發布了一個 ServeMux 的增強版本的示例實現。唯一的區別在于，由于它是在單獨的包中，無法改變 http.Request 類型， 所以你需要用 mux.PathValue(request, "name") 來獲取路徑值，而非 request.PathValue("name")。TiH28資訊網——每日最新資訊28at.com

我在 我的 go-routing 倉庫 中添加了一個 PR，這個 PR 提供了我自己的 widget API 的一種實現，使用 muxpatterns。這個版本與 chi 版本 非常相似 —— 清晰且易讀：TiH28資訊網——每日最新資訊28at.com

r.HandleFunc("GET /{$}", home)r.HandleFunc("GET /contact", contact)r.HandleFunc("GET /api/widgets", apiGetWidgets)r.HandleFunc("POST /api/widgets", apiCreateWidget)r.HandleFunc("POST /api/widgets/{slug}", apiUpdateWidget)r.HandleFunc("POST /api/widgets/{slug}/parts", apiCreateWidgetPart)r.HandleFunc("POST /api/widgets/{slug}/parts/{id}/update", apiUpdateWidgetPart)r.HandleFunc("POST /api/widgets/{slug}/parts/{id}/delete", apiDeleteWidgetPart)r.HandleFunc("GET /{slug}", widgetGet)r.HandleFunc("GET /{slug}/admin", widgetAdmin)r.HandleFunc("POST /{slug}/image", widgetImage)

當我首次測試這個參考實現時，我發現了一些小問題，現已得到修復。TiH28資訊網——每日最新資訊28at.com

結論

盡管我對于擴展現有的 Handle 和 HandleFunc 方法有一些保留，但我對這個提案的考慮感到欣慰。鑒于 Jonathan 在提案中的謹慎處理、他在 log/slog 上的良好表現以及社區的積極反饋，此提案被接受的可能性很高。TiH28資訊網——每日最新資訊28at.com

如果這個功能能進入標準庫，那將非常棒 —— 我開發的幾乎所有網站和 REST 風格的 API 都將用到這個功能。Go 的標準庫已經非常強大，但加入這個功能將進一步減少對第三方路由器的依賴。TiH28資訊網——每日最新資訊28at.com

如果這個功能能夠集成在 2024 年 2 月發布的 Go 1.22 中，我并不會感到驚訝。讓我們拭目以待！TiH28資訊網——每日最新資訊28at.com

譯者介紹

劉汪洋，51CTO社區編輯，昵稱：明明如月，一個擁有 5 年開發經驗的某大廠高級 Java 工程師，擁有多個主流技術博客平臺博客專家稱號。TiH28資訊網——每日最新資訊28at.com

原文標題：The proposal to enhance Go’s HTTP router，作者：Ben HoytTiH28資訊網——每日最新資訊28at.com

本文鏈接：http://www.tebozhan.com/showinfo-26-5719-0.html提升Go的HTTP路由器的提案

聲明：本網頁內容旨在傳播知識，若有侵權等問題請及時與本網聯系，我們將在第一時間刪除處理。郵件：2376512515@qq.com

上一篇： SpringBoot使用WebSocket實現即時消息

下一篇： 穿上App外衣，保持Web靈魂——PWA溫故