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)) //