Go语言Web框架Tango在Session中间件中的设计

Tango在创建之初的目标就是既有Beego的效率,又有martini的灵活中间件。因此Session也是在核心库 tango 之外作为官方中间件存在,地址是 tango-session

Session因为有着灵活的设计,因此可以完成很多我们希望的功能。首先看下Session中间件的选项:

type Options struct {
    MaxAge           time.Duration
    SessionIdName    string
    Store            Store
    Generator        IdGenerator
    Tracker          Tracker
    OnSessionNew     func(*Session)
    OnSessionRelease func(*Session)
}

其中我将要着重讲的是Store,Generator和Tracker。

Store

Store是一个接口,主要作用是存储Session中的内容,其定义如下:

type Store interface {
    Add(id Id) bool
    Exist(id Id) bool
    Clear(id Id) bool

    Get(id Id, key string) interface{}
    Set(id Id, key string, value interface{}) error
    Del(id Id, key string) bool

    SetMaxAge(maxAge time.Duration)
    SetIdMaxAge(id Id, maxAge time.Duration)

    Run() error
}

默认的内核自带了MemoryStore,这将会把所有Session内容保存在内存中。同时官方中间件中也提供了

这几种方式进行Session内容的存储。当然如果你愿意,也可以自己来实现一个Store。

Generator

Generator是一个接口,主要封装了SessionID的生成算法,其定义如下:

type IdGenerator interface {
    Gen(req *http.Request) Id
    IsValid(id Id) bool
}

默认的Generator是Sha1Generator,他是通过req.RemoteAddr,当前时间和随机字符串生成。 当然你也可以自定义更好的算法来生成SessionID。

Tracker

Tracker是一个接口,主要封装了Session的跟踪方式,其定义如下:

type Tracker interface {
    SetMaxAge(maxAge time.Duration)
    Get(req *http.Request) (Id, error)
    Set(req *http.Request, rw http.ResponseWriter, id Id)
    Clear(rw http.ResponseWriter)
}

默认的Tracker实现是CookieTracker,就是我们最常见的,将SessionID保存在cookie中,通过cookie来进行跟踪。Session中间件中也同时提供了HeaderTracker,支持将SessionID保存在自定义的Http Header中。当然你也可以自定义Tracker,比如通过URL参数来进行跟踪等等方式。

最后

看起来似乎很复杂,但是一般情况下都不需要去改变,你只需要

t := tango.Classic()
t.Use(session.New())
t.Run()
blog comments powered by Disqus