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.IndexAction，对于尾部的反斜杠，不管有没有都会同等对待。

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))  // <--- 反向路由
}