阅读量:

类型概览

前言

为了更好的理解 gin 的工作流程，自己决定先熟悉 gin 中暴露的结构体来熟悉大体的工作流，再结合具体示例来深入了解整个工作流程。

一、Accounts

gin/auth.go at v1.7.4 · gin-gonic/gin (github.com)

type Accounts map[string]string

Accounts 是一个 map 表的别名，可以配合gin.BasicAuth()中间件进行简单的权限认证。

二、Context

gin/context.go at v1.7.4 · gin-gonic/gin (github.com)

type Context struct {
    writermem responseWriter
    Request   *http.Request
    Writer    ResponseWriter

    Params   Params
    handlers HandlersChain
    index    int8
    fullPath string

    engine       *Engine
    params       *Params
    skippedNodes *[]skippedNode
    mu sync.RWMutex
    Keys map[string]interface{}
    Errors errorMsgs
    Accepted []string
    queryCache url.Values
    formCache url.Values
    sameSite http.SameSite
}

Context 是gin框架中最重要的组成部分，整个 Web 应用都是基于Context的来的。Context就像是一个故事的主线，串联起了整个 Web 请求的故事。从请求开始，到中间经历的重重中间件再到具体的路由函数，再到请求结束，都和Context息息相关。

三、Engine

gin/gin.go at v1.7.4 · gin-gonic/gin (github.com)

type Engine struct {
    RouterGroup

    RedirectTrailingSlash bool
    RedirectFixedPath bool

    HandleMethodNotAllowed bool

    ForwardedByClientIP bool

    AppEngine bool
    UseRawPath bool

    UnescapePathValues bool
    RemoveExtraSlash bool
    RemoteIPHeaders []string

    TrustedPlatform string

    MaxMultipartMemory int64

    delims           render.Delims
    secureJSONPrefix string
    HTMLRender       render.HTMLRender
    FuncMap          template.FuncMap
    allNoRoute       HandlersChain
    allNoMethod      HandlersChain
    noRoute          HandlersChain
    noMethod         HandlersChain
    pool             sync.Pool
    trees            methodTrees
    maxParams        uint16
    maxSections      uint16
    trustedProxies   []string
    trustedCIDRs     []*net.IPNet
}

Engine中包含了作用于整个工程的中间件以及配置文件。在有HTTP访问来临时，Engine会找到匹配的路由，然后新建一个Context，对请求进行分发。

四、Error

gin/errors.go at v1.7.4 · gin-gonic/gin (github.com)

type Error struct {
    Err  error
    Type ErrorType
    Meta interface{}
}

Error是gin中用于处理错误的结构体，用于处理在框架处理服务过程中出现的错误。

五、ErrorType

gin/errors.go at v1.7.4 · gin-gonic/gin (github.com)

type ErrorType uint64

ErrorType用于定义错误类型，在使用中配合Error类型使用。

六、H

gin/utils.go at v1.7.4 · gin-gonic/gin (github.com)

type H map[string]interface{}

返回响应时将参数传递给H，框架会自动帮我们转换成想要的格式，如json、xml等。

七、HandlerFunc

gin/gin.go at v1.7.4 · gin-gonic/gin (github.com)

type cc func(*Context)

HandlerFunc是一种函数类型，中间件以及路由处理都是这种类型的函数。

八、HandlersChain

gin/gin.go at v1.7.6 · gin-gonic/gin (github.com)

type HandlersChain []HandlerFunc

HandlersChain是一个存放HandlerFunc的数组，gin通过直接遍历处理这些函数。

九、IRouter

gin/routergroup.go at v1.7.6 · gin-gonic/gin (github.com)

type IRouter interface {
    IRoutes
    Group(string, ...HandlerFunc) *RouterGroup
}

IRouter是路由组接口，在对路由进行分组处理时便会使用到该接口。

十、IRoutes

gin/routergroup.go at v1.7.6 · gin-gonic/gin (github.com)

type IRoutes interface {
    Use(...HandlerFunc) IRoutes

    Handle(string, string, ...HandlerFunc) IRoutes
    Any(string, ...HandlerFunc) IRoutes
    GET(string, ...HandlerFunc) IRoutes
    POST(string, ...HandlerFunc) IRoutes
    DELETE(string, ...HandlerFunc) IRoutes
    PATCH(string, ...HandlerFunc) IRoutes
    PUT(string, ...HandlerFunc) IRoutes
    OPTIONS(string, ...HandlerFunc) IRoutes
    HEAD(string, ...HandlerFunc) IRoutes

    StaticFile(string, string) IRoutes
    Static(string, string) IRoutes
    StaticFS(string, http.FileSystem) IRoutes
}

