三、GO Web编程示例 - 路由（使用gorilla/mux）

前言

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有两个动态部分:

1. 书名 (go-programming-blueprint)
2. 页面(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)
}