当前位置:  首页>> 技术小册>> Gin框架入门教程

框架一直是敏捷开发中的利器,能让开发者很快的上手并做出应用,甚至有的时候,脱离了框架,一些开发者都不会写程序了。成长总不会一蹴而就,从写出程序获取成就感,再到精通框架,快速构造应用,当这些方面都得心应手的时候,可以尝试改造一些框架,或是自己创造一个。

曾经我以为Python世界里的框架已经够多了,后来发现相比golang简直小巫见大巫。golang提供的net/http库已经很好了,对于http的协议的实现非常好,基于此再造框架,也不会是难事,因此生态中出现了很多框架。既然构造框架的门槛变低了,那么低门槛同样也会带来质量参差不齐的框架。

考察了几个框架,通过其github的活跃度,维护的team,以及生产环境中的使用率。发现Gin还是一个可以学习的轻巧框架。

Gin是一个golang的微框架,封装比较优雅,API友好,源码注释比较明确,已经发布了1.0版本。具有快速灵活,容错方便等特点。其实对于golang而言,web框架的依赖要远比Python,Java之类的要小。自身的net/http足够简单,性能也非常不错。框架更像是一些常用函数或者工具的集合。借助框架开发,不仅可以省去很多常用的封装带来的时间,也有助于团队的编码风格和形成规范。

Gin 包括以下几个主要的部分:

设计精巧的路由/中间件系统;
简单好用的核心上下文Context;
附赠工具集(JSON/XML 响应, 数据绑定与校验等).

在之前的《GoWeb开发实战》中,我们已经讲解过Beego,那么现在我们来学习一下Gin。

Gin 是一个 Golang 写的 web 框架,具有高性能的优点,,基于 httprouter,它提供了类似martini但更好性能(路由性能约快40倍)的API服务。 官方地址:https://github.com/gin-gonic/gin

一、安装

打开终端,并深入以下命令:

go get -u github.com/gin-gonic/gin
安装完成后可以查看一下gopath的src目录下:

使用的时候要导入包:

  1. import "github.com/gin-gonic/gin"

二、HelloWorld

现在,我们雀雀欲试,可以简单写个HelloWorld了。。

首先创建一个项目:gindemo,然后新建一个go文件(helloworld.go):

  1. package main
  2. import (
  3. "github.com/gin-gonic/gin"
  4. "net/http"
  5. )
  6. func main() {
  7. router := gin.Default()
  8. router.GET("/", func(c *gin.Context) {
  9. c.String(http.StatusOK, "Hello World")
  10. })
  11. router.Run(":8000")
  12. }

使用Gin实现Hello world非常简单,创建一个router(路由),然后执行Run方法即可。

右键运行项目,打开浏览器并访问指定的端口:http://127.0.0.1:8000/

后台运行结果如下:

或者我们通过终端的curl命令,也可以访问,在终端输入:

  1. curl http://127.0.0.1:8000/

是不是比Java方便多了!下面来仔细分析下上面的代码结构:

1、router:=gin.Default():这是默认的服务器。使用gin的Default方法创建一个路由Handler;
2、然后通过Http方法绑定路由规则和路由函数。不同于net/http库的路由函数,gin进行了封装,把request和response都封装到了gin.Context的上下文环境中。
3、最后启动路由的Run方法监听端口。还可以用http.ListenAndServe(“:8080”, router),或者自定义Http服务器配置。
要知道一次请求处理的大体流程,只要找到web框架的入口即可。通过我们上面的例子我们可以看到,Run方法十分耀眼,点击去可以看到关键的http.ListenAndServe,这意味着Engine这个结构体,实现了ServeHTTP这个接口。入口就是Engine实现的ServeHTTP接口。

  1. //我是Run方法
  2. func (engine *Engine) Run(addr ...string) (err error) {
  3. defer func() { debugPrintError(err) }()
  4. address := resolveAddress(addr)
  5. debugPrint("Listening and serving HTTP on %s\n", address)
  6. err = http.ListenAndServe(address, engine)
  7. return
  8. }

简单几行代码,就能实现一个web服务。使用gin的Default方法创建一个路由handler。然后通过HTTP方法绑定路由规则和路由函数。不同于net/http库的路由函数,gin进行了封装,把request和response都封装到gin.Context的上下文环境。最后是启动路由的Run方法监听端口。麻雀虽小,五脏俱全。当然,除了GET方法,gin也支持POST,PUT,DELETE,OPTION等常用的restful方法。


该分类下的相关小册推荐: