gin context和官方context_Gin 框架系列 安装和路由配置

概述

看下 Gin 框架的官方介绍:

Gin 是一个用 Go (Golang) 编写的 web 框架。它是一个类似于 martini 但拥有更好性能的 API 框架, 由于 httprouter,速度提高了近 40 倍。如果你是性能和高效的追求者, 你会爱上 Gin。

是的,就是用 Gin 来写 API 接口。

这篇文章分享 Gin 的安装和Gin 的路由配置。

路由配置包含的功能点如下:

  • 实现了,路由分组 v1版本、v2版本。

  • 实现了,生成签名和验证验证。

  • 实现了,在配置文件中读取配置。

Gin 安装

必须要先安装 Go,Go 的安装可以参考:Go - 环境安装。

框架安装可以参考官网:

https://gin-gonic.com/zh-cn/docs/quickstart/

我在安装时,用的是 dep 安装,给大家分享下。

dep 是啥 ?(推荐使用 go module)

它是 Golang 官方依赖管理工具,可以认为它与 PHP 中的 composer 类似。

在这就不多做介绍了,可以自己去了解,安装也比较简单。

我本机是 Mac,安装只需一个命令:

brew install dep

咱们接下来创建一个新项目:ginDemo。

在 ginDemo 目录下执行:

dep init

执行完毕,会生成如下三个文件:

├─ ginDemo

│ ├─ vendor

│ ├─ Gopkg.toml

│ ├─ Gopkg.lock

依赖包都会下载到 vendor 目录。

需要的依赖配置写在 Gopkg.toml 文件。

Gopkg.lock 暂时可以不用管。

Gopkg.toml 文件中增加依赖:

[[constraint]]

name = "github.com/gin-gonic/gin"

version = "1.4.0"

新增一个 main.go 文件:

// 官方 Demo

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() // listen and serve on 0.0.0.0:8080

}

ginDemo 目录下执行:

dep ensure

执行完毕, vendor 目录会存在安装包,这时整体目录结构如下:

├─ ginDemo

│ ├─ vendor

│ ├── github.com

│ ├── ...

│ ├── golang.org

│ ├── ...

│ ├── gopkg.in

│ ├── ...

│ ├─ Gopkg.toml

│ ├─ Gopkg.lock

│ ├─ main.go

ginDemo 目录下执行:

go run main.go

浏览器访问:http://localhost:8080/ping

5512e7f17ed04b4264aeb5be2b5cc414.png

大功告成!

路由配置

比如,我们的接口地址是这样的:

  • /v1/product/add

  • /v1/member/add

  • /v2/product/add

  • /v2/member/add

假设需求是这样的,接口支持多种请求方式,v1 不需签名验证,v2 需要签名验证,路由文件应该这样写:

package router

import (

"ginDemo/common"

"ginDemo/controller/v1"

"ginDemo/controller/v2"

"github.com/gin-gonic/gin"

"net/url"

"strconv"

)

func InitRouter(r *gin.Engine) {

r.GET("/sn", SignDemo)

// v1 版本

GroupV1 := r.Group("/v1")

{

GroupV1.Any("/product/add", v1.AddProduct)

GroupV1.Any("/member/add", v1.AddMember)

}

// v2 版本

GroupV2 := r.Group("/v2", common.VerifySign)

{

GroupV2.Any("/product/add", v2.AddProduct)

GroupV2.Any("/member/add", v2.AddMember)

}

}

func SignDemo(c *gin.Context) {

ts := strconv.FormatInt(common.GetTimeUnix(), 10)

res := map[string]interface{}{}

params := url.Values{

"name" : []string{"a"},

"price" : []string{"10"},

"ts" : []string{ts},

}

res["sn"] = common.CreateSign(params)

res["ts"] = ts

common.RetJson("200", "", res, c)

}

.Any 表示支持多种请求方式。

controller/v1 表示 v1 版本的文件。

controller/v2 表示 v2 版本的文件。

