在 HTTP 标准库 中解释了 go 的标准库是如何处理请求的，但是通过源码的分析，可以发现，标准库对于这部分的处理比较简单，例如对 url 中携带参数就不支持，面对这种情况，社区中出现了大量的框架，对原有的 http 进行补充。

大部分的 Go 的 HTTP 框架都是在重写路由部分，已实现更快的更准确的路由查找，减少路由解析过程中消耗的时间，来提高框架的处理速度。

标准库 HTTP 的处理

先来回顾一下标准库的 HTTP 处理流程。

1. 启动 HTTP 服务器：使用 http.ListenAndServe 或 http.ListenAndServeTLS 函数启动 HTTP 服务器。

2. 处理请求：当服务器接收到 HTTP 请求时，它会使用与路径相对应的 http.Handler 实现处理请求。

3. 调用处理程序：服务器会调用 ServeHTTP 方法，并将请求相关的信息作为参数传递给该方法。

4. 路由匹配：在 ServeHTTP 方法中，通过比较请求的路径和已注册的路由，找到与请求匹配的路由。

5. 调用处理函数：如果找到了匹配的路由，则调用与该路由相关的处理函数。

6. 写入响应：处理函数通过 ResponseWriter 接口写入响应数据，以返回给客户端。

根据上述的处理方式，目前需要关注两个函数：ServeHTTP 和 ResponseWriter 。这是两个主要的处理方式。

http.ListenAndServe 和 http.ListenAndServeTLS 用于启动 HTTP 服务器；以及 http.ResponseWriter 和 http.Request 分别用于写入响应和处理请求。

同时通过源码分析，如果在 Listen 的时候不传入 handler， 那么就会采用 http 默认的 Handler，也就是 ServeMux ，所以只要我们按照标准实现一个 Handler，那么就会替换原有的处理逻辑，而且 Handler 的实现也是非常简单，只要实现 ServeHTTP 这个接口即可。

gin 启动

采用 gin 实现一个最简单的 ping/pong 服务。这是官方 README 提供的例子。

package main

import (
  "net/http"

  "github.com/gin-gonic/gin"
)

func main() {
  r := gin.Default()
  r.GET("/ping", func(c *gin.Context) {
    c.JSON(http.StatusOK, gin.H{
      "message": "pong",
    })
  })
  r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}

例子中实现也是非常简单，先通过 gin.Default() 生成一个 engine。 之后添加相关的处理方式，最后用 r.Run() 启动。下面将会从最开始的方法开始剖析 gin 框架。

Engine

Default 是 gin 使用的第一个函数。这个函数看起来很简单，一共就五行代码。

func Default() *Engine {
	debugPrintWARNINGDefault()
	engine := New()
	engine.Use(Logger(), Recovery())
	return engine
}

其中主要通过 New() 函数初始化 Engine 结构体。在 gin 中，通过 Engine 这个结构体进行管理，这个结构体其实是实现了 ServeHTTP 这个方法。

在这里 Engine 的功能和标准库中的 ServeMux 的地位其实是一模一样的，那么他的主要功能也就是用来保存注册的 handler，等到使用的时候进行查找调用。那么就先看看路由和 handler 是如何注册的。

注册路由

在上面的例子中， 路由和 handler 是通过 r.GET() 方法进行注册。从源码来看，可以发现不仅仅是 GET 方法，其他的请求方法也一样，都是直接调用了 group.handler 方法。

func (group *RouterGroup) handle(httpMethod, relativePath string, handlers HandlersChain) IRoutes {
	// 计算绝对路径
	absolutePath := group.calculateAbsolutePath(relativePath)
	// 合并 handler
	handlers = group.combineHandlers(handlers)
	// 添加相关路由
	group.engine.addRoute(httpMethod, absolutePath, handlers)
	return group.returnObj()
}

从代码中可以看到这个方法，其实是比较简单，从代码上的命名来看，基本进行了以下操作：先进行绝对路径的计算，之后对 handler 进行合并，最后添加路由。

为什么要 Combine

在combineHandlers方法中，首先计算了当前handlers的长度，并判断是否超过了最大长度（当前最大长度为63）。如果超过最大长度，则会引发panic异常。在这里，源代码采用了两次复制（copy）操作。第一次是将group.Handlers中的数据复制到mergedHandlers中，第二次是将handlers的数据传入mergedHandlers中。

func (group *RouterGroup) combineHandlers(handlers HandlersChain) HandlersChain {
	finalSize := len(group.Handlers) + len(handlers)
	// ...
	mergedHandlers := make(HandlersChain, finalSize)
	copy(mergedHandlers, group.Handlers)
	copy(mergedHandlers[len(group.Handlers):], handlers)
	// ...
}

这样 mergeHandler 中就存在两部分数据， handlers 可以通过源码看出来是在项目中注册的 handler，那么 group.Handlers 中又是什么呢？

其实就是在项目启动的时候注册的中间件。在 Engine 中的 Default 方法可以看到，engine.Use(Logger(), Recovery()) 项目在初始化的时候注册了两个中间件，而这个 Use 方法，其实就是将中间件添加到上面的 group.Handlers 中，这里不多赘述，只是简单的说明一下，具体的中间件的流程会在 中间件(Middleware) 章节讲述。

确切地说，mergeHandlers的目的是将中间件和用户定义的处理函数合并为一个处理函数切片，并按照一定的顺序注册到路由中。

添加路由

路由添加方法也比较简单，核心代码一共就 6 行。

root := engine.trees.get(method)
if root == nil {
  root = new(node)
  root.fullPath = "/"
  engine.trees = append(engine.trees, methodTree{method: method, root: root})
}
root.addRoute(path, handlers)

先通过请求方法获取树的根节点，如果根节点不存在就创建一个，最后添加相关的路由和 handlers。这里关于路由如何添加，路由数据结构在路由(Router)章节会进行讲解。

直到目前，路由的注册工作已经完成。

如何Run

在之前详细的了解过 go 的 net/http 包中是如何启动一个 http 服务之后，其实现在回过头来看 gin，其实一切变得很简单。

在 gin 的 Run 方法中，主要通过标准库的 http.ListenAndServe 方法启动，而这个方法在 HTTP 标准库中有过详细的分析 ，剩下的方法流程和标准库中的流程基本一致，唯独不同的一点是将原有的默认 Handler 换成了 gin.Handler。

在之前说过，要想成为一个 Handler，只要实现 ServeHTTP 方法即可，而 gin 的 engine 就实现了这个方法。

