Session

Go的net/http本身不带session的机制,需要开发人员自行实现,gwk实现了内存中的session存储机制,如果需要将session存在其他地方比如redis或者memcache需要实现gwk的session.Driver接口。

session.Driver

session.Driver的接口如下

type Driver interface {
// 初始化
Init(options string) error // Driver的名字
Name() string // 添加key,如果重复返回false,error
Add(sessionId, key string, value interface{}) (bool, error) // 读取key的值,如果不存在返回nil,false,nil,如果报错返回nil,false,error
Get(sessionId, key string) (interface{}, bool, error) // 添加key,如果存在则更新
Set(sessionId, key string, value interface{}) error // 移除key
Remove(sessionId, key string) error // 根据sessionid创建新的session
New(sessionId string, timeout time.Duration) error // 移除整个session
Abandon(sessionId string) error // 判断sessionid是否存在
Exists(sessionId string) (bool, error) // 返回session中所有key
Keys(sessionId string) ([]string, error)
}

gwk的Driver接口相比其他的框架要复杂一点,主要是为了Driver的开发人员可以实现更精确的控制。

自定义的session.Driver可以通过函数Register注册。

func Register(name string, driver Driver)

gwk内置了In-memory的session.Driver的实现, 注册的名字为"session_default",是基于开源项目MCache的,MCache的详细信息请参考其项目主页 [https://github.com/sdming/mcache]。

你可以通过修改web.conf文件或者直接修改WebConfig实例来启用或者关闭session机制,配置项如下:

  • SessionEnable: 是否启用session
  • SessionTimeout: session的超时时间
  • SessionDriver: session driver的名字

如果你的session.Driver需要保存配置信息,请放在plugin.conf文件,gwk初始化时会将Config.PluginConfig.Child(session_driver_name)的数据作为options参数调用Driver的Init方法。

使用Session

你可以通过HttpContext的字段Session来获得session实例,字段SessionIsNew来获取session是否当前的请求创建的,方法SessionId()获取session的id。

./demo中的session.go文件演示了如何操作session。

获取session id

// url: /session/id
func (c *Session) Id(ctx *wk.HttpContext) (wk.HttpResult, error) {
id := ctx.SessionId()
return wk.Data(id), nil
}

添加session

// url: /session/add?k=test&v=101
func (c *Session) Add(ctx *wk.HttpContext) (wk.HttpResult, error) {
ok, err := ctx.Session.Add(ctx.FV("k"), ctx.FV("v"))
return wk.Data(ok), err
}

读取session中key的值

// url: /session/get?k=test
func (c *Session) Get(ctx *wk.HttpContext) (result wk.HttpResult, err error) {
v, _, err := ctx.Session.Get(ctx.FV("k"))
return wk.Data(v), err
}

设置session

// url: /session/set?k=test&v=101
func (c *Session) Set(ctx *wk.HttpContext) (wk.HttpResult, error) {
err := ctx.Session.Set(ctx.FV("k"), ctx.FV("v"))
return wk.Data(err == nil), err
}

移除session中的key

// url: /session/remove?k=test
func (c *Session) Remove(ctx *wk.HttpContext) (wk.HttpResult, error) {
err := ctx.Session.Remove(ctx.FV("k"))
return wk.Data(err == nil), err
}

放弃整个session

// url: /session/abandon
func (c *Session) Abandon(ctx *wk.HttpContext) (wk.HttpResult, error) {
err := ctx.Session.Abandon()
return wk.Data(true), err
}

返回session中所有的key

// url: /session/keys
func (c *Session) Keys(ctx *wk.HttpContext) (wk.HttpResult, error) {
keys, err := ctx.Session.Keys()
return wk.Data(fmt.Sprintln(keys)), err
}

另外在session.go中还包含一个如何注册自定义session.Driver的例子。

缓存

view模板的缓存以及配置数据的缓存前文已经讲过,除此之外gwk可以将静态文件的内容缓存到内存中。这种缓存策略并不一定很有用,如果网站规模小流量不大,缓存静态文件的收益有限,而网站达到一定规模,为了提升性能,静态文件常部署在单独的静态文件服务器或者借助CDN,另外Go的内核用sendfile来处理静态文件,如果将其内容缓存到内存就没有办法用到sendfile的优势了。

开启gwk静态文件缓存的配制方法如下:

#plugin.conf

#static processor config
static_processor: { #开启静态文件缓存,默认是false
cache_enable: true #缓存1小时(3600秒),默认是86400秒
cache_expire: 3600
}
# -->end static processor

gzip压缩可以参考前文的CompressProcessor部分

gwk并不内置供开发人员调用的Cache功能,如果需要in-memory的第三方缓存库,可以参考上文提到的MCache,项目在 [https://github.com/sdming/mcache]

日志

gwk本身不实现复杂的日志功能,只是公开了一个log.Logger类型的字段Logger,所有的日志信息会被记录到这个Logger中,另外你还可以通过设置LogLevel来调整记录日志的级别,默认为LogError,支持的日志级别为:

const (
LogError = iota
LogDebug
)

验证

虽然很多Web框架提供了验证功能,但gwk还没有这方面的计划。

ORM

gwk关注Web开发,短时间内不会包含ORM的功能,需要访问数据库的开发人员可以关注开源项目(kdb)[https://github.com/sdming/kdb],项目刚启动,功能大概完成了30%。

Performance benchmark

Incoming

04-28 11:30