golang gin后端开发框架（二）：解析request与构建response

1. 实体绑定

以一个用户注册功能来进行表单实体绑定操作

用户注册需要提交表单数据，假设注册时表单数据包含三项：

• username
• phone
• password

我们创建一个UserRegister结构体用于接收表单数据，通过tag标签的方式设置每个字段对应的form表单中的属性名，通过binding字段设置该属性是否为必须

type UserRegister struct {
	Username string `form:"username" binding:"required"`
	Phone    string `form:"phone" binding:"required"`
	Password string `form:"password" binding:"required"`
}

 

1.1 ShouldBindQuery解析GET参数

使用ShouldBindQuery可以实现Get方法的数据请求绑定，具体实现如下：

// get
// http://localhost:8080/register?name=james&phone=8888&password=123456
engine.GET("/register",func(ctx *gin.Context) {
	var user UserRegister
	err:=ctx.ShouldBindQuery(&user)
	if err!=nil{
		log.Fatal(err.Error())
	}
	ctx.Writer.Write([]byte("hello "+user.Username))
})

 

1.2 ShouldBind解析POST参数

// post
// http://localhost:8080/register
engine.POST("/register", func(ctx *gin.Context) {
	var user UserRegister
	err := ctx.ShouldBind(&user)
	if err != nil {
		log.Fatal(err.Error())
	}
	ctx.Writer.Write([]byte("hello " + user.Username))
})

 

1.3 BindJSON解析POST请求json格式数据

// post
// http://localhost:8080/addstu
engine.POST("/addstu", func(ctx *gin.Context) {
	var stu Student
	err := ctx.BindJSON(&stu)
	if err != nil {
		log.Fatal(err.Error())
	}
	ctx.Writer.Write([]byte("hello " + stu.Name))
})

 

2. 多数据格式返回请求结果

在gin框架中，支持多种返回请求数据格式

 

2.1 []byte

通过context.Writer.Write方法写入byte切片数据

ctx.Writer.Write([]byte("hello " + stu.Name))

 

如上面这句代码所示，使用context.Writer.Write向客户端写入返回数据

Writer是gin框架中封装的一个ResponseWriter接口类型，在这个interface中包含了met/http标准库下的ResponseWriter

 

2.2 string

通过context.Writer.WriteString方法写入string类型数据

ctx.Writer.WriteString("hello " + stu.Name)

 

2.3 json

gin为了方便开发者更方便地使用，支持将返回数据组装成json格式进行返回

gin框架中的context包含的json方法可以将结构体数据转成json格式的结构化数据，然后返回给客户端

 

2.3.1 map -> json

// get json
// http://localhost:8080/hellojson
engine.GET("/hellojson", func(ctx *gin.Context) {
	ctx.JSON(200, map[string]interface{}{
		"code":    1,
		"message": "ok",
		"data":    ctx.FullPath(),
	})
})

 

2.3.2 struct -> json

// get json
// http://localhost:8080/hellojson
engine.GET("/hellojson", func(ctx *gin.Context) {
	resp := Response{
		Code:    1,
		Message: "ok",
		Data:    ctx.FullPath(),
	}
	ctx.JSON(200, &resp)
})

 

2.4 html模版和静态资源

当我们需要返回一个html页面或者一些静态资源（图片等）时，gin也提供了一些方法

首先我们需要创建一个html模版，前后端交互的模版语句很简单，就是使用{{}}来表示这是一个模版变量

{{.title}}
{{.fullPath}}

 

然后我们在后端注册路由，完成html模版的渲染

需要注意的是，gin必须要先设置html目录为可加载状态，才可以向客户端返回html

// get html
// http://localhost:8080/hellohtml

// 设置html目录
engine.LoadHTMLGlob("./html/*")

// 如果html里包含图片
engine.Static("/img", "./img")

engine.GET("/hellohtml", func(ctx *gin.Context) {
	ctx.HTML(http.StatusOK, "index.html", gin.H{
		"title":    "hello gin",
		"fullPath": ctx.FullPath(),
	})
})

在项目开发时，一些静态的资源文件如html、js、css等都可以通过静态资源文件设置的方式来进行设置