根据之前对 http 了解的处理流程来看，在 gin 收到相关的请求，都会统一调用 ServeHTTP 方法，该方法会将接收到的参数等进行处理，例如寻找合适的处理器（Handler），最后返回统一的处理结果。

// ServeHTTP conforms to the http.Handler interface.
func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
	c := engine.pool.Get().(*Context)
	c.writermem.reset(w)
	c.Request = req
	c.reset()
	engine.handleHTTPRequest(c)
	engine.pool.Put(c)
}

首先使用到的变量有 pool。这里的 pool 使用的 sync.Pool 这个类型，主要是用来重复使用的 Context。这里直接从 pool 中取出 Context，并对 Context 的一些参数进行设置，最后调用 engine.handleHTTPRequest 方法。

这也是目前常常使用

engine.handleHTTPRequest 这个方法主要处理用户的 HTTP 请求，确定该请求的处理方法。简单的来说就：首先，获取请求的 HTTP 方法（如 GET 或 POST）和 URL 路径，并在需要时解码路径。然后，它搜索匹配该请求的处理树。如果找到了一个匹配的节点，它会将处理程序分配给请求的上下文（c），并写入 HTTP 响应头。如果未找到匹配的节点，则会通过 serverError 写入 “405 Method Not Allowed” 或 “404 Not Found” 的错误响应。

这样基本就是一个简单的 http 请求的处理过程。在代码中可以看到很多事情其实是由上下文 (Context) 进行处理的。

前言

Go 语言以其出色的并发性能和优雅的编程模型而闻名，对于 http 服务可以做到开箱即用，无需第三方框架，而且使用起来也很简单。即便如此，还会有很多 http 框架的诞生，例如 gin，echo 等，说明自带的 http 服务还有不完美的地方，导致了用户选择第三方开发的框架。

这是一个采用标准库开发的 http 服务。

package main

import "net/http"

func main() {
	http.HandleFunc("/ping", pingHandler)
	http.ListenAndServe(":8000", nil)
}

func pingHandler(w http.ResponseWriter, r *http.Request) {
	w.Write([]byte("pong"))
}

这是一个简单的HTTP服务。在启动服务后，通过访问 http://localhost:8000/ping，可以访问相关的处理程序并返回响应信息：“pong”。

这段简单的代码中，直接运行了一个高性能的HTTP服务。代码中涉及了两个与HTTP相关的函数，分别是：http.HandleFunc和http.ListenAndServe。

接下来，对这两个函数进行解析，让您了解每个步骤的具体操作。

路由注册

HandleFunc函数的作用是将指定的处理函数handle注册到HTTP框架中，使得特定的URL路径和该处理函数建立映射关系。

以下是HandleFunc()函数的源代码实现

func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
	DefaultServeMux.HandleFunc(pattern, handler)
}

在这段代码中，HandleFunc函数接收两个参数：pattern和handle。pattern是URL路径的模式，用于匹配请求的URL；handle是处理函数，接收ResponseWriter和Request作为参数，用于处理请求并生成相应的响应。

函数内部调用了DefaultServeMux.HandleFunc()函数，将pattern和handle注册到默认的 ServeMux（多路复用器）中，建立URL和处理函数之间的映射关系。

func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
	if handler == nil {
		panic("http: nil handler")
	}
	mux.Handle(pattern, HandlerFunc(handler))
}

HandleFunc函数是ServeMux类型的方法。ServeMux是一个HTTP请求多路复用器，用于将请求路由到相应的处理程序。在这个方法中，我们传入了一个pattern参数和一个handler函数参数。

type HandlerFunc func(ResponseWriter, *Request)

// ServeHTTP calls f(w, r).
func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
	f(w, r)
}

HandlerFunc 的定义很简单，并且实现了 ServeHTTP 方法。这个方法主要是调用本身。

mux.Handler实现同样比较简单，可以看到将路由(pattern)和具体实现(handler)注册到 DefaultServeMux 这个对象上。通过不断的往下看源码，可以找到 ServeMux.Handler 这个方法上。这个方法主要是将服务中的路由进行注册。将服务注册到 ServerMux 对象上，也就是上文所提到的 DefaultServeMux。

对于 ServeMux 来说，是一个比较简单的结构。其中可以看到 m 和 es 保存了路由

var DefaultServeMux = &defaultServeMux
var defaultServeMux ServeMux

type ServeMux struct {
	mu    sync.RWMutex
	m     map[string]muxEntry
	es    []muxEntry
	hosts bool
}

type muxEntry struct {
	h       Handler
	pattern string
}

func (mux *ServeMux) Handle(pattern string, handler Handler) {
	// 省略代码 ...
	if mux.m == nil {
		mux.m = make(map[string]muxEntry)
	}
	e := muxEntry{h: handler, pattern: pattern}
	mux.m[pattern] = e
	if pattern[len(pattern)-1] == '/' {
		mux.es = appendSorted(mux.es, e)
	}

	if pattern[0] != '/' {
		mux.hosts = true
	}
}

如果 ServerMux.m 为空，会进行初始化，之后将 handler 和 pattern 存放到 muxEntry 中，最后将 muxEntry 存放到 m 中，m 的 key 是 pattern。这里的 pattern 就是 url 路径。

在 ServeMux 中，mux.es 切片是用来保存以斜杠结尾的路由模式对应的 muxEntry 对象的。它的作用是在请求的 URL 中去掉末尾的斜杠后进行匹配，从而避免重复处理类似 /path 和 /path/ 这样的 URL。

例如，如果有两个路由模式分别为 /path 和 /path/，请求的 URL 为 /path/，如果没有 mux.es 切片，将会尝试匹配 /path 和 /path/ 两个路由模式，最终会选择匹配 /path/ 的路由模式进行处理。这会导致处理器被重复调用。而使用 mux.es 切片，请求的 URL 会被处理为 /path，只会匹配到 /path 这一个路由模式，避免了处理器被重复调用的问题。

因此，mux.es 切片的作用是为了提高 ServeMux 的匹配效率，避免重复处理请求。

所有的 url 和 Handler 的映射关系都是通过 map[string]muxEntry 进行保存。这样就会出现问题，稍微复杂一些的 url 就无法很好的匹配。这也就是为什么会有大量的 go web 框架，而这些框架都是改写路由的匹配算法。

关于 DefaultServeMux 是一个实现了 HandlerServe 接口的结构体。

上面就是一个主要的注册过程。

ListenAndServe

这个方法主要对端口进行监听。

