文件存储

在默认情况下, ghttp.ServerSession 存储使用了 内存+文件 的方式,使用 StorageFile 对象实现。具体原理为:

  1. Session 的数据操作完全基于内存;
  2. 使用 gcache 进程缓存模块控制数据过期;
  3. 使用文件存储持久化存储管理 Session 数据;
  4. 当且仅有当 Session 被标记为 dirty 时(数据有更新)才会执行 Session 序列化并执行文件持久化存储;
  5. 当且仅当内存中的 Session 不存在时,才会从文件存储中反序列化恢复 Session 数据到内存中,降低 IO 调用;
  6. 序列化/反序列化使用的是标准库的 json.Marshal/UnMarshal 方法;

从原理可知,当 Session 为读多写少的场景中, Session 的数据操作非常高效。

Session-File - 图1提示

有个注意的细节,由于文件存储涉及到文件操作,为便于降低 IO 开销并提高 Session 操作性能,并不是每一次 Session 请求结束后都会立即刷新对应 SessionTTL 时间。而只有当涉及到更新操作(被标记为 dirty)时才会立即刷新其 TTL;针对于读取请求,将会每隔 一分钟 更新前一分钟内读取操作对应的 Session 文件 TTL 时间,以便于 Session 自动续活。

使用示例

  1. package main
  2. import (
  3. "github.com/gogf/gf/v2/frame/g"
  4. "github.com/gogf/gf/v2/net/ghttp"
  5. "github.com/gogf/gf/v2/os/gtime"
  6. "time"
  7. )
  8. func main() {
  9. s := g.Server()
  10. s.SetSessionMaxAge(time.Minute)
  11. s.Group("/", func(group *ghttp.RouterGroup) {
  12. group.ALL("/set", func(r *ghttp.Request) {
  13. r.Session.Set("time", gtime.Timestamp())
  14. r.Response.Write("ok")
  15. })
  16. group.ALL("/get", func(r *ghttp.Request) {
  17. r.Response.Write(r.Session.Data())
  18. })
  19. group.ALL("/del", func(r *ghttp.Request) {
  20. _ = r.Session.RemoveAll()
  21. r.Response.Write("ok")
  22. })
  23. })
  24. s.SetPort(8199)
  25. s.Run()
  26. }

在该实例中,为了方便观察过期失效,我们将 Session 的过期时间设置为 1分钟。执行后,

  1. 首先,访问 http://127.0.0.1:8199/set 设置一个 Session 变量;
  2. 随后,访问 http://127.0.0.1:8199/get 可以看到该 Session 变量已经设置并成功获取;
  3. 接着,我们停止程序,并重新启动,再次访问 http://127.0.0.1:8199/get,可以看到 Session 变量已经从文件存储中恢复;
  4. 等待1分钟后,再次访问 http://127.0.0.1:8199/get 可以看到已经无法获取该 Session,因为该 Session 已经过期;