Gin 是一个非常优秀的Golang Web Framework,它不光API友好,性能也非常高,并且设计简洁,便于入门。所以它(Gin)非常受欢迎,在Github上已经三万三千多个星星,也是我最喜欢的Web 框架。
入门要求
要想使用Golang Gin这个框架,你必须要得会Golang这门语言,如果你还没有开始学,我强烈推荐给你,这门高效、简洁的语言,号称21世纪的C,如果你以前是C/C++的开发者,那么恭喜你,你很快就会入门,即使你是PHP,Python等语言的开发者,那么入门Golang也只需要不到一周的时间。
对于Golang语言的环境配置,我以前写过一篇很详细的文章,可以直接参考使用 Go语言(Golang)环境搭建详解 。
对于Go语言的入门和深入,可以跟着我的《Go语言实战笔记》系列来学习,一共28篇文章,15W+字,从0开始,带你入门和深入 《Go语言实战》笔记(二十八) | 后记。
我这里和以后文章的代码示例,都讲基于以下环境:
-
Golang 1.13版本(含)以上
-
Gin 1.5版本(含)以上
-
macOS 64位操作系统
-
Go Module 开发方式
如果你是用的Golang和Gin的版本和我的不同,可能会有一定的影响,不过操作系统,一般不会有太大的差异,因为Golang是可以跨平台编译的。
net/http
Golang(Go语言)内置是有HTTP服务的,我们可以通过内置的net/http
包来实现一个HTTP服务。
func main() {
http.HandleFunc("/",Index)
log.Fatal(http.ListenAndServe(":8080", nil))
}
func Index(w http.ResponseWriter, r *http.Request){
fmt.Fprint(w,"Blog:www.flysnow.org\nwechat:flysnow_org")
}
这就是一个很简单的HTTP服务实现,我们运行这个代码程序,然后在浏览器里打开http://localhost:8080
网址,就可以看到如下信息:
Blog:www.flysnow.org
wechat:flysnow_org
从代码上看实现一个HTTP服务是非常简单的,这也是Golang语言的优势,在底层做了很多封装,可以让我们更容易的实现相关的服务。
虽然net/http
看着很便捷、很简单,但是它也存在很多不足:
-
不能单独的对请求方法(POST,GET等)注册特定的处理函数
-
不支持Path变量参数
-
不能很很好的获取参数
-
不支持参数校验
-
不支持参数绑定
-
不能更好的多种格式输出
-
性能一般
-
扩展性不足
-
……
以上等等,这些又都是我们Web开发中常用的,所以我们只能我们自己开发中自己重复的实现,影响了效率,降低了质量,不同人的开发者,性能也不一样。
这时候,我们就非常需要一个Golang Web 框架来帮我们把这些重复的事情做了,这个就是Golang Gin要做的事情了。Golang Gin 作为一个非常优秀的Web框架,帮我们弥补了net/http
的不足,同时还增加了很多日常Web开发使用的功能,可以让我们更好的进行Web开发。
Hello Gin
要使用Gin非常简单,它和其他第三方 Golang 库一样。如果你是基于GOPATH
开发的,你需要先使用go get -u github.com/gin-gonic/gin
下载gin,然后import
导入即可。
如果你是用Go Module这种方式,使用import
直接导入使用,然后你在go run
运行的时候,会自动的下载gin
包编译使用。当然你也可以通过go mod tidy
来下载依赖的模块。
现在让我们通过一个例子,看下Golang Gin的使用是多么简单吧。
package main
import "github.com/gin-gonic/gin"
func main() {
r := gin.Default()
r.GET("/", func(c *gin.Context) {
c.JSON(200, gin.H{
"Blog":"www.flysnow.org",
"wechat":"flysnow_org",
})
})
r.Run(":8080")
}
然后我们运行它,打开浏览器,输入http://localhost:8080/
就可以看到如下内容:
{"Blog":"www.flysnow.org","wechat":"flysnow_org"}
看我们输出一个JSON
格式的内容是多么简单,这不就是我们项目中经常用到的API 返回的格式吗?不需要特别的包装,即可很方便的实现,比内置的net/http
要好多了。
这里解释下如上代码示例:
r := gin.Default()
是实例化一个默认的gin示例,便于我们操作,比如接着的为/
(也就是首页)的GET访问注册一个处理函数:
r.GET("/", func(c *gin.Context) {
c.JSON(200, gin.H{
"Blog":"www.flysnow.org",
"wechat":"flysnow_org",
})
})
看到了吧,Gin允许我们对特定的HTTP方法进行不同的处理,这就为我们实现Restful API提供了方便,比如这个示例中,如果我们通过POST方法请求http://localhost:8080/
会提示404的。
以上返回也很简单,c.JSON
方法就是返回一个JSON格式的字符串,它的方法签名如下:
func (c *Context) JSON(code int, obj interface{})
code
便是返回的HTTP Status Code
,obj
是内容,我这里使用的gin.H
其实是一个map[string]interface{}
,声明为H
类型,便于操作。
type H map[string]interface{}
最后,我们就可以通过r.Run(":8080")
启动一个HTTP服务了,端口是8080
,所以我们访问http://localhost:8080/
看到返回的JSON内容。
代码非常简单,但是牵涉的实现比较多,这里我做了一些简单的解释,以后的文章,还会对他们详细分析。
小结
这篇文章到这里就要结束了,相信大家也从这篇文章发现了,我的文章,不仅知其然,更知其所以然(其实我的老读者都知道这件事情),所以我并没有直接写Gin的入门代码,而且由浅入深的,逐步介绍引入Gin,然后对代码进行一些解释和分析,这样大家才会更好的理解,也能加深记忆,不光要做到知其然,也要知其所以然。
Gin还有很多功能,比如路由分组,自定义中间件,自动Crash处理等等,我会在接下来的文章中逐一介绍。
扫码关注
文章评论