func ListenAndServe(addr string, handler Handler) error {
	server := &Server{Addr: addr, Handler: handler}
	return server.ListenAndServe()
}

从源码可以看到，这里需要一个 handler 参数，并且新生成一个 server 对象。通过调用 ListenAndServe 方法进行处理。

func (srv *Server) ListenAndServe() error {
	if srv.shuttingDown() {
		return ErrServerClosed
	}
	addr := srv.Addr
	if addr == "" {
		addr = ":http"
	}
	ln, err := net.Listen("tcp", addr)
	if err != nil {
		return err
	}
	return srv.Serve(ln)
}

在 ListenAndServe 中，首先对服务的状态进行了判断，如果是 shuttingDown 就提示 http: Server closed。这里的 shuttingDown 主要是通过一个叫 atomicBool 进行判断的。咋一看以为是原子操作，仔细看其实是定义了一个 int32 类型，通过 int32 的原子操作保证了并发安全。

type atomicBool int32

func (b *atomicBool) isSet() bool { return atomic.LoadInt32((*int32)(b)) != 0 }
func (b *atomicBool) setTrue()    { atomic.StoreInt32((*int32)(b), 1) }
func (b *atomicBool) setFalse()   { atomic.StoreInt32((*int32)(b), 0) }

之后通过 net.Listen() 方法进行监听，这里对这个方法不做过多的赘述，之后通过 Serve 方法。 下面是主要的核心方法

ctx := context.WithValue(baseCtx, ServerContextKey, srv)
for {
	rw, err := l.Accept()
	if err != nil {
		select {
		case <-srv.getDoneChan():
			return ErrServerClosed
		default:
		}
		if ne, ok := err.(net.Error); ok && ne.Temporary() {
			if tempDelay == 0 {
				tempDelay = 5 * time.Millisecond
			} else {
				tempDelay *= 2
			}
			if max := 1 * time.Second; tempDelay > max {
				tempDelay = max
			}
			srv.logf("http: Accept error: %v; retrying in %v", err, tempDelay)
			time.Sleep(tempDelay)
			continue
		}
		return err
	}
	connCtx := ctx
	if cc := srv.ConnContext; cc != nil {
		connCtx = cc(connCtx, rw)
		if connCtx == nil {
			panic("ConnContext returned nil")
		}
	}
	tempDelay = 0
	c := srv.newConn(rw)
	c.setState(c.rwc, StateNew, runHooks) // before Serve can return
	go c.serve(connCtx)
}

l 为 net.Listener 对象，当每次接收到信息的时候，首先会进行一个错误判断。 如果是 down 的信号，就会直接返回相关错误，否则先对错误进行断言，检查是否为 net.Error，这个是一个接口，其中 Temporary 方法官方已经标记为启用，这个方法更多的表示为超时。如果有超时，你们就会对延时 tempDelay，进行增加，起初是 5 毫秒，之后每次增加 2 倍，最大为 1 秒钟，之后会进行重试。

通过 srv.ConnContext 会生成一个新的 ctx，否则就使用之前的 ctx，也就是 context.Backgroud()。然后开启一个协程进行服务。

在协程中，通过 readRequest 方法进行获取，返回 response。通过 response 对象获取 request。通过 request 判断请求是否要继续。

req := w.req
if req.expectsContinue() {
	if req.ProtoAtLeast(1, 1) && req.ContentLength != 0 {
		req.Body = &expectContinueReader{readCloser: req.Body, resp: w}
		w.canWriteContinue.Store(true)
	}
} else if req.Header.get("Expect") != "" {
	w.sendExpectationFailed()
	return
}

这里判断首先通过 expectsContinue 方法，这个方法中获取请求头中的 Expect 字段是否等于 100-continue。当等于的时候要继续进行判断，其中请求的协议为 HTTP 1.1 和 ContentLength 不为 0。这样就可以获取到请求体。

当请求头中的 Expect 和上述条件不相同的时候，直接返回 417 错误。

之后创建了一个 serverHandler 并且调用了 ServeHTTP 并且传入了 response 和 request。

ServeHTTP 再一次出现，其中第一步就是获取 Handler。

handler := sh.srv.Handler
if handler == nil {
	handler = DefaultServeMux
}

那么，这里获取的 handler 应该是什么呢？经过多个方法或函数，可以已经对 sh.srv.Handler 一步一步的向上推到。这里我将这个过程画了一张图，图上箭头表示关系之间的依赖，红色表示持有 handler 数据。

通过这个依赖图可以看到，handler 是由最开始的 ListenAndServe 方法进行传入的，而我们的示例代码中这部分传入的是 nil，也就是从开始到现在 handler 一直为 nil。这也就是为什么会一个判断，当 handler 为空的时候使用 DefaultServeMux。其实关于默认的 handler 为 DefaultServeMux 这个事情，在 ListenAndServe 这个代码的注释中就已经说明。

之后就是调用 handler.ServeHTTP 方法，ServeHTTP 方法主要是一个请求分发的作用。源码中调用了 Handler 方法。这个方法主要的作用就是查找请求对应的 Handler 是那个。

// ServeHTTP dispatches the request to the handler whose
// pattern most closely matches the request URL.
func (mux *ServeMux) ServeHTTP(w ResponseWriter, r *Request) {
	if r.RequestURI == "*" {
		if r.ProtoAtLeast(1, 1) {
			w.Header().Set("Connection", "close")
		}
		w.WriteHeader(StatusBadRequest)
		return
	}
	h, _ := mux.Handler(r)
	h.ServeHTTP(w, r)
}

先对方法为 CONNECT 的请求做了处理。通过 redirecToPathSlash 方法，这个方法主要是要判断给定的路径是否要加 /，而这个方法中加锁后调用了 shouldRedirectRLocked 这个方法。通过查找 ServeMux 的 m 这个属性中是否存在相关的路径。这个 m 在上文中介绍过，是一个 map 结构。这也就是为什么会加锁，这里的 map 是并发不安全的。查询的方式也很简单，就是在之前的 map 中查询是否存在，如果存在就返回 false，如果没有找到会进行一些特殊的处理，在路径上加上后缀 / 进行查找，同时为了防止路径为 //，所以在返回的时候又进行了一次判断。

在上述的方法结束后，会返回一个 bool 值，来确定是否需要添加末尾的 /。从而返回相关的 url。通过新的 url 生成一个 RedirectHandler 的结构体。如果没有找到通过 通过 handler 这个方法。

handler 这个方法通过 match 这个方法进行查找。

