1. Session模块

2. 特别注意

这个文档是 session 独立模块，即你单独拿这个模块应用于其他应用中，如果你想在 beego 中使用 session，请查看文档session 控制

3. session 介绍

session 模块是用来存储客户端用户，session 模块目前只支持 cookie 方式的请求，如果客户端不支持 cookie，那么就无法使用该模块。

session 模块参考了 database/sql 的引擎写法，采用了一个接口，多个实现的方式。目前实现了 memory、file、Redis 和 MySQL 四种存储引擎。

通过下面的方式安装 session：

  1. go get github.com/astaxie/beego/session

3.1. session 使用

首先你必须导入包：

  1. import (
  2.     "github.com/astaxie/beego/session"
  3. )

然后你初始化一个全局的变量用来存储 session 控制器：

  1. var globalSessions *session.Manager

接着在你的入口函数中初始化数据：

  1. func init() {
  2.         sessionConfig := &session.ManagerConfig{
  3.     CookieName:"gosessionid", 
  4.     EnableSetCookie: true, 
  5.     Gclifetime:3600,
  6.     Maxlifetime: 3600, 
  7.     Secure: false,
  8.     CookieLifeTime: 3600,
  9.     ProviderConfig: "./tmp",
  10.     }
  11.     globalSessions, _ = session.NewManager("memory",sessionConfig)
  12.     go globalSessions.GC()
  13. }

NewManager 函数的参数的函数如下所示

  • 引擎名字，可以是 memory、file、mysql 或 redis。
  • 一个 JSON 字符串,传入 Manager 的配置信息
    • cookieName: 客户端存储 cookie 的名字。
    • enableSetCookie,omitempty: 是否开启 SetCookie,omitempty 这个设置
    • gclifetime: 触发 GC 的时间。
    • maxLifetime: 服务器端存储的数据的过期时间
    • secure: 是否开启 HTTPS，在 cookie 设置的时候有 cookie.Secure 设置。
    • sessionIDHashFunc: sessionID 生产的函数，默认是 sha1 算法。
    • sessionIDHashKey: hash 算法中的 key。
    • cookieLifeTime: 客户端存储的 cookie 的时间，默认值是 0，即浏览器生命周期。
    • providerConfig: 配置信息，根据不同的引擎设置不同的配置信息，详细的配置请看下面的引擎设置

最后我们的业务逻辑处理函数中可以这样调用：

  1. func login(w http.ResponseWriter, r *http.Request) {
  2.     sess, _ := globalSessions.SessionStart(w, r)
  3.     defer sess.SessionRelease(w)
  4.     username := sess.Get("username")
  5.     if r.Method == "GET" {
  6.         t, _ := template.ParseFiles("login.gtpl")
  7.         t.Execute(w, nil)
  8.     } else {
  9.         sess.Set("username", r.Form["username"])
  10.     }
  11. }

globalSessions 有多个函数如下所示：

  • SessionStart 根据当前请求返回 session 对象
  • SessionDestroy 销毁当前 session 对象
  • SessionRegenerateId 重新生成 sessionID
  • GetActiveSession 获取当前活跃的 session 用户
  • SetHashFunc 设置 sessionID 生成的函数
  • SetSecure 设置是否开启 cookie 的 Secure 设置

返回的 session 对象是一个 Interface，包含下面的方法

  • Set(key, value interface{}) error
  • Get(key interface{}) interface{}
  • Delete(key interface{}) error
  • SessionID() string
  • SessionRelease()
  • Flush() error

3.2. 引擎设置

上面已经展示了 memory 的设置，接下来我们看一下其他三种引擎的设置方式：

  • mysql

    其他参数一样，只是第四个参数配置设置如下所示，详细的配置请参考 mysql：

  1.   username:password@protocol(address)/dbname?param=value

  • redis

    配置文件信息如下所示，表示链接的地址，连接池，访问密码，没有保持为空：

注意：若使用redis等引擎作为session backend，请在使用前导入 < _ "github.com/astaxie/beego/session/redis" >

  1.       否则会在运行时发生错误，使用其他引擎时也是同理。
  1.   127.0.0.1:6379,100,astaxie

  • file

    配置文件如下所示，表示需要保存的目录，默认是两级目录新建文件，例如 sessionID 是 xsnkjklkjjkh27hjh78908，那么目录文件应该是 ./tmp/x/s/xsnkjklkjjkh27hjh78908：

  1.   ./tmp

3.3. 如何创建自己的引擎

在开发应用中，你可能需要实现自己的 session 引擎，beego 的这个 session 模块设计的时候就是采用了 interface，所以你可以根据接口实现任意的引擎，例如 memcache 的引擎。

  1. type SessionStore interface {
  2.     Set(key, value interface{}) error //set session value
  3.     Get(key interface{}) interface{}  //get session value
  4.     Delete(key interface{}) error     //delete session value
  5.     SessionID() string                //back current sessionID
  6.     SessionRelease()                  // release the resource & save data to provider
  7.     Flush() error                     //delete all data
  8. }
  10. type Provider interface {
  11.     SessionInit(maxlifetime int64, savePath string) error
  12.     SessionRead(sid string) (SessionStore, error)
  13.     SessionExist(sid string) bool
  14.     SessionRegenerate(oldsid, sid string) (SessionStore, error)
  15.     SessionDestroy(sid string) error
  16.     SessionAll() int //get all active session
  17.     SessionGC()
  18. }

最后需要注册自己写的引擎：

  1. func init() {
  2.     Register("own", ownadaper)
  3. }