Go Revel - Routing(路由)
`Routing`路由控制着请求应该由哪些控制器接受。
它在项目的`conf/routes`文件中定义。
格式为:
(METHOD) (URL Pattern) (Controller.Action)
(请求方法) (URL 匹配模式) (Controller.Action)
示例:
# conf/routes
# This file defines all application routes (Higher priority routes first)
GET /login App.Login # 一个简单的路径
GET /hotels/ Hotels.Index # 匹配 /hotels 与 /hotels/ (尾部斜杠选填)
GET /hotels/:id Hotels.Show # 提取一个URI参数
WS /hotels/:id/feed Hotels.Feed # 匹配相应的WebSockets协议
POST /hotels/:id/:action Hotels.:action # 自动匹配相应的action
GET /public/*filepath Static.Serve("public") # 将 /app/public 下的资源路径映射为 /public/...
* /:controller/:action :controller.:action # 捕获所有,自动映射
##简单的URL路径
GET /login App.Login
最简单的路由为精确匹配,它将`/login`转到`App.Login`这个action
##尾部反斜杠
GET /hotels/ Hotels.Index
这里`/hotels/`与`/hotels`路径都会被转到`Hotels.Index`Action,对于尾部的反斜杠,不管有没有都会同等对待。
##URL参数
GET /hotels/:id Hotels.Show
斜杠后`:`标识的字段会被匹配并提取。这里`:id`也就是反斜杠之后的路径将会被匹配提取并传入至Action的方法。
例如`/hotels/123`中,123将会被提取为id。
被提取的参数会被保存至`Controller.Params`,如下方法可以在`Action`中获取参数:
func (c Hotels) Show(id int) revel.Result {
...
}
或
func (c Hotels) Show() revel.Result {
var id string = c.Params.Get("id")
...
}
或
func (c Hotels) Show() revel.Result {
var id int
c.Params.Bind(&id, "id")
...
}
##*号通配符
GET /public/*filepath Static.Serve("public")
*号必须位于匹配路径的最末端,它将提取所有符合的字符串。例如,这里将`/public/`之后的所有字符串匹配提取。
##Websockets
WS /hotels/:id/feed Hotels.Feed
`WS`用来定义websockets协议下的路由。它指向的action必须具有如下签名:
func (c Hotels) Feed(ws *websocket.Conn, id int) revel.Result {
...
}
即第一参数必须是`*websocket.Conn`类型。
##静态资源
GET /public/*filepath Static.Serve("public")
GET /favicon.ico Static.Serve("public", "img/favicon.png")
路由中,通过`Static`模块提供制定文件夹的静态文件服务。它只会匹配一个`Static`控制器。它的Action接受两个参数:
**prefix (string)** 指向资源文件的绝对/相对路径
**filepath (string)** 指定文件的相对路径(相对于`prefix`)
## 固定参数
可以像静态资源服务一样将参数使用固定的名称:
GET /products/:id ShowList("PRODUCT")
GET /menus/:id ShowList("MENU")
`Action`名称后加上传入变量的名称,可以将匹配到的参数按顺序转为命名的参数,方便在`Action`中处理。
## 自动路由
POST /hotels/:id/:action Hotels.:action
* /:controller/:action :controller.:action
自动匹配相应的控制器与动作,这里不区分大小写。
上面示例中,第一条路由的调用规则如下:
/hotels/1/show => Hotels.Show
/hotels/2/details => Hotels.Details
第二条调用规则,自动路由方式:
/app/login => App.Login
/users/list => Users.List
在大小写不同时,也会进行相应路由:
/APP/LOGIN => App.Login
/Users/List => Users.List
##反向路由
在使用revel构建项目时,它会根据routes文件生成`app/routes/routes.go`源码。
可以如下格式来在代码中只是用反向路由:
routes.Controller.Action(param1, param2)
下面实例中演示了如何调用反向路由
import (
"github.com/robfig/revel"
"project/app/routes"
)
type App struct { *revel.Controller }
// 显示一个表单
func (c App) ViewForm(username string) revel.Result {
return c.Render(username)
}
// 处理一个提交的表单
func (c App) ProcessForm(username, input string) revel.Result {
...
if c.Validation.HasErrors() {
c.Validation.Keep()
c.Flash.Error("Form invalid. Try again.")
return c.Redirect(routes.App.ViewForm(username)) // <--- 反向路由
}
c.Flash.Success("Form processed!")
return c.Redirect(routes.App.ViewConfirmation(username, input)) // <--- 反向路由
}