# 起子
自Tango发布之后大概有3个月了,受到了很多人的关注,也提了很多的改进意见。我自己也通过不断
的用他开发,从而发现问题,不断改进。昨天我发布了0.4.0版本,很明显,最近版本号升得比较快。
从0.3到0.4,最重大的改变是路由方面的。路由基本上完全重写,目前路由变得更统一,更灵活,性能上也有不少提升。来看看新的路由如何使用。
# 新路由
目前支持4种路由,静态路由,命名路由,Catch-All路由,正则路由。下面分别说说4种路由:
## 静态路由
静态路由是最普遍的,默认的net/http目前只支持静态路由,比如:
```Go
tango.Get("/", new(Action))
tango.Get("/public/bootstrap.min.css", new(Action))
```
## 命名路由
在0.4之前的版本中,命名路由的形式一般是`:name`,在0.4版本兼容以前的模式,并且新增了`(:name)`的形式。这个新的设计将允许使用字符或者数字作为分隔符。比如,新旧版本都支持这种形式:
```Go
tango.Get("/:name", new(Action))
tango.Get("/:name1-:name2", new(Action))
tango.Get("/:name1/:name2", new(Action))
```
而新版本增加了对下列形式的支持:
```Go
tango.Get("/(:name1)abc(:name2)", new(Action))
tango.Get("/(:name1)123(:name2)", new(Action))
```
## Catch-All路由
Catch-All路由是0.4新增的一种路由形式。Catch-All路由和命名路由很相似,他们的的唯一区别在于
命名路由不能匹配/,而Catch-All路由可以匹配/。比如:
```Go
tango.Get("/*name", new(Action))
tango.Get("/*name/123", new(Action))
```
比如当访问 `/name1/name2/123` 时,第一个路由会匹配出 `*name = name1/name2/123`,第二个路由会匹配出 `*name = name1/name2`。当然,如果实际情况两个路由都存在,第一个路由会覆盖第二个路由,第二个路由将永远不会被匹配到。
获取Catch-All路由请通过 `Params.Get("*name")`。
## 正则路由
**注意:0.4版本的正则路由和老版本的正则路由不兼容**
为了统一表达形式,0.4版本抛弃了以前版本中完全使用Go的正则的方式来进行匹配的方式,如:
0.3版本以前:
```Go
tango.Get("/(.*)", new(Action))
```
而获取参数通过 Params.Get(":0")来获取。
0.3版本到0.4版本之间:
```Go
tango.Get("/(?P<name>.*)", new(Action))
```
而获取参数通过 Params.Get(":name")来获取,同时也可以使用`Params.Get(":0")`来获取。
0.4版本不兼容前面的语法,再次提醒注意,而采用如下方法,匿名的正则已不被允许,`Params.Get(":0")`也不再受支持:
```Go
tango.Get("/(:name.*)", new(Action))
tango.Get("/(:name[0-9]+)", new(Action))
```
而获取参数通过 Params.Get(":name")来获取,也可以通过Params[0].Value来获取,Params目前变成了一个Slice。
# 路由优先级
1. 静态路由和其它路由都匹配时,静态路由优先,跟添加的顺序无关;
2. 其它路由之间根据添加的顺序,先添加的优先。
例如:
```Go
t := tango.Classic()
t.Get("/:name", new(Others))
t.Get("/admin", new(Admin))
t.Run()
```
以上代码,当请求 `/admin` 时, `Admin` 的 `Get` 方法将被执行。
```Go
t := tango.Classic()
t.Get("/:name", new(Admin))
t.Get("/*name", new(Others))
t.Run()
```
以上代码,当请求 `/admin` 时, `Admin` 的 `Get` 方法将被执行;当请求 `/admin/ui`, `Others` 的 `Get` 方法将被执行。
```Go
t := tango.Classic()
t.Get("/*name", new(Admin))
t.Get("/:name", new(Others))
t.Run()
```
以上代码, `Others` 的 `Get` 方法将永远不会被执行, 因为所有匹配的请求均会调用 `Admin` 的 `Get` 方法。
# 注意事项
关于新路由也有几点需要注意的事项:
* 命名和正则等可以混合使用,如:`/:name1-(:name2[0-9]+)`,但是要注意,必须要有分隔符,没有分隔符,在新增路由时会panic,比如如下形式就不受支持:`/:name1:name2`
* 命名理论上是可以相同的,并且程序不会报错,但是不建议这样使用。通过Params.Get(":name")只会返回第一个,可通过自己遍历Params来获取多个相同的名字。比如:`/:name-:name`,这种规则是允许的,但是不推荐。
# 收尾
新的路由形式上更加统一,相信可以满足大家的绝大部分需求。希望大家多提宝贵意见,可加QQ群:369240307,或者在 [github.com/lunny/tango](https://github.com/lunny/tango) 以及 [git.oschina.net/lunny/tango](http://git.oschina.net/lunny/tango) 中提出issue。
有疑问加站长微信联系(非本文作者)