func (mux *ServeMux) match(path string) (h Handler, pattern string) {
	v, ok := mux.m[path]
	if ok {
		return v.h, v.pattern
	}

	for _, e := range mux.es {
		if strings.HasPrefix(path, e.pattern) {
			return e.h, e.pattern
		}
	}
	return nil, ""
}

这个方法比较简单，现在 m 中进行查找，如果没有找到，从 es 中查找。之前我们说过 es 是保存了后缀有 / 的 handler。如果都无法查找到就返回 nil。

这里的 handler 就是在一开始注册的 HandleFunc(pingHandler) 。

最后在 ServeMux.ServeHTTP 这个方法中调用 handler 相关的 ServeHTTP。这样就调用成功了。

总结

通过两个方法基本可以做到路由的注册方式和路由的查询方式，并且对请求来临的时候相关的处理过程。这些方法对之后研究其他框架源码或者工作方式更加清晰。

👻交叉编译

什么是交叉编译呢？交叉编辑简单的说就是一个平台生成另一个平台的可执行程序。我们大部分开发环境是 windows 或者 macOS ，当然也有使用 linux 用户(其实在 windows 上更加推荐使用 WSL 进行开发)，而我们的上线服务器一般都是 linux，所以我们要进行项目的交叉编译。Go 中对交叉编译相对简单，我们只需要进行简单的设置即可完成交叉编译。

打开我们的项目根目录，打开终端，设置 GOOS 和 GOARCH。

在 windows 下编译为 linux 程序。

SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build -o out/linux/gin_hello .

这里的 go build -o out/linux/gin_hello 是指将编译后的文件输出到 out/linux 下，编译后的二进制叫做 gin_hello 。

我将命令写到了 .bat 方便处理，不用每次都执行贴一下这几行命令。

在项目根目录下新建立 build.bat ，然后执行该文件。当然，很多工程或者项目使用 Makefile 进行的编译

SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build -o out/linux/gin_hello .
exit

执行完该文件就会在 out/linux 下出现 gin_hello

这里我们便完成了交叉编译，编译后的程序是 linux 下的可执行文件。

🐳安装 Dokcer

这里使用的操作系统为 centos 7 ，安装前要更新一下软件源 sudo yum update ，之后对 Docker 软件源进行添加。

sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

再次更新一下软件源 sudo yum update ，最后就可以安装我们的 docker 了

sudo yum install docker-ce

添加到开机启动

sudo systemctl enable docker

启动Docker

sudo systemctl start docker

此时，我们的 Docker 已经完成安装。但是我们还需要为我们的 Docker 设置远程连接，让我们本地开发可以连接到服务器。

🚫警告 下面的方法仅仅是为了教程演示 请勿在生成环境中使用该方法，该方法存在缺陷，使 Docker 端口暴漏在公网环境中，任何人都可以在Docker进行部署。如果需要生产环境中打开远程端口，需要配置权限认证方式，这里不过多做介绍

在 Centos 7 中，进行对下面的文件进行编辑

vim /usr/lib/systemd/system/docker.service

找到 ExecStart 开头的进行如下添加和修改。

ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H unix://var/run/docker.sock -H fd:// --containerd=/run/containerd/containerd.sock

此时，重启服务器或者重新启动 Docker 就完成了 Docker 的远程连接。

🐬安装数据库

首先我们要在 dockers 上进行 数据库 MySQL 的安装。首先在执行我们的搜索命令，看看能不能找到MySQL 相关的信息 docker search mysql 。

确认可以查找到 MySQL 后，就可以完成 MySQL 进行的拉取 ，通过命令 docker pull mysql 拉取 MySQL 镜像。此时并没有指定 MySQL 的版本，会给我们拉取最新的 MySQL 版本。

拉取完毕，通过 docker iamges 查看当前所有的镜像，这里我们只有一个 MySQL 。

我已经对 MySQL 镜像进行了获取，那么接下来就是通过镜像创建容器。

docker run -p 3306:3306 --name mysql -e MYSQL_ROOT_PASSWORD=1234 -d mysql

此时我们的 MySQL 容器就创建成功，并且启动完成，而且我们制定了 MySQL 的密码为 1234，端口为 3306。

docker exec -it mysql /bin/bash

我们为 MySQL 指定一个终端，来进行数据库的创建。

输入 mysql -u root -p 回车后输入密码 1234,进入数据库。输入 create database ginhello 和我们本地数据库名称一致。

这样，我们在服务器上的操作就完成了。

🔗Goland 连接 Docker，并部署项目

首先我们要对我们的代码进行简单的修改，之前我们一直是 DEBUG 模式在运行项目，而现在我们要正式上线了，需要修改我们的启动模式，在 main.go 中进行添加。

gin.SetMode(gin.ReleaseMode)

此时就可以执行我们的交叉编译时候写的脚本 build.bat，会生成新的 linux 可执行文件。

新建 Dockerfile，编写 Dockerfile

FROM alpine

WORKDIR /web/gin

COPY ./out/linux/. .

CMD ./gin_hello

简单的说一下这些含义，拉取一个 alpine 的镜像，这基本是最小的 linux , 指定我们的 WORKDIR, 将我们生成的 linux 可执行程序复制到 WORKDIR 下，运行项目。

当然这些还不够，当我们编写完成该文件的时候，在第一行会出现运行按钮。

单击运行按钮，选择 Edit ‘Dockerfile’

会出现下面的界面。点击 ① 处的省略号，出现旁边的界面，进行 Docker 的配置，在 ② 处填写我们的 IP 端口为 2375 设置完成后，等待，看看 ③ 处是否有 Connection successful 。否者链接失败，查看上述步骤是否出错。完成后点击 OK。

完成 Docker 的配置，接着完成端口映射。

Host port 表示宿主主机端口，就是我们的服务器端口，而 Container port 表示我们的 容器的端口。因为 gin 项目运行在容器内，且启动端口为 8080，我们通过端口映射，访问宿主主机 80 端口，而映射到 8080 端口。

完成上述设置，就可以点击启动我们的 Dockerfile。

我们可以在 Goland 的 Service 中找到当前进度。

等待完成，打开服务器公网IP。

可以看到我们之前写的代码。

此时我们就完成了部署。

✍总结

通过本章节的 交叉编译，Docker 安装，Docker 镜像安装和启动容器，部署 Gin 项目，完成了一个项目通过 Docker上线部署的过程。

👨‍💻本章节代码

本章节代码可以使用之前任何一个章节代码，但是这里还是进行了代码的上传，包含本章节使用的 Dockerfile 和 build.bat

Github

🔑什么是 JWT

