后面将会持续输出 go
Gin
框架系列的文章,从简到繁,由浅入深,对这一系列感兴趣的小伙伴,欢迎关注动态更新,让我们一起学习,一起进步!
Gin 框架介绍
Gin 是一个用 Go (Golang) 编写的 Web 框架。 它具有类似 martini 的 API,性能要好得多,多亏了 httprouter,速度提高了 40 倍。 如果您需要性能和良好的生产力,您一定会喜欢 Gin。[1]
上述内容摘自官网文档。从描述中我们可以知道 Gin
是一个 WEB
框架,其在性能方面有显著的优势。除此之外,Gin
框架还具备着其他优势和特点,例如 简单、高效、轻量级设计、对用户友好的 API 和 灵活的路由与中间件配置 以及 内置良好的错误处理机制 等。
如果你刚开始学习 Go
语言并且正在寻找一个易于上手的 web
框架,那么 Gin
框架无疑是你的最佳选择。
对于那些追求高性能并且希望快速推进项目的开发团队,Gin
框架是一个值得考虑的选项。
Gin 初体验
安装
go 版本要求 1.13 及以上版本
1、下载并安装
gin
go get -u github.com/gin-gonic/gin
2、代码引入
import "github.com/gin-gonic/gin"
示例
一个完整的示例代码如下所示:
package main
import "github.com/gin-gonic/gin"
func main() {
r := gin.Default()
r.GET("/hello", func(ctx *gin.Context) {
ctx.JSON(200, gin.H{
"message": "你好,世界!欢迎关注 Go技术干货 公众号,一起学习一起进步!",
})
})
r.Run(":8080")
}
运行代码之后,我们可以通过多种方式来测试所定义的接口:
一是通过终端中的 curl
命令(执行 curl http://127.0.0.1:8080/hello
);
二是直接在浏览器地址栏输入对应的 URL
;
三是利用 API
工具例如 Postman
进行测试。Postman
测试结果如下所示:
代码分析:
- 首先,我们通过
gin.Default()
函数获取到一个Gin
框架默认实例,该实例会自动添加了两个预配置的中间件:Logger
日志处理中间件和处理panic
的Recovery
中间件。如果你需要一个创建空配置的Gin
实例,你可以使用gin.New()
函数。 - 其次,获取到
gin
实例之后,我们通过GET()
方法注册一个GET
请求的路由,其路径设置为/hello
。在这个路由的处理函数中,我们使用ctx.JSON()
方法来构造并发送一个JSON
格式的响应。其中,gin.H
是一个map[string]any
的简写,用于方便地定义JSON
响应的键值对。 - 最后,我们通过
r.Run()
方法启动一个WEB
服务器,并传入:8080
作为参数。这样会让WEB
服务器监听 8080 端口。需要注意的是,这个端口参数是可选的,如果没有指定端口,Gin 会默认使用 8080 端口。
小结
本文首先简单介绍了 Go
Gin
框架,包括它的一些优势和特点,然后通过一个入门示例,演示了如何安装和使用 Gin
启动一个 WEB
服务器并注册路由。通过短短几行代码就能启动一个 WEB
服务器,可知 Gin
是一个简单、高效且易于使用的框架,非常适合快速开发和迭代。
后续文章将介绍 Go
Gin
框架的其他主题内容,敬请期待。
参考资料
[1] Gin 介绍:https://gin-gonic.com/zh-cn/docs/introduction/
作者:陈明勇
个人网站:chenmingyong.cn
文章持续更新,如果本文能让您有所收获,欢迎点赞收藏加关注本号。
微信阅读可搜《Go技术干货》。这篇文章已被收录于 GitHub https://github.com/chenmingyong0423/blog ,欢迎大家 Star 催更并持续关注。