原文链接:gin-gonic教程01
gin-gonic
gin-gonic是一个golang语言的web框架, 它提供了和martini
类似的API, 同时又有着比它快40倍的性能(据官网所说)
安装
1.安装govendor
gin-gonic需要通过govendor
来安装, 所以第一步需要下载govendor, 命令如下
# 源码路径在$GOPATH/src
# 二进制执行程序路径在$GOPATH/bin
go get github.com/kardianos/govendor
# 执行如下命令验证安装成功
# 注意$GOPATH/bin需要包含在你的$PATH环境变量中
govendor -version
2.创建项目环境
在你的$GOPATH/src/
目录下创建一个目录GinPractice
, 命令如下
cd $GOPATH/src && mkdir GinPractice && cd GinPractice
# 下载gin-gonic包
govendor init
govendor fetch github.com/gin-gonic/gin@v1.3
3.使用gin-gonic
下面用一个最小的例子来使用gin-gonic, 先创建一个main.go
文件, 代码如下
package main
import (
"github.com/gin-gonic/gin" // gin包
"net/http" // http标准包 for http.StatusOK
)
func main() {
// uri路由器
router := gin.Default()
// 定义一个路由规则
router.GET("/JSONdata", func(c *gin.Context) {
data := map[string]interface{} {
"message":"This is a message",
}
c.JSON(http.StatusOK, data)
})
// 运行在8080端口
router.Run(":8080")
}
4.运行程序, 命令如下
先编译, 然后运行服务程序看看能不能成功
# 编译
go build main.go
# 运行
./main
# 如果运行成功输出如下
[GIN-debug] [WARNING] Now Gin requires Go 1.6 or later and Go 1.7 will be required soon.
[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 /JSONdata --> main.main.func1 (3 handlers)
[GIN-debug] Listening and serving HTTP on :8080
5.验证服务程序
利用curl命令发送请求, 验证一下路由情况
curl 'http://127.0.0.1:8080/JSONdata'
# 如果请求成功, 输出如下
{"message":"This is a message"}