GF
框架提供了完善的 Session
管理能力,由 gsession
模块实现。由于 Session
机制在 HTTP
服务中最常用,因此后续章节中将着重以 HTTP
服务为示例介绍 Session
的使用。
基本介绍
接口文档: https://godoc.org/github.com/gogf/gf/os/gsession
任何时候都可以通过 ghttp.Request
获取 Session
对象,因为 Cookie
和 Session
都是和请求会话相关,因此都属于 Request
的成员对象,并对外公开。 GF
框架的 Session
默认过期时间是 24小时
。
SessionId
默认通过 Cookie
来传递,并且也支持客户端通过 Header
传递 SessionId
, SessionId
的识别名称可以通过 ghttp.Server
的 SetSessionIdName
进行修改。
Session
的操作是支持 并发安全
的,这也是框架在对 Session
的设计上不采用直接以 map
的形式操作数据的原因。在 HTTP
请求流程中,我们可以通过 ghttp.Request
对象来获取 Session
对象,并执行相应的数据操作。
ghttp.Server
中的 SessionId
使用的是客户端的 RemoteAddr + Header
请求信息通过 guid
模块来生成的,保证随机及唯一性: https://github.com/gogf/gf/blob/master/net/ghttp/ghttp_request.go
// Custom session id creating function.
err := request.Session.SetIdFunc(func(ttl time.Duration) string {
var (
address = request.RemoteAddr
header = fmt.Sprintf("%v", request.Header)
)
intlog.Print(address, header)
return guid.S([]byte(address), []byte(header))
})
gsession
模块
Session
的管理功能由独立的 gsession
模块实现,并已完美整合到了 ghttp.Server
中。由于该模块是解耦独立的,因此可以应用到更多不同的场景中,例如: TCP
通信、 gRPC
接口服务等等。
在 gsession
模块中有比较重要的三个对象/接口:
gsession.Manager
:管理Session
对象、Storage
持久化存储对象、以及过期时间控制。gsession.Session
:单个Session
会话管理对象,用于Session
参数的增删查改等数据管理操作。gsession.Storage
:这是一个接口定义,用于Session
对象的持久化存储、数据写入/读取、存活更新等操作,开发者可基于该接口实现自定义的持久化存储特性。 该接口定义详见: https://github.com/gogf/gf/blob/master/os/gsession/gsession_storage.go
存储实现方式
gsession
实现并为开发者提供了常见的三种 Session
存储实现方式:
- 基于文件存储(默认):单节点部署方式下比较高效的持久化存储方式;
- 基于纯内存存储:性能最高效,但是无法持久化保存,重启即丢失;
- 基于
Redis
存储:远程Redis
节点存储Session
数据,支持应用多节点部署;
三种方式各有优劣,详细介绍请查看后续章节。