4、会话

Cookie vs Session

Cookie

Cookie是服务器发送到用户浏览器并保存在浏览器上的一小块数据。浏览器会在之后的请求中将Cookie发送回服务器，用于在无状态的HTTP协议中实现有状态的会话管理。

设置Cookie

Gin提供了简便的方法来设置Cookie：

func SetCookie(c *gin.Context) {
    // 设置简单的Cookie
    c.SetCookie("simple_cookie", "value", 3600, "/", "localhost", false, true)   
    c.String(200, "Cookie已设置")
}

Cookie参数：

读取Cookie

func GetCookie(c *gin.Context) {
    // 获取Cookie值
    cookie, err := c.Cookie("simple_cookie")
    
    if err != nil {
        c.String(200, "Cookie not found")
        return
    }
    
    c.String(200, "Cookie value: %s", cookie)
}

删除Cookie

删除Cookie可以通过设置负的过期时间实现：

func DeleteCookie(c *gin.Context) {
    // 设置maxAge为-1即可删除Cookie
    c.SetCookie("simple_cookie", "", -1, "/", "localhost", false, true)
    c.String(200, "Cookie已删除")
}

Session

Session是服务器用来存储特定用户会话所需信息的机制。Session通常使用唯一的标识符（Session ID）跟踪用户，该标识符通常存储在Cookie中。

Gin本身不提供Session管理，需要使用第三方库，如：

• github.com/gin-contrib/sessions
• github.com/gorilla/sessions

下面我们以gin-contrib/sessions为例：

安装：

go get -u github.com/gin-contrib/sessions

示例代码：

import (
    "github.com/gin-gonic/gin"
    "github.com/gin-contrib/sessions"
    "github.com/gin-contrib/sessions/cookie"
)

func main() {
    r := gin.Default()
    
    // 创建基于Cookie的存储引擎
    store := cookie.NewStore([]byte("secret_key"))
    
    // 设置Session中间件，指定Session名称为mysession
    r.Use(sessions.Sessions("mysession", store))
    
    // ... 路由设置
    r.Run(":8080")
}

Session存储选项

gin-contrib/sessions支持多种存储后端：

Session操作

基本的Session操作包括读取、设置和删除：

// 设置Session值
func SetSession(c *gin.Context) {
    session := sessions.Default(c)
    session.Set("user_id", 123)
    session.Set("username", "john_doe")
    // 保存会话，这一步是必须的
    session.Save()
    
    c.JSON(200, gin.H{"message": "Session已设置"})
}

// 获取Session值
func GetSession(c *gin.Context) {
    session := sessions.Default(c)
    userId := session.Get("user_id")
    username := session.Get("username")
    
    c.JSON(200, gin.H{
        "user_id":  userId,
        "username": username,
    })
}

// 删除Session值
func ClearSession(c *gin.Context) {
    session := sessions.Default(c)
    session.Clear()
    session.Save()
    
    c.JSON(200, gin.H{"message": "Session已清除"})
}

// 删除特定Session键
func DeleteSessionKey(c *gin.Context) {
    session := sessions.Default(c)
    session.Delete("username")
    session.Save()
    
    c.JSON(200, gin.H{"message": "用户名已从Session中删除"})
}

常用方法