目录
- 前言
- 正文
- 结尾
前言
Gin 是使用纯 Golang 语言实现的 HTTP Web 框架,Gin 的接口设计简洁,性能极高,现在被广泛使用。我司的 Web 后端服务基本是都是基于 Gin 开发的。
正文
安装
首次使用 Gin 框架时,需要先进行安装,命令如下:
go get -u github.com/gin-gonic/gin
可能会出现如下报错信息:
# cd .; git clone -- https://github.com/gin-contrib/sse /Users/lz/go/src/github.com/gin-contrib/sse Cloning into '/Users/lz/go/src/github.com/gin-contrib/sse'... fatal: unable to access 'https://github.com/gin-contrib/sse/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443 package github.com/gin-contrib/sse: exit status 128
一般都是网络问题,可以多重试几次。
使用
在使用 Gin 的工具库之前,先要导入依赖库,具体代码如下:
import "github.com/gin-gonic/gin"
具体使用如下:
r := gin.Default()
实例演示
编写一段示例代码:
package main import "github.com/gin-gonic/gin" func main() { r := gin.Default() r.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{ "message": "pong", }) }) r.Run() }
通过代码可以知道,我们定义了 API 为 /ping 的服务接口。
然后我们编译代码,命令:
go build
编译成功后,会生成可执行程序 gin-demo,运行可执行程序,具体执行过程如下:
liuzhen-3:gin-demo lz$ ./gin-demo [GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached. [GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production. - using env: export GIN_MODE=release - using code: gin.SetMode(gin.ReleaseMode) [GIN-debug] GET /ping --> main.main.func1 (3 handlers) [GIN-debug] Environment variable PORT is undefined. Using port :8080 by default [GIN-debug] Listening and serving HTTP on :8080 复制代码
通过日志,我们可以看到,服务默认启动了 8080 端口。
接下来,我们测试一下这个服务是不是好用,在浏览器中输入如下地址:
运行结果如下图所示:
通过结果可以知道,服务是正常的。
结尾
综上所述,Gin 框架使用起来还是非常简单的,上手也非常方便。感兴趣的话,小伙伴们自己就动手试试吧!下面的内容我们继续深入分析 Gin 框架的源码部分,敬请期待!
作者简介:大家好,我是 Data-Mining(liuzhen007),是一位典型的音视频技术爱好者,同时也是CSDN博客专家、华为云享专家(共创编辑)、InfoQ 签约作者,欢迎关注我分享更多干货!