在 gin 里面,路由可以通过 r := gin.Default()
返回的对象来定义,这个方法会返回框架实例,而框架实例,也就是 gin.Engine
的实例,嵌套了 RouterGroup
结构体,因此可以直接通过 r
来定义路由,比如:
r.GET("/test", func(c *gin.Context) {
c.String(200, "Hello world!")
})
中间件
在 gin
里面,中间件的定义都是通过 RouterGroup
里面的 Use
方法来定义的。
中间件的定义方式
- 使用
engine.Use()
的时候,定义的中间件是对所有请求都有效的。 - 使用
g := r.Group("/user"); g.Use()
的时候,定义的中间件只对/user
路由分组有效
针对路由分组的中间件
// 不在 /user 路由分组下
r.GET("/test", func(c *gin.Context) {
c.String(200, "test...")
})
// /user 路由分组
g := r.Group("/user")
g.Use(func(c *gin.Context) {
fmt.Println("inner group")
})
g.GET("/", func(c *gin.Context) {
c.String(200, "user...")
})
g.GET("/test", func(c *gin.Context) {
c.String(200, "user test...")
})
// GET http://localhost:8085/test => test...(控制台无输出)
// GET http://localhost:8085/user => user...(同时控制台输出 “inner group”)
// GET http://localhost:8085/user/test => user test...(同时控制台输出 “inner group”)
gin 中路由的结构
在 gin
里面,路由实际上是一棵前缀树,树的节点保存在 Engine.trees
属性里面。
假如我们定义了如下路由,
r.GET("/test", func(c *gin.Context) {})
r.GET("/testa", func(c *gin.Context) {})
r.GET("/testb", func(c *gin.Context) {})
那么这棵树大概长以下这样:
- 对于每一个 HTTP 请求方法,在 gin 的路由树里面第一层有一个节点,这个节点的类型是
tree
- 路由树第一层节点是
tree
- 第二层以及更高层的节点是
node
tree
和 node
的定义如下:
type methodTree struct {
method string
root *node
}
type node struct {
path string
indices string
wildChild bool
nType nodeType
priority uint32
children []*node // child nodes, at most 1 :param style node at the end of the array
handlers HandlersChain
fullPath string
}