Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

文件存储

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

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

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

Tip

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

使用示例

https://github.com/gogf/gf/v2/blob/master/.example/os/gsession/storage-file/file.go

Code Block
languagego
package main

import (
	"github.com/gogf/gf/v2/frame/g"
	"github.com/gogf/gf/v2/net/ghttp"
	"github.com/gogf/gf/v2/os/gtime"
	"time"
)

func main() {
	s := g.Server()
	s.SetConfigWithMap(g.Map{
		"SessionMaxAge": SetSessionMaxAge(time.Minute,
	})
	s.Group("/", func(group *ghttp.RouterGroup) {
		group.ALL("/set", func(r *ghttp.Request) {
			r.Session.Set("time", gtime.Timestamp())
			r.Response.Write("ok")
		})
		group.ALL("/get", func(r *ghttp.Request) {
			r.Response.Write(r.Session.MapData())
		})
		group.ALL("/del", func(r *ghttp.Request) {
			_ = r.Session.ClearRemoveAll()
			r.Response.Write("ok")
		})
	})
	s.SetPort(8199)
	s.Run()
}

在该实例中,为了方便观察过期失效,我们将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已经过期;



Panel
titleContent Menu

Table of Contents