方法列表

我们先来看看Cookie操作有哪些相关方法:
godoc.org/github.com/johng-cn/gf/g/net/ghttp#Cookie

  1. func (c *Cookie) Close()
  2. func (c *Cookie) Map() map[string]string
  3. func (c *Cookie) Get(key string) string
  4. func (c *Cookie) Output()
  5. func (c *Cookie) Remove(key, domain, path string)
  6. func (c *Cookie) SessionId() string
  7. func (c *Cookie) Set(key, value string)
  8. func (c *Cookie) SetCookie(key, value, domain, path string, maxage int)
  9. func (c *Cookie) SetSessionId(sessionid string)
  10. func (s *Server) GetCookieMaxAge() int
  11. func (s *Server) SetCookieMaxAge(maxage int)

任何时候都可以通过*ghttp.Request对象获取到当前请求对应的Cookie对象,因为Cookie和Session都是和请求会话相关,因此都属于ghttp.Request的成员对象,并对外公开。Cookie对象不需要手动Close,请求流程结束后,HTTP Server会自动关闭掉。

此外,Cookie中封装了两个SessionId相关的方法,Cookie.SessionId()用于获取当前请求的SessionId,每个请求的SessionId都是唯一的,并且伴随整个请求流程。Cookie.SetSessionId(session string)用于自定义设置当前的SessionId,可以实现自定义的Session控制,以及Session跨域支持(特别是多服务器集群环境下)。

在任何时候,我们都可以通过ghttp.Server对象来修改和获取Cookie的过期时间。

使用示例

  1. package main
  2. import (
  3. "gitee.com/johng/gf/g"
  4. "gitee.com/johng/gf/g/os/gtime"
  5. "gitee.com/johng/gf/g/net/ghttp"
  6. )
  7. func main() {
  8. s := g.Server()
  9. s.BindHandler("/cookie", func(r *ghttp.Request) {
  10. datetime := r.Cookie.Get("datetime")
  11. r.Cookie.Set("datetime", gtime.Datetime())
  12. r.Response.Write("datetime:", datetime)
  13. })
  14. s.SetPort(8199)
  15. s.Run()
  16. }

执行外层的main.go,可以尝试刷新页面 http://127.0.0.1:8199/cookie ,显示的时间在一直变化。

对于控制器对象而言,从基类控制器中继承了很多会话相关的对象指针,可以看做alias,可以直接使用,他们都是指向的同一个对象:

  1. type Controller struct {
  2. Request *ghttp.Request // 请求数据对象
  3. Response *ghttp.Response // 返回数据对象(r.Response)
  4. Server *ghttp.Server // Web Server对象(r.Server)
  5. Cookie *ghttp.Cookie // COOKIE操作对象(r.Cookie)
  6. Session *ghttp.Session // SESSION操作对象
  7. View *View // 视图对象
  8. }

由于对于Web开发者来讲,Cookie都已经是非常熟悉的组件了,相关API也非常简单,这里便不再赘述。

cookie、session与localhost

大多数开发语言,或者开发框架,使用session id作为HTTP客户端的唯一访问标识,该id一般都是存放在cookie中,伴随着用户浏览器的访问流程同时在请求中传递给服务端。

在本地开发过程中,开发者往往使用localhost作为网站域名,但是该域名会对开发者造成一些混淆,主要是对于session和cookie的影响。

在容易发现的问题之中,localhost域名有时会影响到session无法保存,其实该问题归根到底是sessionid无法在浏览器客户端保存的问题,也就是cookie无法保存。因为localhost不是一个有效的域名,有效域名至少要包含两个”.”符号。不同的浏览器针对于localhost的处理方式不太一样,有的浏览器支持(如Chromium/Firefox),有的不支持(如Chrome/IE),不支持的现象就是虽然服务端返回了cookie,但是浏览器不认可,不做保存。下一次浏览器请求的时候就不会提交该cookie信息,这样cookie便设置失败了。

解决方案是建议开发者不使用localhost这种特殊的地址,改用IP地址或者自定义的本地域名(需要手动修改hosts文件),如 127.0.0.1www.local.comwww.local.test等等。