JWT 的全称叫做 JSON WEB TOKEN，在目前前后端系统中使用较多。

JWT 构成

JWT 是由三段构成的。分别是 HEADER，PAYLOAD，VERIFY SIGNATURE，它们生成的信息通过 . 分割。

HEADER

header 是由 一个 typ 和 alg 组成，typ 会指明为 JWT，而 alg 是所使用的加密算法。

{
  "alg": "HS256",
  "typ": "JWT"
}

PAYLOAD

payload 是 JWT 的载体，也就是我们要承载的信息。这段信息是我们可以自定义的，可以定义我们要存放什么信息，那些字段。该部分信息不宜过多，它会影响 JWT 生成的大小，还有就是请勿将敏感数据存入该部分，该端数据前端是可以解析获取 token 内信息的。

官方给了七个默认字段，我们可以不全部使用，也可以加入我们需要的字段。

VERIFY SIGNATURE

这也是 JWT 的最后一段，该部分是由算法计算完成的。

对刚刚的 header 进行 base64Url 编码，对 payload 进行 base64Url 编码，两端完成编码后通过 . 进行连接起来。

base64UrlEncode(header).base64UrlEncode(payload)

完成上述步骤后，就要通过我们 header 里指定的加密算法对上部分进行加密，同时我们还要插入我们的一个密钥，来确保我的 JWT 签发是安全的。

这便是我们的第三部分。

当三部分都完成后，通过使用 . 将三部分分割，生成了上图所示的 JWT 。

JWT 登录原理

简单的说就是当用户登录的时候，服务器校验登录名称和密码是否正确，正确的话，会生成 JWT 返回给客户端。客户端获取到 JWT 后要进行保存，之后的每次请求都会讲 JWT 携带在头部，每次服务器都会获取头部的 JWT 是否正确，如果正确则正确执行该请求，否者验证失败，重新登录。

🔒Gin 生成 JWT

go 语言的 JWT 库有很多。jwt.io 上也给出了很多 。这里使用 jwt-go

"github.com/dgrijalva/jwt-go"

我们对登录方法进行改造。

// 省略代码
expiresTime := time.Now().Unix() + int64(config.OneDayOfHours)
claims := jwt.StandardClaims{
    Audience:  user.Username,     // 受众
    ExpiresAt: expiresTime,       // 失效时间
    Id:        string(user.ID),   // 编号
    IssuedAt:  time.Now().Unix(), // 签发时间
    Issuer:    "gin hello",       // 签发人
    NotBefore: time.Now().Unix(), // 生效时间
    Subject:   "login",           // 主题
}
var jwtSecret = []byte(config.Secret)
tokenClaims := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
// 省略代码

这里的 config.OneDayOfHours 设定了过期时间，这里设定了一天。通过 StandardClaims 生成标准的载体，也就是上文提到的七个字段，其中 编号设定为 用户 id。其中的 jwtSecret 是我们设定的密钥，

我们这里通过 HS256 算法生成 tokenClaims ,这就是我们的 HEADER 部分和 PAYLOAD。

token, err := tokenClaims.SignedString(jwtSecret)

这样便生成了我们的 token 。我们要将我们的 token 和 Bearer 拼接在一起，同时中间用空格隔开。

token =  "Bearer "+ token

生成 Bearer Token 。

当我们用户进行登录的时候，就可以通过该片段生成 JWT。

下面是完整代码：

func CreateJwt(ctx *gin.Context) {
	// 获取用户
	user := &model.User{}
	result := &model.Result{
		Code:    200,
		Message: "登录成功",
		Data:    nil,
	}
	if e := ctx.BindJSON(&user); e != nil {
		result.Message = "数据绑定失败"
		result.Code = http.StatusUnauthorized
		ctx.JSON(http.StatusUnauthorized, gin.H{
			"result": result,
		})
	}
	u := user.QueryByUsername()
	if u.Password == user.Password {
		expiresTime := time.Now().Unix() + int64(config.OneDayOfHours)
		claims := jwt.StandardClaims{
			Audience:  user.Username,     // 受众
			ExpiresAt: expiresTime,       // 失效时间
			Id:        string(user.ID),   // 编号
			IssuedAt:  time.Now().Unix(), // 签发时间
			Issuer:    "gin hello",       // 签发人
			NotBefore: time.Now().Unix(), // 生效时间
			Subject:   "login",           // 主题
		}
		var jwtSecret = []byte(config.Secret)
		tokenClaims := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
		if token, err := tokenClaims.SignedString(jwtSecret); err == nil {
			result.Message = "登录成功"
			result.Data = "Bearer " + token
			result.Code = http.StatusOK
			ctx.JSON(result.Code, gin.H{
				"result": result,
			})
		} else {
			result.Message = "登录失败"
			result.Code = http.StatusOK
			ctx.JSON(result.Code, gin.H{
				"result": result,
			})
		}
	} else {
		result.Message = "登录失败"
		result.Code = http.StatusOK
		ctx.JSON(result.Code, gin.H{
			"result": result,
		})
	}
}

通过 .http 请求测试，结果如下

{
  "result": {
    "code": 200,
    "message": "登录成功",
    "data": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxMjMiLCJleHAiOjE1NjQ3OTY0MzksImp0aSI6Ilx1MDAwMCIsImlhdCI6MTU2NDc5NjQxOSwiaXNzIjoiZ2luIGhlbGxvIiwibmJmIjoxNTY0Nzk2NDE5LCJzdWIiOiJsb2dpbiJ9.CpacmfBSMgmK2TgrT-KwNB60bsvwgyryGQ0pWZr8laU"
  }
}

这个便完成了token的生成。

🔐Gin 校验 Token

那么，接下来就需要完成 token 的验证。

还记得之前我们验证用户是否授权采用的办法吗？是的，在中间件里查看用户 cookie。同样的方法，我们这里校验用户 JWT 是否有效。

编写我们的中间件。

新建立 middleware/Auth.go

首先先编写我们的解析 token 方法，parseToken()

func parseToken(token string) (*jwt.StandardClaims, error) {
	jwtToken, err := jwt.ParseWithClaims(token, &jwt.StandardClaims{}, func(token *jwt.Token) (i interface{}, e error) {
		return []byte(config.Secret), nil
	})
	if err == nil && jwtToken != nil {
		if claim, ok := jwtToken.Claims.(*jwt.StandardClaims); ok && jwtToken.Valid {
			return claim, nil
		}
	}
	return nil, err
}

通过传入我们的 token , 来对 token 进行解析。

完整的中间件代码

