1.gin框架原理详解(gin框架是框框架什么)
2.如何评价golang的gin框架?
3.Go 语言之在 gin 框架中使用 zap 日志库
4.Gin源码分析 - 中间件(3)- Logger
5.Gin源码分析 - 中间件(5)- Recovery
6.go-gin框架路由自动注册(iris-mvc方式)附源码
gin框架原理详解(gin框架是什么)
Gin的启动过程、路由及上下文源码解读
Engine是架源解析gin框架的一个实例,它包含了多路复用器、源码中间件和配置中心。框框架
gin通过Engine.Run(addr...string)来启动服务,架源解析最终调用的源码源码调试环境是/手败gin-gonic/gin
一个简单的例子:
packagemain
import"github.com/gin-gonic/gin"
funcmain(){
//Default返回一个默认的路由引擎
r:=gin.Default()
r.GET("/ping",func(c*gin.Context){
//输出json结果给调用方
c.JSON(,gin.H{
"message":"pong",
})
})
r.Run()//listenandserveon0.0.0.0:
}
编译运行程序,打开浏览器,框框架访问页面显示:
{ "message":"pong"}
gin的架源解析功能不只是简单输出Json数据。它是源码一个轻量级的WEB框架,支持RestFull风格API,框框架支持GET,架源解析POST,源码PUT,框框架PATCH,架源解析DELETE,源码OPTIONS等/gin-gonic/gin"
)
funcmain(){
router:=gin.Default()
//静态资源加载,本例为css,js以及资源
router.StaticFS("/public",/ffhelicopter/tmm/website/static"))
router.StaticFile("/favicon.ico","./resources/favicon.ico")
//Listenandserveon0.0.0.0:
router.Run(":")
}
首先需要是生成一个Engine,这是gin的核心,默认带有Logger和Recovery两个中间件。
router:=gin.Default()
StaticFile是operfire通信源码加载单个文件,而StaticFS是加载一个完整的目录资源:
func(group*RouterGroup)StaticFile(relativePath,filepathstring)IRoutes
func(group*RouterGroup)StaticFS(relativePathstring,fs/gin-gonic/gin
如果安装失败,直接去Githubclone下来,放置到对应的目录即可。
(2)代码中使用:
下面是一个使用Gin的简单例子:
packagemain
import(
"github.com/gin-gonic/gin"
)
funcmain(){
router:=gin.Default()
router.GET("/ping",func(c*gin.Context){
c.JSON(,gin.H{
"message":"pong",
})
})
router.Run(":")//listenandserveon0.0.0.0:
}
简单几行代码,就能实现一个web服务。使用gin的Default方法创建一个路由handler。然后通过HTTP方法绑定路由规则和路由函数。不同于net/e"}。
注:Gin还包含更多的返回方法如c.String,c.HTML,c.XML等,请自行了解。可以方便的返回HTML数据
我们在之前的组v1路由下新定义一个路由:
下面我们访问
可以看到,通过c.Param(“key”)方法,Gin成功捕获了url请求路径中的参数。同理,gin也可以捕获常规参数,如下代码所示:
在浏览器输入以下代码:
通过c.Query(“key”)可以成功接收到url参数,c.DefaultQuery在参数不存在的情况下,会由其默认值代替。
我们还可以为Gin定义一些默认路由:
这时候,初学c 源码网站我们访问一个不存在的页面:
返回如下所示:
下面我们测试在Gin里面使用Post
在测试端输入:
附带发送的数据,测试即可。记住需要使用POST方法.
继续修改,将PostHandler的函数修改如下
测试工具输入:
发送的内容输入:
返回结果如下:
备注:此处需要指定Content-Type为application/x-www-form-urlencoded,否则识别不出来。
一定要选择对应的PUT或者DELETE方法。
Gin框架快速的创建路由
能够方便的创建分组
支持url正则表达式
支持参数查找(c.Paramc.Queryc.PostForm)
请求方法精准匹配
支持处理
快速的返回给客户端数据,常用的c.Stringc.JSONc.Data
如何评价golang的gin框架?
如何评价 Golang 的 Gin 框架?
Gin 是 Golang 世界里最流行的 web 框架,它基于 Golang HTTP 标准库 net//gin-contrib/...
Gin源码分析 - 中间件(3)- Logger
本文深入剖析Gin框架内置中间件Logger,详细阐述其四种创建形式。基本形式以默认配置输出日志至标准输出。自定义格式器形式允许用户调整日志输出格式。指定输出流形式则灵活地将日志输出至特定写入器,同时可忽略指定路径的日志。复杂配置形式提供高度定制化,是创建中间件的高级手段。深入探讨LoggerConfig结构体,解析其三个关键属性:日志格式、输出器和忽略路径。金融宝源码后台LogFormatter方法实现日志的格式化,包含辅助函数进行颜色调整,如根据HTTP响应码和请求类型设置显示颜色。defaultLogFormatter方法提供默认的日志格式化操作。详细解析LoggerWithConfig方法,该方法获取配置参数并判断输出环境,随后将忽略路径保存为映射,记录过滤的路径。计算处理时间和构建日志字符串,输出至指定写入器。
Gin源码分析 - 中间件(5)- Recovery
Recovery中间件在HTTP请求处理中扮演着关键角色,尤其在处理过程中产生panic时。它能够捕获并处理这些异常,确保服务的稳定性和客户端的正常响应。通过使用gin框架,可以通过两种方式集成Recovery中间件:第一种是直接调用gin.New创建引擎时,无需注册Recovery中间件;第二种是在调用gin.Default()创建引擎时,内部自动注册Recovery中间件。在没有使用Recovery中间件的就这么牛 源码情况下,向服务发送异常请求会导致服务端和客户端出现异常;而使用Recovery中间件后,异常被捕获并以友好的方式显示异常堆栈,同时客户端收到HTTP 错误。
Recovery中间件内部实现通过多种变体接口实现,包括CustomRecoveryWithWriter、RecoveryWithWriter、CustomRecovery以及Recovery。其中,CustomRecoveryWithWriter提供最底层的形式,允许用户自定义异常输出和恢复处理逻辑。RecoveryWithWriter则提供了Writer参数和一个可选的RecoveryFunc,如果没有定义该函数,则使用defaultHandleRecovery。CustomRecovery和Recovery则分别使用默认的DefaultErrorWriter和defaultHandleRecovery。
Recovery的核心实现通过DefaultErrorWriter和defaultHandleRecovery两个主要部分。DefaultErrorWriter负责设置日志格式为红色字体输出。defaultHandleRecovery方法是整个处理流程的核心,包含捕获、处理异常、生成响应等关键步骤。首先通过recover()方法获取panic信息,判断异常是否由客户端断开连接引起,然后获取异常堆栈、请求头,并根据异常类型和原因进行相应的处理和响应输出。最终,根据处理结果返回HTTP响应,如果是异常则返回HTTP ,如果是网络原因则使用Abort方法。
Recovery中间件的实现不仅提供了异常处理的灵活性,还确保了服务的稳定性和客户端的友好体验。通过捕获和处理异常,Recovery中间件能够有效地减少服务中断的可能性,提高系统的健壮性。总结而言,Recovery中间件在处理异常时提供了实用的方法,对于开发稳定、可靠的HTTP服务具有重要意义。
go-gin框架路由自动注册(iris-mvc方式)附源码
通过分析,gin与iris在路由注册机制上有着明显的差异。gin采用逐条注册方式,而iris-mvc通过将子路由路径与controller方法名关联,实现更为简便的注册。
为了使gin具备iris-mvc的注册便捷性,我们可以采用包装技术,使gin的路由能以子方法名称的方式自动注册。这一方法要求方法名称符合特定格式,如GetTest,代表对test子路径注册get请求的路由。
在自动注册实现过程中,涉及到的文件包括控制器文件(/controller/hello_controller.go)、路由文件(/route/autoRoute.go)和路由管理文件(/route/route.go),最终集成到主程序(/main.go)中。
为了验证自动注册与原生注册方式的性能差异,我们进行了简单性能测试。使用ab工具,分别在阿里云环境下进行1W并发、W请求的测试,比较两种方式的响应时间。
测试结果显示,在性能方面,自动注册方式与原生注册方式表现相当,甚至在特定情况下(如.百分位响应时间),自动注册方式更具优势。因此,在处理1W并发请求场景时,自动注册方式是一个值得考虑的优化方案。
附上源码,供参考与实践。此源码实现了上述功能,帮助开发者轻松地将gin框架的路由注册流程优化为更符合iris-mvc风格的自动化注册流程。
Golang-gin框架中间件原理
什么是中间件
中间件是一个广泛的概念,其含义在不同领域有所不同。在bs/cs软件编程框架中,中间件可以理解为用于解耦业务和非业务代码的钩子函数,这些函数适用于所有或部分请求。
中间件的原理与钩子函数类似。在框架层面,程序运行到某个阶段会自动执行预设的函数,执行完毕后再回到跳出的那个阶段继续执行原函数。
在bs/cs开发中,为了在主体函数前后执行一些通用操作,常见的写法会预设一些钩子,如beforeXxxFunc、afterXxxFunc。但这只有两个函数,且是针对全局请求的。若要实现部分钩子函数针对某些请求,则需要做额外的业务外操作以达到目的。gin框架的中间件就解决了这些痛点。
中间件原理
原理1:每一条请求都处理自己所挂载的所有中间件和唯一主体函数。
普通的钩子函数如图所示:
优点:解耦了业务和非业务代码,非业务代码实现了统一封装使用。
缺点:若想针对某些主体函数不执行或执行其他beforeFunction,需要额外修改框架逻辑。
gin框架中间件如图:
优点:
原理2:洋葱模型。
洋葱模型,如图所示:
beforeFunc1和afterFunc1即是中间件1;afterFunc2和afterFunc2即是中间件2。
请求到来时从最外层开始执行中间件1,然后进入第二层,依次执行完所有中间件最后到达主体函数,接着再一层层往外走再次执行中间件2...中间件1...最后返回,有点像栈的概念。
gin中中间件的实现步骤1
首先,gin把中间件和主体函数统一定义为一个handleFunc。
源码:gin.go
不管是用use()方法注册中间件,还是用restful注册主体函数,类型都是HandlerFunc。
源码:routergroup.go
步骤2
把所有handleFunc装入一个数组或叫handleChain的东西。
步骤3
从handleChain的第一个元素开始执行,中间使用c.next、c.Abort等函数进行流程控制。
手动实现一个简单版本的中间件
运行结果: