
上篇文章我们介绍了Go语言 Gin框架的基础是一个自定义http.Handle实现结构。
今天我们来看看Gin是如何实现自定义http.Handle的。在前面我们发过一段代码是:
app=gin.New() app.Run()
通过上篇文章的解释我们不难发现gin.New就是创建一个gin自定义的Handle。那么Gin是如何定义这个Handle,并且这个Handle可以做什么事情呢?
①首先看一下New方法的实现
func New() *Engine {
debugPrintWARNINGNew()
engine := &Engine{
RouterGroup: RouterGroup{
Handlers: nil ,
basePath: "/",
root: true,
},
FuncMap: template.FuncMap{},
RedirectTrailingSlash: true,
RedirectFixedPath: false,
HandleMethodNotAllowed: false,
ForwardedByClientIP: true,
AppEngine: defaultAppEngine,
UseRawPath: false,
UnescapePathValues: true,
MaxMultipartMemory: defaultMultipartMemory,
trees: make(methodTrees, 0, 9),
delims: render.Delims{Left: "{{", Right: "}}"},
secureJsonPrefix: "while(1);",
}
engine.RouterGroup.engine = engine
engine.pool.New = func() interface{} {
return engine.allocateContext()
}
return engine
}
通过这段代码我们不难发现gin的自定handle的 结构体 是(Engine)中有很多的属性用于支撑整个框架的运行。
我们来看一下gin.Engine定义了哪些属性每个属性的作用是什么?
type Engine struct { RouterGroup //组合了一个RouterGroup结构体,这个我们将在下一篇和大家一起学习 delims render.Delims //用于 html 渲染时的,渲染标记定义,默认是{{}} secureJsonPrefix string //json安全化 HTMLRender render.HTMLRender //html渲染器 FuncMap template.FuncMap //模版函数定义,用户定义模版中使用到的通用函数 allNoRoute HandlersChain //所有404状态处理函数集合。 allNoMethod HandlersChain //所有405状态处理函数集合 noRoute HandlersChain //自定义404状态处理函数集合 noMethod HandlersChain //自定义405状态处理函数集合 pool sync.Pool //异步池用于为每一次请求分配一个独立池,此池创建一个我们使用的gin.Context为我们提供一个上下文,此池会在每次GC时自动释放 trees methodTrees //按照HTTP请求的METHOD进行分类,每个类型下有一个树的结构 //关于树的结构进行说明一下: //我进行一些测试 如设置3个GET路由分别是/ ping /ping1 /ping2 这个时候在树中的结构就是ping为父节点 1,2为子节点 // 如设置3个路由 /ping /ping1 /ping/ demo 这个时候在树中的结构就是ping为父节点 1 /demo为子节点 // 如设置4个路由 /ping /ping1 /ping/demo /ping/test 这个时候在树中的结构为 ping为父节点 1 / 为ping下的子节点 test demo为/下的子节点 //此参数的意思为是否处理如/foo/ 转为/foo RedirectTrailingSlash bool // 修复当前请求地址的多余元素如: ../ 或者//等进行修复并重定向到正确的路由 RedirectFixedPath bool // 是否开启请求方法不允许错误。当不开启时方法不存在直接抛出404,如果开启的话则先判断是否支持其它方法如果支持其它方法则抛出405不被允许, HandleMethodNotAllowed bool //是否转发客户端IP ForwardedByClientIP bool // #726 #755 If enabled, it will thrust some headers starting with // 'X-AppEngine...' for better integration with that PaaS. AppEngine bool // If enabled, the url.RawPath will be used to find parameters. UseRawPath bool // If true, the path value will be unescaped. // If UseRawPath is false (by default), the UnescapePathValues effectively is true, // as url.Path gonna be used, which is already unescaped. //转义Path的字符 UnescapePathValues bool // Value of 'maxMemory' param that is given to http.Request's ParseMultipartForm // method call. // 当解析ParseMultipartForm是,最大内存 MaxMultipartMemory int64 }
通过上面属性的说明我们大概可以了解到Gin的自定参数有哪些?那么Gin是如何通过这些参数进行处理请求和响应的。如:
- 路由是怎么被执行的
- 中间件是如何实现的
- 请求参数是怎么接受和解析的
- 响应是如何封装的
总结
因为本人也是个菜鸟每日抽出一点时间学习Gin框架的源码和大家进行分享,欢迎各位大神多多提出宝贵一件。
今天我们主要为大家介绍一下Gin的自定义属性。