gin.Cookie() 使用

下面的小例子可以使用 postman 来请求，只要服务启动了，其实主要就是 Cookie 函数来拿到请求头的 value，用 SetCookie 函数来设置 cookie 的 value

func main() {
  r := gin.Default()
  r.Get("/cookie", handler.MyHandler)
  r.Run(":8080")
}

func MyHandler(c *gin.Context) {
  // 获取 cookie 的键 my_cookie 对应的 value
  cookie_value, err := c.Cookie("my_cookie")
 
  if err != nil {
    cookie_value = "no value"
    // 设置 cookie
    c.SetCookie("my_cookie", cookie_value, 3600, "/", "localhost", false, true)
  }
  
  // 然后我们可以在响应头中看下，result 是响应头的键，cookie_value 是响应头的值
  c.Header("result", cookie_value)
}

gin.BasicAuth() 中间件

如下，关键是使用 secrets 的 map 可以想象是数据库中的数据，然后在某个路由分组加上这个中间件 gin.BasicAuth()，此中间件需要在访问分组路由中的接口时候都能触发这个中间件识别，再然后登录时候通过 c.MustGet() 拿到用户名是什么，将用户名在“数据库”中做一个搜索，并将密码做一些匹配，如果成功，用户登录，返回正常 json

// 模拟一些私人数据
var secrets = gin.H{
	"foo":    gin.H{"email": "foo@bar.com", "phone": "123433"},
	"austin": gin.H{"email": "austin@example.com", "phone": "666"},
	"lena":   gin.H{"email": "lena@guapa.com", "phone": "523443"},
}

func main() {
	r := gin.Default()

	// 路由组使用 gin.BasicAuth() 中间件
	// gin.Accounts 是 map[string]string 的一种快捷方式
	authorized := r.Group("/admin", gin.BasicAuth(gin.Accounts{
		"foo":    "bar",
		"austin": "1234",
		"lena":   "hello2",
		"manu":   "4321",
	}))

	// /admin/secrets 端点
	// 触发 "localhost:8080/admin/secrets
	authorized.GET("/secrets", func(c *gin.Context) {
		// 获取用户，它是由 BasicAuth 中间件设置的
		user := c.MustGet(gin.AuthUserKey).(string)
		if secret, ok := secrets[user]; ok {
			c.JSON(http.StatusOK, gin.H{"user": user, "secret": secret})
		} else {
			c.JSON(http.StatusOK, gin.H{"user": user, "secret": "NO SECRET :("})
		}
	})

	// 监听并在 0.0.0.0:8080 上启动服务
	r.Run(":8080")
}

github.com/gin-contrib/sessions 包

虽然要引入 github.com/gin-contrib/sessions 包，但实际这个包也是属于 gin-gonic 组下的

r := gin.Default()

// 中间引入它，这个 secret 主要是为了生成密钥，可以随意指定字符串
store := cookie.NewStore([]byte("secret"))
// 指定浏览器端响应头的 cookie 的名字
r.Use(sessions.Sessions("SESSIONID222", store))

等到登录成功，session set 值之后，接口返回的响应头中就会有 Set-Cookie 字段，其中内部的 key 就是 SESSIONID222，如下图所示

在这里插入图片描述

然后浏览器会保存 cookie 的内容，后面请求时候请求头中都会带上这个 cookie 如下

在这里插入图片描述

上面已经定义好使用这样的方式鉴权了，下面加入登录之后如何保存登录信息呢？如下在某个 HandlerFunc 中

username := c.PostForm("username")
password := c.PostForm("password")

// 若数据库查询都存在且正确
if (username == "aaa" && password == "bbb") {
  s := sessions.Default(c)
  // 设置该用户的 session
  s.Set("user", username)
  // 保存
  s.Save()
} else {
  // todo: xxx
}

这样在一些页面中可以判定这个 s.Get(“user”) 的 session 是否存在来判定有没有登录

s := sessions.Default(c)
// 拿到请求者 session 里头的数据
username := s.Get("user")
if username != nil {
  // todo: xxx
} else {
  // todo: yyy
}

总结核心思想：就是每次首次登录时候，请求方是没有带 cookie 的请求头的，这时候后端会判断用户密码是否符合数据库要求匹配之后，将用户信息存储到 session 中，然后该次请求响应头中返回 Set-Cookie 的字段，里头是 session 信息，然后后面的所有请求都会带上 Cookie 的请求头，里头的内容是刚才 session 的信息，这样后面每次请求都能判定 session 里头的信息在后端 session 中是否有被存储过，如果存储过即判定可以访问。如果后面退出登录，实际就是后端把 session 存储清空了，这样前端即使带着 Cookie 的请求头过来，后端 session 中依然找不到数据，因此判定为没有登录，因此无法访问

其实可以形象的理解成，首次登录时候相当于一个人没有身份证去向政府申请身份证，然后政府部门（后端）存储好了身份证数据，然后把这个身份证返给你个人（返给前端），然后你每次到政府各个部门办事就只用拿着一个身份证就能办事了，如果政府部门因为一些原因删除了你身份证的认定（退出登录，后端清除 session），那你即使带着身份证也无法在各个政府部门办事了，因此你需要重新找政府部门办理新的身份证（重新登录）