Go-Gin参数绑定

Gin参数绑定

在web层，对于前端传参后端如何解析是一个比较重要的问题。对于Http协议来讲，网络请求有很多方法:GET,POST,DELETE,PUT。。。那么参数绑定怎做呢？

回忆杀

首先回忆一下Java怎么解析参数

古老的Servlet

相信很多人都是写过Servlet的，其实Servlet使用的是最原始的也是最强有力的工具：Request对象。
对于当前一次会话，都会有一个Request对象，这个对象有点类似于上下文：

例如我们这样获取参数。

spring MVC

在Servlet的基础上，SpringMVC做了一些封装，加了一些注解：@RequestParam,@PathVariable,@ModelView等等。用于解析request带来的参数

Gin Get请求

gin.Context 对象

首先要介绍一下gin.context对象
可以看到这个对象部分的成员函数，里面有一个比较重要的就是Request对象，这个对象其实就是和Servlet里面的request对象基本一致。

获取参数：Query函数

// 解析get参数
func GetParamHandler(ctx * gin.Context){
	var name=ctx.Query("name")
	var pwd = ctx.Query("pwd")
	fmt.Print(name+":"+pwd)
	ctx.JSON(200,"OK")
	return
}

为了获取Request里面的参数，我们可以这样。
写个main函数测试:

package main

import (
	"Learn/handler"
	"github.com/gin-gonic/gin"
)

func main(){
	r:=gin.Default();
	r.GET("/ping", func(ctx *gin.Context) {
		ctx.JSON(200,"pong")
	})


	r.GET("/getParam",handler.GetParamHandler)


	defer r.Run(":8080")
}

启动main函数，然后还是推荐一下Postman这个工具，还是很良心好用的.

可以看到控制台的日志
到这里基本就完成了Web层传回来的参数额解析
当然了Query函数还有很多类似的，比如：

DefaultQuery，可以设置一个默认值，就是发现id没有的时候，默认就是给一个0填充。
还有一点需要说明的就是，Query出来的参数默认都是字符串，所以需要其他数据类型的需要自己的去转换。

Gin Post参数解析

刚才看了GET，那么POST怎么解析呢？
前端传参格式：

{
    "name":"test",
    "pwd":"123"
}

定义一个对应的结构体：

package model

type Person struct {
	Name     string `json:"name"`
	Password string `json:"pwd"`
}

后端bind

func PostParamHandler(ctx * gin.Context){
	var p model.Person
	if err:=ctx.BindJSON(&p);err!=nil{
		glog.Error("bindJson fail")
		ctx.JSON(200,"bindJsonFail data is invalid")
		return
	}
	glog.Info("person:v",p)
	ctx.JSON(200,"OK")
}

可以看到后端采用了BindJson函数，把前端参数绑定到结构体里，这里需要注意的是一定要传递的是p的地址，因为go语言的参数传递全部都是值传递。

测试

还是和之前的一样，使用PostMan测试
可以看到返回结果。以及其他控制台日志

确实成功绑定。

其他bind函数

其实其他Bind参数的函数，比如：ShouldBind。
这样也是可以的。
那么他和BindJosn有什么区别呢？
可以简单的看一下BindJson的实现

可以看到BindJSON失败的时候，会在httpHeader里面写入状态码
ShoudBind是其实就是调用了ShouldBindWith，没有写状态码。

所以这里其实看自己的选择，如果状态码需要自己决定，那么就用Should系列，否则使用Bind系列。

文件

其实还有一类数据类型就是二进制流。这类以文件参数为代表。
假设参数如下：

后端服务：

func FileParamHandler(ctx * gin.Context){
	file,err:=ctx.FormFile("file")
	if err!=nil{
		glog.Error("getFile fail")
		ctx.JSON(http.StatusOK,"getFile fail")
		return
	}
	glog.Error("fileName",file.Filename)
	ctx.JSON(http.StatusOK,"OK")
}

请求结果

本次主要是调用了context的formFile函数

总结

gin作为web框架提供了丰富的api给我们解析web层参数，十分的灵活轻便。可以根据自己的需求选定。