gorilla/mux 是 Go 语言中一个非常流行和强大的 HTTP 路由和多路复用器（router/mux）库。它的功能比 Go 标准库中的 http.ServeMux 更加强大，提供了很多有用的功能，如路径变量、正则匹配、路由优先级、路由组、请求限制等，适合构建中大型 Web 应用。
首先，安装 gorilla/mux 包：
Life is like a journey
go get -u github.com/gorilla/mux
在 Go 的标准库中，你可以使用 http.ServeMux 来路由请求，但 gorilla/mux 提供了更高级的功能，尤其是在路由选择和请求处理方面。
创建一个基本的路由器并绑定请求路径与处理函数：
package main
import (
"fmt"
"github.com/gorilla/mux"
"net/http"
)
func HomeHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Welcome to the Home Page!")
}
func AboutHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "This is the About Page!")
}
func main() {
r := mux.NewRouter()
r.HandleFunc("/", HomeHandler)
r.HandleFunc("/about", AboutHandler)
http.ListenAndServe(":8080", r)
}
mux.NewRouter() 创建一个新的路由器。r.HandleFunc("/", HomeHandler) 将 URL 路径 / 绑定到 HomeHandler 处理函数。http.ListenAndServe(":8080", r) 启动一个 HTTP 服务器，监听端口 8080。在这个例子中，我们创建了两个路由，一个指向主页（/），另一个指向关于页面（/about）。
gorilla/mux 允许你在路由路径中使用动态参数。你可以使用花括号 {} 来定义路径变量。
例如，假设你想要一个路径能够匹配用户 ID，并返回该用户的信息：
package main
import (
"fmt"
"github.com/gorilla/mux"
"net/http"
)
func UserHandler(w http.ResponseWriter, r *http.Request) {
// 从 URL 中提取变量（例如：/user/123）
vars := mux.Vars(r)
userID := vars["id"]
fmt.Fprintf(w, "User ID: %s", userID)
}
func main() {
r := mux.NewRouter()
r.HandleFunc("/user/{id:[0-9]+}", UserHandler) // 路径参数只允许数字
http.ListenAndServe(":8080", r)
}
{id:[0-9]+} 定义了一个正则表达式，限定路径参数 id 只能是一个或多个数字。mux.Vars(r) 获取路径中动态的部分。例如，如果访问 /user/123，vars["id"] 就会返回 123。
gorilla/mux 支持多种路由匹配方法，如仅匹配特定的 HTTP 方法（GET、POST、PUT、DELETE 等）：
r.HandleFunc("/post", PostHandler).Methods("POST")
r.HandleFunc("/get", GetHandler).Methods("GET")
Methods("POST") 限制此路由只能响应 POST 请求，Methods("GET") 限制只能响应 GET 请求。你还可以使用 Headers, Schemes 来进一步限制匹配条件：
r.HandleFunc("/secure", SecureHandler).Methods("GET").Headers("X-Auth-Token", "my-secret-token")
Headers("X-Auth-Token", "my-secret-token") 限制请求必须带有特定的请求头。Schemes("https") 限制只响应 HTTPS 请求。你可以使用 mux.Router 对路由进行分组，这在构建大型应用时尤其有用。比如，你可以将某一类请求放入一个子路由器中，便于管理和维护。
func main() {
r := mux.NewRouter()
// 创建一个子路由组
subRouter := r.PathPrefix("/api").Subrouter()
subRouter.HandleFunc("/v1/users", UsersHandler)
subRouter.HandleFunc("/v1/posts", PostsHandler)
http.ListenAndServe(":8080", r)
}
PathPrefix("/api") 将所有 /api 路径的请求交给 subRouter 处理。gorilla/mux 允许你在路由处理之前添加中间件。中间件可以在请求和响应之间执行操作，比如身份验证、日志记录、限流等。
package main
import (
"fmt"
"github.com/gorilla/mux"
"net/http"
)
func LoggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
fmt.Println("Request received:", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
})
}
func HomeHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Welcome to the Home Page!")
}
func main() {
r := mux.NewRouter()
// 应用中间件
r.Use(LoggingMiddleware)
r.HandleFunc("/", HomeHandler)
http.ListenAndServe(":8080", r)
}
r.Use(LoggingMiddleware) 为所有请求添加日志中间件，打印请求的 HTTP 方法和路径。gorilla/mux 支持使用正则表达式来匹配路径参数，提供比标准库 http.ServeMux 更高的灵活性。例如，你可以限制路径参数必须符合特定格式：
r.HandleFunc("/article/{id:[0-9]+}", ArticleHandler)
{id:[0-9]+} 使用正则表达式来确保 id 仅由数字组成。你可以定义路径中的可选参数，gorilla/mux 通过正则表达式使其成为可能：
r.HandleFunc("/user/{id:[0-9]+}/{name:[a-zA-Z]*}", UserHandler) // name 是可选的
这允许 name 参数为空，但如果提供了，必须符合字母匹配。
gorilla/mux 支持路由优先级。默认情况下，路由按顺序匹配，如果你定义了一个更加具体的路由，应该将其放在更一般的路由之前：
r.HandleFunc("/user/{id}", UserHandler)
r.HandleFunc("/user/{id}/details", UserDetailsHandler)
在这种情况下，/user/{id}/details 会被优先匹配。
如果你希望匹配所有没有明确路由的路径，可以使用通配符路由：
r.HandleFunc("/files/{file:.*}", FileHandler)
这里 {file:.*} 匹配所有路径。
package main
import (
"fmt"
"github.com/gorilla/mux"
"net/http"
)
func GetPostHandler(w http.ResponseWriter, r *http.Request) {
// 获取路径参数
vars := mux.Vars(r)
postID := vars["postId"]
fmt.Fprintf(w, "Fetching post with ID: %s", postID)
}
func CreatePostHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Creating a new post!")
}
func main() {
r := mux.NewRouter()
// 路由分组：/api/v1
apiRouter := r.PathPrefix("/api/v1").Subrouter()
apiRouter.HandleFunc("/posts", CreatePostHandler).Methods("POST")
apiRouter.HandleFunc("/posts/{postId:[0-9]+}", GetPostHandler).Methods("GET")
http.ListenAndServe(":8080", r)
}
gorilla/mux 是一个功能强大且灵活的 HTTP 路由库，适合用于中大型 Go Web 应用程序。它比标准库的 http.ServeMux 提供了更多的功能，尤其是在处理动态路由、路径参数、正则匹配、路由组等方面非常方便。它还支持中间件、路由优先级、可选路径参数等高级功能，是构建 RESTful API 和 Web 应用的一个优秀选择。
通过 gorilla/mux，你可以更轻松地构建高效且可维护的 HTTP 服务。