Table of Contents

Routers 路由

Tango支持4种形式的路由匹配规则：
也可以使用Route来绑定路由，形式更灵活
路由优先级
路由参数
绑定控制器
路由级别中间件

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Routers 路由

Tango支持4种形式的路由匹配规则：

静态路由

tg.Get("/", new(Action))
tg.Get("/static", new(Action))

匹配 URL：/ 到 Action结构体的Get函数匹配 URL：/static 到 Action结构体的Get函数

命名路由

tg.Get("/:name", new(Action))
tg.Get("/(:name)", new(Action))
tg.Get("/:name1/:name2", new(Action))
tg.Get("/:name1-:name2", new(Action))
tg.Get("/(:name1)sss(:name2)", new(Action))

通配路由

tg.Get("/*name", new(Action))
tg.Get("/ttt/*name", new(Action))
tg.Get("/sss(*name)", new(Action))

路由参数支持*通配符

正则路由

tg.Get("/(:name.*)", new(Action))
tg.Get("/(:name[0-9]+)", new(Action))
tg.Get("/(:name1)-(:name2[0-9]+)", new(Action))

路由参数支持正则约束，不符合条件的参数会抛出404错误

也可以使用Route来绑定路由，形式更灵活

GET请求

t.Route("GET", "/", new(Action))

自定义方法名

type Action struct {}
func (Action) MyPost() {}

t.Route("POST:MyPost", "/", new(Action))

一次定义多个

t.Route([]string{"GET:MyGet", "POST"}, "/", new(Action))

自定义多个

t.Route(map[string]string{"GET":"MyGet", "POST":"MyPost"}, "/", new(Action))

路由优先级

静态路由和其它形式的路由都匹配时，静态路由优先，跟添加的顺序无关，如：

/abc
/(:name)

那么对于请求/abc，则/abc会匹配

多个动态路由均匹配时，先出现静态部分的路由优先，如：

"/(:name1)/(:name1)abc"
"/(:name1)/abc(:name1)abc(:name2)abc"

那么对于请求/abc/abc123abc123abc，则/(:name1)/abc(:name1)abc(:name2)abc会匹配

其它路由之间根据添加的顺序，先添加的优先。

路由参数

请求路径匹配后的参数可以通过*Context获得：

命名路由和正则路由: ctx.Params().Get(":name")
通配路由：ctx.Params().Get("*name")

绑定控制器

Tango 支持 5 种形式的函数或结构体方法作为执行体：

func()
func(http.ResponseWriter, *http.Request)
func(*tango.Context)
func(http.Response.Writer)
func(*http.Request)
struct.Get()
func()

t := tango.Classic()
t.Get("/", func() string {
    return "hello tango"
})

func(http.ResponseWriter, *http.Request)

t := tango.Classic()
t.Post("/", func(w http.ResponseWriter, *http.Request) {
    w.Write([]byte("hello tango"))
})

func(http.ResponseWriter)

t := tango.Classic()
t.Post("/", func(w http.ResponseWriter) {
    w.Write([]byte("hello tango"))
})

func(*http.Request)

t := tango.Classic()
t.Post("/", func(req *http.Request) string {
    return req.FormValue("key")
})

func(*tango.Context)

t := tango.Classic()
t.Get("/:name", func(ctx *tango.Context) {
    ctx.Write([]byte("hello " + ctx.Params().Get(":name")))
})

structs

type Action struct {}
func (a *Action) Get() string {
    return "haha"
}
t := tango.Classic()
t.Get("/:name", new(Action))

路由级别中间件

中间件可以是全局的，也可以应用到某个Group，也可以只针对某个Route，针对某个Route的中间件作为可选参数紧跟在Action之后即可。

t.Get("/:name", new(Action), MyMiddleware1(), MyMiddlewares2())