Go Web开发之Revel - 返回值
返回值必须返回一个 rev.Result, 它处理response的生成并依附于一个简单的接口:
type Result interface { Apply(req *Request, resp *Response) }
rev.Controller 提供几个方法来生成结果:
- Render, RenderTemplate - 渲染一个模板, 传递参数.
- RenderJson, RenderXml - 序列化一个结构的json或xml.
- RenderText - 返回一个纯文本response.
- Redirect - 重定向到另一个action或URL
- RenderFile - 返回一个文件, 通常作为一个附件下载.
- RenderError - 返回一个 500 response 它渲染 errors/500.html 模板.
- NotFound - 返回一个 404 response 它渲染 errors/404.html 模板.
- Todo - 返回一个 stub response (500)
此外,开发人员可以定义他们自己的rev.Result并返回它.
设置状态码 / Content Type
每一个内建的结果都有一个默认的状态码和Content Type. 要重写它们的值只需在response时简单的设置那些要改变的属性:
func (c Application) Action() rev.Result { c.Response.Status = http.StatusTeapot c.Response.ContentType = "application/dishware" return c.Render() }
渲染
render在action中被调用, mvc.Controller.Render 做了两件事情:
- 添加全部的参数到controller的RenderArgs. 使用他们的本地标示符作为key.
- 执行模板“views/Controller/Action.html”, 传入controller的RenderArgs作为数据字典.
如果不成功(例如它不能找到模板文件), 它将返回一个ErrorResult替换.
允许开发人员这样写:
func (c MyApp) Action() rev.Result { myValue := calculateValue() return c.Render(myValue) }
在他们的模板中使用"myValue". 这通常比显式的构造一个字典更方便, 因为在很多的案例中数据将需要作为本地变量来处理.
注意:Revel通过调用的方法名称来决定模板路径和查找的参数名称.因此, c.Render()可能只能从action中调用.
RenderJson / RenderXml
应用程序可以调用 RenderJson 或 RenderXml 来传入任意的Go类型(通常是一个struct). Revel将用json.Marshal 或 xml.Marshal来序列化它.
如果results.pretty=true在app.conf中, 序列化将使用MarshalIndent来完成, 以便输出更优雅的带缩进的比较利于人们查看的版本.
Redirect
一个帮助函数提供了重定向. 它可以被用于两种方式.
1. 重定向一个不带参数的Action
return c.Redirect(Hotels.Settings)
这种形式对提供一个深度的类型安全和独立的路由很有帮助.(它生成自动的URL)
2. 重定向到一个格式化字符串
return c.Redirect("/hotels/%d/settings", hotelId)
这种形式需要必要的参数传递.
它返回一个302(临时跳转)状态码.
添加你自己的Result
下面是一个添加简单Result的示例.
创建类型:
type Html string func (r Html) Apply(req *Request, resp *Response) { resp.WriteHeader(http.StatusOK, "text/html") resp.Out.Write([]byte(r)) }
然后在action中使用它
func (c *Application) Action() rev.Result { return Html("<html><body>Hello World</body></html>") }
状态码
每一个Result将默认设置一个状态码.你能通过设置一个你自己的来重写这个默认的状态码.
func (c *Application) CreateEntity() rev.Result { c.Response.Status = 201 return c.Render() }
至此结束.