SignDemo 表示生成签名的Demo。

接下来,给出一些代码片段:

验证签名方法:

// 验证签名

func VerifySign(c *gin.Context) {

var method = c.Request.Method

var ts int64

var sn string

var req url.Values

if method == "GET" {

req = c.Request.URL.Query()

sn = c.Query("sn")

ts, _ = strconv.ParseInt(c.Query("ts"), 10, 64)

} else if method == "POST" {

req = c.Request.PostForm

sn = c.PostForm("sn")

ts, _ = strconv.ParseInt(c.PostForm("ts"), 10, 64)

} else {

RetJson("500", "Illegal requests", "", c)

return

}

exp, _ := strconv.ParseInt(config.API_EXPIRY, 10, 64)

// 验证过期时间

if ts > GetTimeUnix() || GetTimeUnix() - ts >= exp {

RetJson("500", "Ts Error", "", c)

return

}

// 验证签名

if sn == "" || sn != CreateSign(req) {

RetJson("500", "Sn Error", "", c)

return

}

}

生成签名的方法:

// 生成签名

func CreateSign(params url.Values) string {

var key []string

var str = ""

for k := range params {

if k != "sn" {

key = append(key, k)

}

}

sort.Strings(key)

for i := 0; i < len(key); i++ {

if i == 0 {

str = fmt.Sprintf("%v=%v", key[i], params.Get(key[i]))

} else {

str = str + fmt.Sprintf("&%v=%v", key[i], params.Get(key[i]))

}

}

// 自定义签名算法

sign := MD5(MD5(str) + MD5(config.APP_NAME + config.APP_SECRET))

return sign

}

获取参数的方法:

// 获取 Get 参数

name := c.Query("name")

price := c.DefaultQuery("price", "100")

// 获取 Post 参数

name := c.PostForm("name")

price := c.DefaultPostForm("price", "100")

// 获取 Get 所有参数

ReqGet = c.Request.URL.Query()

// 获取 Post 所有参数

ReqPost = c.Request.PostForm

v1 业务代码:

package v1

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

func AddProduct(c *gin.Context) {

// 获取 Get 参数

name := c.Query("name")

price := c.DefaultQuery("price", "100")

c.JSON(200, gin.H{

"v1" : "AddProduct",

"name" : name,

"price" : price,

})

}

v2 业务代码:

package v2

import (

"github.com/gin-gonic/gin"

)

func AddProduct(c *gin.Context) {

// 获取 Get 参数

name := c.Query("name")

price := c.DefaultQuery("price", "100")

c.JSON(200, gin.H{

"v2" : "AddProduct",

"name" : name,

"price" : price,

})

}

接下来,直接看效果吧。

访问 v1 接口:

f5ed219bf7252f19af9d1ad2d6ab4f94.png

访问后,直接返回数据,不走签名验证。

访问 v2 接口:

5cb193503f5570ea9afa74311e9e28af.png

进入了这段验证:

// 验证过期时间

if ts > GetTimeUnix() || GetTimeUnix() - ts >= exp {

RetJson("500", "Ts Error", "", c)

return

}

修改为合法的时间戳后:

f42e8dd53f0463024cf0b4530540d291.png

进入了这段验证:

// 验证签名

if sn == "" || sn != CreateSign(req) {

RetJson("500", "Sn Error", "", c)

return

}

修改为合法的签名后:

f66aaee1b0e54ec334f3f85684507f95.png

至此,简单的路由配置已经实现了。

对了,还有一个点没说,就是如何读取配置文件中的配置,我是这样做的:

package config

const (

PORT = ":8080"

APP_NAME = "ginDemo"

APP_SECRET = "6YJSuc50uJ18zj45"

API_EXPIRY = "120"

)

引入 config 包,直接 config.xx 即可。

本文欢迎转发,转发请注明作者和出处,谢谢!


喜欢本文的朋友,欢迎关注“Go语言中文网”:

cd83ca2b8e6edb0cb8ad8d6e62b06428.png

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值