func Auth() gin.HandlerFunc {
	return func(context *gin.Context) {
		result := model.Result{
			Code:    http.StatusUnauthorized,
			Message: "无法认证，重新登录",
			Data:    nil,
		}
		auth := context.Request.Header.Get("Authorization")
		if len(auth) == 0 {
			context.Abort()
			context.JSON(http.StatusUnauthorized, gin.H{
				"result": result,
			})
		}
		auth = strings.Fields(auth)[1]
		// 校验token
		_, err := parseToken(auth)
		if err != nil {
			context.Abort()
			result.Message = "token 过期" + err.Error()
			context.JSON(http.StatusUnauthorized, gin.H{
				"result": result,
			})
		} else {
			println("token 正确")
		}
		context.Next()
	}
}

首先在请求头获取 token ,然后对先把 token 进行解析，将 Bearer 和 JWT 拆分出来，将 JWT 进行校验。

我们只需要对我们需要校验的路由进行添加中间件校验即可。

	router.GET("/", middleware.Auth(), func(context *gin.Context) {
		context.JSON(http.StatusOK, time.Now().Unix())
	})

当我们访问 / 的时候就需要携带 token 了

GET http://localhost:8080
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxMjMiLCJleHAiOjE1NjQ3OTQzNjIsImp0aSI6Ilx1MDAwMCIsImlhdCI6MTU2NDc5NDM0MiwiaXNzIjoiZ2luIGhlbGxvIiwibmJmIjoxNTY0Nzk0MzQyLCJzdWIiOiJsb2dpbiJ9.uQxGMsftyVFtYIGwQVm1QB2djw-uMfDbw81E5LMjliU

✍总结

本章节对什么是 JWT，Gin 中如何使用 JWT 做了介绍。但是不要过于迷信 JWT，JWT 还有很多问题，比如说 JWT 失效只能是时间过期，如果修改密码或者账户注销等操作需要我们另外添加逻辑判断。适合的地方选用适合的技术才能发挥最大的优势。

👨‍💻本章节代码

Github

🥨gorm

gorm 是 Go 语言中比较知名的 orm 框架之一，在 Github 上的有 14.6 K stars。gorm 对于常见的功能基本都已实现。 在 gin 中添加 gorm 是非常简单的。

首先打开我们的 initDB 文件夹。 将原来 sql.Open 改为 gorm.Open 同时引入 gorm , 同时对 Db 的定义类型进行更改，*gorm.DB 。 具体代码如下:

package initDB

import (
	_ "github.com/go-sql-driver/mysql"
	"github.com/jinzhu/gorm"
	_ "github.com/jinzhu/gorm/dialects/mysql"
	"log"
)

var Db *gorm.DB

func init() {
	var err error
	Db, err = gorm.Open("mysql", "root:1234@tcp(127.0.0.1:3306)/ginhello")
	if err != nil {
		log.Panicln("err:", err.Error())
	}
}

此时我们的对框架的引入就已经完成了。

因为我们将 Db 的属性进行了修改，此时的 article.go 中出现了错误。

所以我们修改，利用 gorm 的 api 来进行。

🍗实现增删改查

增加

增加方法，之前使用 SQL 语言来实现添加的，如下:

result, e := initDB.Db.Exec("insert into ` article` (type, content) values (?, ?);", article.Type, article.Content)

现在我们要通过框架来实现这一个过程。

create := initDB.Db.Create(&article)

是不是很简单了？

查询单个

通过 article.Id 传入限制条件，该方法仅仅是用于 主键为 int 类型时。

initDB.Db.First(&article, article.Id)
return article

查询所有

var articles []Article
initDB.Db.Find(&articles)
return articles

删除

initDB.Db.Delete(article)

通过以上的一些方法可以看出来，基本对之前的增删改查代码有了极大的缩短，大大的减少了错误的发生。

此时就可以运行我们的代码，通过 .http 也好，通过单元测试也好，但是一运行就会报错。报错如下：

Error 1146: Table 'ginhello.articles' doesn't exist 

说在 ginhello 库中并没有 articles 表。 这句话说的没有毛病啊，我们的确没有 articles 表，我们建立的是 article 表。

原来 gorm 在对应的结构体默认会加个 s，所以我们现在有两个办法，第一个就是改表明，但是表明往往是不可以随便修改的。第二个是修改代码，让它之道我们要找的表为 article 而不是 articles。

func (article Article) TableName() string {
	return "article"
}

实现该接口，该接口返回一个字符串，通过字符串来定义我们需要关联的表。

此时再次运行我们的代码，发现功能可以完整的使用，并且没有报错。

🚥自动建表

加入现在是一个新的项目，还没有建立数据库表，或者项目迁移到另一个环境，环境上还没有数据库表，怎么办？

gorm 给我们提供了建立数据库表的功能。

我们新建立一个 model 叫做 comment ，管理评论。

package model

type Comment struct {
	ID      int
	content string
}

这里的 ID 要全部进行大写。

建立好结构体后就可以对结构体进行建立对应的数据库表。

对于建表 我们首要检查一下表是否存在，如果存在就不需要重新建立了，不能每次运行项目就把之前的数据覆盖掉。

func init() {
	table := initDB.Db.HasTable(Comment{})
	if !table {
		initDB.Db.CreateTable(Comment{})
	}
}

运行我们的项目就会发现数据库中已经新建立了表，如果我们想在建立的时候同时为 id 建立索引，我们可以对结构体 tag 上标明。如下

type Comment struct {
	ID      int `gorm:"index:idx_id"`
	Content string
}

将刚刚建立的表删除掉，重新运行代码。数据库表中会添加 idx_id 索引。

⚓gorm model 的使用

我们在建立数据库的时候，每个表都会建立主键 ID ，如果你读过 阿里巴巴 Java 开发规范 的话，还应该知道一些其他的必要信息，比如说创建时间，修改时间等。

此时 gorm model 就起到了作用，他已经给我们封装了一下属性。

我们需要将结构体改为下面的样子

type Comment struct {
	gorm.Model
	Content string
}

删除了之前的表结构，重新运行项目，此时就会生成新的表结构。

✍总结

通过本章节的简答学习，基本可以将 gorm 融入到我们的 gin 项目中，并且操作数据库，极大的减少了我们的代码量。如果有时间的话，后期可能会专门出一起 gorm 的使用介绍。

👨‍💻本章节代码

Github

所以说文档成了开发心中的一个痛。尤其是使用 restful 接口，成了必须要写文档，否者前端同学根本不知道你写了什么。那么让我写文档，还不如杀了我呢！！！