IRoutes是单路由处理接口。

十一、LogFormatter

gin/logger.go at v1.7.6 · gin-gonic/gin (github.com)

type LogFormatter func(params LogFormatterParams) string

LogFormatter定义了处理日志的函数类型。

十二、LogFormatterParams

gin/logger.go at v1.7.6 · gin-gonic/gin (github.com)

type LogFormatterParams struct {
    Request *http.Request

    TimeStamp time.Time
    StatusCode int
    Latency time.Duration
    ClientIP string
    Method string
    Path string
    ErrorMessage string
    isTerm bool
    BodySize int
    Keys map[string]interface{}
}

LogFormatterParams定义了日志格式化时候使用的参数类型。

十三、LoggerConfig

gin/logger.go at v1.7.6 · gin-gonic/gin (github.com)

type LoggerConfig struct {
    Formatter LogFormatter

    Output io.Writer
    SkipPaths []string
}

LoggerConfig用于管理日志配置。

十四、Negotiate

gin/context.go at v1.7.6 · gin-gonic/gin (github.com)

type Negotiate struct {
    Offered  []string
    HTMLName string
    HTMLData interface{}
    JSONData interface{}
    XMLData  interface{}
    YAMLData interface{}
    Data     interface{}
}

Negotiate根据客户端的请求返回不同的响应类型。

十五、Param

gin/tree.go at v1.7.6 · gin-gonic/gin (github.com)

type Param struct {
    Key   string
    Value string
}

Param用于存储 url 中的单个查询参数。

十六、Params

gin/tree.go at v1.7.6 · gin-gonic/gin (github.com)

type Params []Param

Params用于存储 url 中的所有查询参数。

十七、RecoveryFunc

gin/recovery.go at v1.7.6 · gin-gonic/gin (github.com)

type RecoveryFunc func(c *Context, err interface{})

RecoveryFunc定义可传递给CustomRecovery的函数，用于自定义捕获运行过程中出现的错误。

十八、ResponseWriter

gin/response_writer.go at v1.7.6 · gin-gonic/gin (github.com)

type ResponseWriter interface {
    http.ResponseWriter
    http.Hijacker
    http.Flusher
    http.CloseNotifier

    Status() int
    Size() int
    WriteString(string) (int, error)
    Written() bool
    WriteHeaderNow()
    Pusher() http.Pusher
}

ResponseWriter响应返回数据的接口，用于处理 http 响应。

十九、RouteInfo

gin/gin.go at v1.7.6 · gin-gonic/gin (github.com)

type RouteInfo struct {
    Method      string
    Path        string
    Handler     string
    HandlerFunc HandlerFunc
}

RouteInfo用于记录 gin 中对路由处理的信息，包括请求方法、请求路径、处理请求的函数名字以及具体的处理函数。

二十、RouterGroup

gin/routergroup.go at v1.7.6 · gin-gonic/gin (github.com)

type RouterGroup struct {
    Handlers HandlersChain
    basePath string
    engine   *Engine
    root     bool
}

RouterGroup用于分组路由处理。

二十一、RoutesInfo

gin/gin.go at v1.7.6 · gin-gonic/gin (github.com)

type RoutesInfo []RouteInfo

RoutesInfo储存整个服务的路由处理信息。

总计

概览所有类型，我们可以对所有类型进行一个简单得分类：

                +---------+ +---------+
                |  Engine | | Context |  +----------------+
                +---------+ +---------+  | ResponseWriter |
                   +---------------+     | H              |
+-------------+    | HandlerFunc   |     | Negotiate      |
| IRouter     |    | HandlersChain |     +----------------+
| IRoutes     |    +---------------+     +--------------------+
| RouterInfo  | +-----------+ +--------+ | LogConfig          |
| RoutesInfo  | | Error     | | Param  | | LogFormatterParams |
| RouterGroup | | ErrorType | | Params | | LogFormatter       |
+-------------+ +-----------+ +--------+ +--------------------+

对这些结构体的大体功能划分清楚后我们就明白了 gin 工作的大体流程，后面再对结合示例对工作细节进行探究学习。

类型概览

前言

一、Accounts

二、Context

三、Engine

四、Error

五、ErrorType

六、H

七、HandlerFunc

八、HandlersChain

九、IRouter

十、IRoutes

十一、LogFormatter

十二、LogFormatterParams

十三、LoggerConfig

十四、Negotiate

十五、Param

十六、Params

十七、RecoveryFunc

十八、ResponseWriter

十九、RouteInfo

二十、RouterGroup

二十一、RoutesInfo

总计

评论