前言
Go的net/http包为HTTP协议提供了许多功能。但有一件事做得不是很好,那就是复杂的请求路由,例如将请求url分割成单个参数。幸运的是,有一个非常流行的程序包,在Go社区中以其良好的代码质量而闻名。在这个示例中,将看到如何使用gorilla/mux包创建带有命名参数、GET/POST处理程序和域限制的路由。
安装net/http包
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()
注册请求处理程序
一旦有了一个新的路由器,就可以像往常一样注册请求处理程序。唯一的区别是,通过r.HandleFunc(...)
调用HandleFunc
方法,而之前的使用方式为http.HandleFunc(...)
。
URL参数
gorilla/mux路由器最大的优点是能够从请求URL中提取片段。
例如,下面这是一个URL:
/books/go-programming-blueprint/page/10
这个URL有两个动态部分:
- 书名 (go-programming-blueprint)
- 页面(10)
为了让一个请求处理程序匹配上面提到的URL,你可以用占位符替换你的URL模式中的动态段:
r.HandleFunc("/books/{title}/page/{page}", func(w http.ResponseWriter, r *http.Request) {
// 获取书名
// 导航至相应的页面
})
最后一步是从这些片段中获取数据。这个包附带了函数mux.Vars(r),它接受http.Request作为参数,并且返回值包含了http请求各部分参数的映射。
func(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
vars["title"] // 书名
vars["page"] // 页面
}
设置路由器
有没有想过ttp.ListenAndServe(":80", nil)
中的nil是什么意思?它表示http服务器的主路由器,默认为nil,表示使用的是net/http包的默认路由器。将其替换为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)
}
网友评论