接下来介绍一款神器 — swagger

📜什么是swagger

Swagger 是一个 API 生成工具，可以生成文档。 Swagger 是通过编写 yaml 和 json 来实现文档化。并且可以进行测试等工作。

通过 swagger 可以方便的生成接口文档，方便前端进行查看和测试。

🔧安装 swagger

上面说了一堆 swagger 怎么样，说到头还是要自己编写？其实并不是的，让我们的项目中集成 swagger，以后项目的接口文档便可以自动生成。

首先要安装 swagger 。

go get -u github.com/swaggo/swag/cmd/swag

等待安装完成，在我们的终端中执行 swag init，目录为根目录，于 main.go 同目录。

执行完成后，会在根目录下新建一个 docs 文件夹。

docs
|
|-docs.go
|-swagger.json
|-swagger.yaml

接下来就可以完善项目了。

将下面两行放入 initRouter 中的 import 中。

swaggerFiles "github.com/swaggo/files"
ginSwagger "github.com/swaggo/gin-swagger"

选择 Sync packages of GinHello,此时 IDE 就会自动帮我下载，并添加到 go.mod 中。

如果这里提示下载失败，请对 go mod 添加代理。

添加代理 File-Setting-Go-Go Modules(vgo)-Proxy
代理添加 https://mirrors.aliyun.com/goproxy/ 这是最近阿里建立的 go mod 镜像。当然你也可以选择其他镜像代理。

等待包下载完成。

🍔集成 swagger

对 swagger 安装完成后，我们就可以对项目进行集成了。

在 initRouter 中添加路由，这个路由是对 swagger 的访问地址来进行添加的

url := ginSwagger.URL("http://localhost:8080/swagger/doc.json")
router.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, url))

其中 url 定义了 swagger 的 doc.json 路径，我们可以直接访问该 json 来进行查看。

接下来就是完善文档的时间。

在 main.go 中 main 方法上添加注释。同时引入我们生成 docs.go

package main

import (
	_ "GinHello/docs"
	"GinHello/initRouter"
)

// @title Gin swagger
// @version 1.0
// @description Gin swagger 示例项目

// @contact.name youngxhu
// @contact.url https://youngxhui.top
// @contact.email youngxhui@g mail.com

// @license.name Apache 2.0
// @license.url http://www.apache.org/licenses/LICENSE-2.0.html

// @host localhost:8080
func main() {
    // 省略其他代码
}

上述的注释基本都是很好理解的，不做过多解释。

主要的项目介绍注释就是这些，接下来进行我们的接口方法注释。

在我们的 handler 中添加注释

打开 articleHandler.go ,在 Insert 方法上添加。

// @Summary 提交新的文章内容
// @Id 1
// @Tags 文章
// @version 1.0
// @Accept application/x-json-stream
// @Param article body model.Article true "文章"
// @Success 200 object model.Result 成功后返回值
// @Failure 409 object model.Result 添加失败
// @Router /article [post]

• @Summary 是对该接口的一个描述
• @Id 是一个全局标识符，所有的接口文档中 Id 不能标注
• @Tags 是对接口的标注，同一个 tag 为一组，这样方便我们整理接口
• @Version 表明该接口的版本
• @Accept 表示该该请求的请求类型
• @Param 表示参数 分别有以下参数 参数名词 参数类型 数据类型 是否必须 注释 属性(可选参数),参数之间用空格隔开。
• @Success 表示请求成功后返回，它有以下参数 请求返回状态码，参数类型，数据类型，注释
• @Failure 请求失败后返回，参数同上
• @Router 该函数定义了请求路由并且包含路由的请求方式。

具体参数类型，数据类型等可以查看官方文档

其中文档中没有说明的地方这里说明一下，关于 Param 的参数类型有以下几种

• query 形如 \user?username=Jack&age=18
• body 需要将数据放到 body 中进行请求
• path 形如 \user\1

不同的参数类型对应的不同请求，请对应使用。

这样我们就完成了添加接口的文档注释。

我们用通用的方法来完善一下根据 id 查询数据的接口文档。

在 GetOne 的方法上添加如上注释。

// @Summary 通过文章 id 获取单个文章内容
// @version 1.0
// @Accept application/x-json-stream
// @Param id path int true "id"
// @Success 200 object model.Result 成功后返回值
// @Router /article/{id} [get]

我们对形如 /article/:id 的接口，最后的 id 通过 {} 包裹。

细心的小伙伴可能会发现我们最后的返回结果为 model.Result ，这是为了我们统一返回结果而新建的一个结构体，方便前端进行解析。具体函数如下

package model

type Result struct {
	Code    int         `json:"code" example:"000"`
	Message string      `json:"message" example:"请求信息"`
	Data    interface{} `json:"data" `
}

我们在对 Result 中的 tag 会有 example ,这个仍旧是 swagger 的标签，用来给该结构体一个示例。

同理，我们可以对之前的 article 进行注释。

当我们完成了所有的代码注释时，在控制台中重新执行 swag init，它会根据我们的注释生成 docs.go 及其对应的 json 和 yaml 文件。

启动我们的项目，访问 hppt://localhost:8080/swagger/index.html 就可以查看我们的文档,效果如下

✍总结

通过本章节的学习，将我们的项目和文档相结合起来，反正要写注释，现在是一举两得，即完成了代码注释，也完成了项目文档。

👨‍💻本章节代码

Github

今天，不在模板上做文章了，而是要开启新的章节，我们叫它 restful。

📍restful 是什么

说到 restful 相信很多乃至大量的朋友们都不陌生，如果你已经知道那就直接看下一个章节，但还是有很多小伙伴是第一次接触，那么这里就简单介绍一下restful。

简单的说 restful 就是一种 接口定义风格，比如说之前我们的接口对于更新用户可能这样定义， /update_user 对于获取当前用户可能是 get_user ,删除当前用户为 /delete_user ，而现在使用 restful 风格的接口，那么我们对于更新用户的接口定义为 /user，获取用户定义为 /user ，删除用户为 /user 。

？？？…………………………？？？

第一次接触的朋友肯定是满脸问号，所以我访问一下 /user 数据是更新了？删除了？还是获取一个用户？所以说一个完整的 restful 风格的接口并不是只是 url 的定义，还有请求方式。

