Session / Flash

Revel 支持两种 基于 cookie 存储机制

  1. // 一个签名 cookie (不超过4kb).
  2. // 限制: Keys may not have a colon in them.
  3. type Session map[string]string
  4.  
  5. // 在每个请求中，Flash 获取并重写cookie。
  6. // 它允许数据每次跨越存储到一个页面。It allows data to be stored across one page at a time.
  7. // 它通常用来实现成功或错误消息。
  8. // 比如： Post/Redirect/Get : http://en.wikipedia.org/wiki/Post/Redirect/Get
  9. type Flash struct {
  10.     Data, Out map[string]string
  11. }

Session

Revel的 “session” 是一个加密签名存储的字符串 map。

影响如下:

  • 大小不超过 4kb。
  • 所有数据被保存为一个序列化的字符串。
  • 用户可以查看、修改所有数据 (未加密)。
    session cookie 的默认过期时间是浏览器关闭。 可以在app.config修改session.expires配置来指定一个有效期时间。格式是 time.ParseDuration.

Flash

Flash 支持单独使用字符串存储。这对于实现 Post/Redirect/Get 模式是很有用的, 或临时显示 “操作成功!” 或 “操作失败!” 消息。

下面是一个例子:

  1. // 一个设置页面
  2. func (c App) ShowSettings() revel.Result {
  3.     return c.Render()
  4. }
  5.  
  6. // 处理页面提交数据
  7. func (c App) SaveSettings(setting string) revel.Result {
  8.     // 验证用户输入
  9.     c.Validation.Required(setting)
  10.     if c.Validation.HasErrors() {
  11.         // 设置被带回的flash cookie错误信息
  12.         c.Flash.Error("Settings invalid!")
  13.         // 在flash cookie中保存验证错误
  14.         c.Validation.Keep()
  15.         // 复制所有给定的参数(URL, Form, Multipart)到flash cookie
  16.         c.FlashParams()
  17.         return c.Redirect(App.ShowSettings)
  18.     }
  19.     saveSetting(setting)
  20.     // 设置flash cookie成功消息
  21.     c.Flash.Success("Settings saved!")
  22.     return c.Redirect(App.ShowSettings)
  23. }

例子主要功能如下:

  • 用户获取设置页面。
  • 用户提交一个表单 (POST)。
  • 应用程序处理用户请求，保存错误或成功的消息到flash中，然后重定向设置页面 (REDIRECT)。

  • 用户获取设置页面, 显示flash中的消息。 (GET)
    主要使用了两个函数:

  • Flash.Success(message string) 是 Flash.Out["success"] = message简写方式

  • Flash.Error(message string) 是 Flash.Out["error"] = message简写方式
    在模板中使用key来获取Flash 消息。例如, 通过简写函数获取成功和错误消息:
  1. {{.flash.success}}
  2. {{.flash.error}}