Go Revel - Results(响应)
每个`Action`必须返回一个`revel.Result`实例,用来处理响应。它遵循了简单的接口:
type Result interface {
Apply(req *Request, resp *Response)
}
`revel.Controller`提供了一些方法来生成`Results`响应:
1、`Render`, `RenderTemplate` - 渲染模板, 传递参数
2、`RenderJson`, `RenderXml` - 将一个`struct`序列化为`json`或`xml`格式
3、`RenderText` - 返回一个纯文本响应
4、`Redirect` - 重定向到另一个`action`或URL
5、`RenderFile` - 返回一个文件, 一般作为一个附件下载
6、`RenderError` - 渲染`errors/500.html`模板来返回一个500状态
7、`NotFound` - 渲染`errors/404.html`模板来返回一个404状态
8、`Todo` - 返回一个存根响应 (500)
除此之外,开发人员还可以返回自己定义的`revel.Result`
**设置状态码与返回体**
每一个内建的`Result`都有默认的状态码与返回体,如果要手动改变,只需要简单的覆盖`response`中的属性即可:
func (c App) Action() revel.Result {
c.Response.Status = http.StatusTeapot
c.Response.ContentType = "application/dishware"
return c.Render()
}
##Render(渲染器)
在一个`action`内调用(如,`Controller.Action`)。`mvc.Controller.Render`可以做如下两件事:
1、将所有参数添加至controller的`RenderArgs`,并将它们的本地标识设置为key
2、渲染模板`views/Controller/Action.html`, 并将`RenderArgs`作为一个map传递
如果不成功,比如没找到模板,它会返回一个`ErrorResult`对象。
func (c MyApp) Action() revel.Result {
myValue := calculateValue()
return c.Render(myValue)
}
上面示例将`myValue`传递至模板。
revel需要根据调用者的方法名来确定模板的路径与参数,因此`c.Render()`只能在Action中调用。
##渲染 Json / Xml
程序可以通过传递任意Go类型来调用`RenderJson`或`RenderXml`,revel将通过`json.Marshal`或`xml.Marshal`来渲染。
如果`app.conf`中的`results.pretty=true`被定义,则将使用`MarshalIndent`进行序列化,以惨生更好的缩进供人阅读。
##Redirect(重定向)
revel提供了一下两种方式来进行重定向:
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 *App) Action() revel.Result {
return Html("Hello World")
}
##状态码
没一个`Result`都具有默认的状态码,可以很方便的更改它:
func (c *App) CreateEntity() revel.Result {
c.Response.Status = 201
return c.Render()
}