还记得第二章中对于 gin 提供的 http 请求方式的说明吗？所以一个完整的 restful 请求需要加上请求方式。对于更新用户我们的接口应该是用 update 请求 ``/user,对于获取用户应该用get请求方式/user,对于删除用户应该用delete请求/user` 接口。

这里只对 restful 请求方式做最简单的介绍。

🔖第一个接口

我们现在来进行一个关于文章接口的展示，仍旧是连接上数据库，数据存在数据库中。

首先建立数据库，仍旧是在我们之前使用的数据库上建立新的表 article ,下面为建表语句,并且连接数据库。

create table ` article`
(
	id int auto_increment
		primary key,
	type varchar(20) null,
	content text not null
);

首先我们要有一个模型来和表结构对应，也用于我们接收前端的数据绑定。

新建 model 文件夹，在 model 文件夹中建立 article.go

type Article struct {
	Id      int    `json:"id"`
	Type    string `json:"type"`
	Content string `json:"content"`
}

通过标注 json 来进行对前端数据获取是的绑定。

接下来就可以完成第一个功能了，向数据库新增一个 article 。在 article.go 中完成向数据添加数据的代码，这里代码不做解释，和之前一致。

func (article Article) Insert() int {
	result, e := initDB.Db.Exec("insert into `article` (type, content) values (?, ?);", article.Type, article.Content)
	if e != nil {
		log.Panicln("文章添加失败", e.Error())
	}
	i, _ := result.LastInsertId()
	return int(i)
}

完成 model 层，就可以完成 handler

在 handler 下新建 article/articleHandler.go 。

我们首要要获取前端穿过来的数据。通过 context.ShouldBindJSON 来对数据进行绑定。如果绑定成功，则调用我们上面写的增加方法进行添加。当完成后，通过 context.JSON 返回 json 数据。

func Insert(context *gin.Context) {
	article := model.Article{}
	var id = -1
	if e := context.ShouldBindJSON(&article); e == nil {
		id = article.Insert()
	}
	context.JSON(http.StatusOK, gin.H{
		"id": id,
	})
}

最后，我们完成对应的路由。

在 initRouter 中的 SetupRouter 中完善路由配置。

articleRouter := router.Group("")
	{
		// 添加一篇文章
		articleRouter.POST("/article", article.Insert)
	}

⭕测试

当这一切完成后就是运行测试了。

当然我们最好编写单元测试。

在 test 文件夹中，新建 article_test.go 测试文件。

package test

import (
	"GinHello/initRouter"
	"GinHello/model"
	"bytes"
	"encoding/json"
	"github.com/gin-gonic/gin"
	"gopkg.in/go-playground/assert.v1"
	"net/http"
	"net/http/httptest"
	"testing"
)

var router *gin.Engine

func init() {
	router = initRouter.SetupRouter()
}

func TestInsertArticle(t *testing.T) {
	article := model.Article{
		Type:    "go",
		Content: "hello gin",
	}
	marshal, _ := json.Marshal(article)
	w := httptest.NewRecorder()
	req := httptest.NewRequest(http.MethodPost, "/article", bytes.NewBufferString(string(marshal)))
	req.Header.Add("content-type", "application/json")
	router.ServeHTTP(w, req)
	assert.Equal(t, w.Code, http.StatusOK)
	assert.NotEqual(t, "{id:-1}", w.Body.String())
}

在测试用例里创建一个 article 对象，并且赋值，通过 json 方法建对象转换为 json,最后发起请求。

运行测试用例，如果我们的代码写的 没有问题的话，测试通过，并且数据库中会对应添加该数据。

当然你不想写单元测试也是可以的，可以通过 Postman 等来进行测试，这里给大家简单的介绍一下 GoLand Http 测试工具。

我们新建立一个 http_test 文件夹，在文件夹下面新建一个 .http 文件，命名为 article.http

对文件进行编写，编写如下，指定我们的请求地址，指定要求的数据。在POST 左侧就会出现一个 运行按钮，点击运行按钮，控制台会出现返回结果。运行该文件时，要将我们的项目启动起来。

POST http://localhost:8080/article
Content-Type: application/json

{
  "type": "go",
  "content": "Hello Go"
}

其他的 .http 文件的语法规则 请看官方文档。

这样就完成了第一个 restful 接口，同样可以完成其他的接口。其他的接口示例请看 Github 上代码。

✍总结

本章节主要讲述了如何构建一套 restful 接口，restful 接口对于现在的开发是越来越重要了，大量的接口都是 restful 风格。Github 上代码完成了查询，添加，删除等接口，篇幅有限，不展开多讲了。

👩‍💻本章节示例代码

Github

🍪 Cookies

接上回，如何来判断用户是否登录呢？ cookie 就是一个很好的凭证，cookie 会保留到浏览器上，每次访问请求的时候就会携带上，后端通过对 cookie 的识别，来判断用户是否登录。

由此一来，首先我们是要在登录的时候保存 cookie 。修改 userHandler 中 UserLogin 代码

在判断密码正确的时候，对 cookie 进行添加。

context.SetCookie("user_cookie", string(u.Id), 1000, "/", "localhost", false, true)

这里来介绍一下这些参数，第一个参数为 cookie 名；第二个参数为 cookie 值；第三个参数为 cookie 有效时长，当 cookie 存在的时间超过设定时间时，cookie 就会失效，它就不再是我们有效的 cookie；第四个参数为 cookie 所在的目录；第五个为所在域，表示我们的 cookie 作用范围；第六个表示是否只能通过 https 访问；第七个表示 cookie 是否可以通过 js代码进行操作。

启动我们的项目，进行登录操作，F12 打开我们的控制台，选择Application ,在侧边栏找到 cookie，并且选择我们的站点，此时就可以在我们的右侧看到我们刚刚设置的 cookie 信息

并且有 Expires/Max-Age 属性，该属性表示 cookie 的过期时间，一旦超过这个时间，cookie 就会自动消失。

此时，已经表明我们的 cookie 设置成功。

🥞通过中间件获取Cookie

既然 cookie 已经获取成功，那么就该对我们新写的 Auth 中间件进行修改了。

我们首先建立一个 401.tmpl 文件，用于展示我们的权限不足时的信息。

{{template "header"}}

{{template "nav"}}

请先登录:<a href="/">首页</a>

当我们要访问需要权限的路由时，恰巧我们权限不足，就会转跳到该页面。

此时再完善我们的中间件。

func Auth() gin.HandlerFunc {
	return func(context *gin.Context) {
		_, e := context.Request.Cookie("user_cookie")
		if e == nil {
			context.Next()
		} else {
			context.Abort()
			context.HTML(http.StatusUnauthorized, "401.tmpl", nil)
		}

	}
}