导包
go get -u github.com/gin-gonic/gin
如果导包失败则检查是否更改了goproxy,原先的goproxy被墙了。
go env -w GOPROXY=https://goproxy.cn,direct //配置GOPROXY,永久生效
fresh热加载
热加载:在每次代码更改保存的时候自动重启项目。
go install github.com/pilu/fresh@latest
执行后会在GOPATH/bin下面生成fresh.exe,之后则可以用fresh代替go run main.go。
如果在命令行输入fresh时,出现:
fresh : 无法将“fresh”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
发送请求案例
DELETE、PUT同理
func main() {engine := gin.Default() //创建引擎//配置路由 engine.GET("/", func(c *gin.Context) {c.JSON(200, gin.H{"name": "yi"})//这里也可以输入一个结构体类型})engine.POST("/w", func(c *gin.Context) {c.String(200, "hello %s", "u")})engine.Run(":8080")
}
其中gin.H是map[string]any的别名
URL参数查询
GET请求参数
url为: http://localhost:8080/?name=yi&age=18
engine.GET("/", func(c *gin.Context) {name := c.Query("name")age := c.DefaultQuery("age", "20")//如果参数中没有age,则age为20c.JSON(http.StatusOK, gin.H{"name": name,"age": age,})})
POST请求参数
前端代码:点击提交按钮后,会向/doAddUser发送携带表单数据的post请求。
<form action="/doAddUser" method="post">姓名<input type="text" name="username">密码<input type="password" name="password"><input type="submit" value="提交">
</form>
获取前端中表单的输入:
engine.POST("/doAddUser", func(c *gin.Context) {username := c.PostForm("username")password := c.PostForm("password")age := c.DefaultPostForm("age", "20")//获取不到则默认为20c.JSON(http.StatusOK, gin.H{"username": username,"password": password,"age":age,})})
请求参数绑定到结构体(POST请求同理)
GET请求地址:http://localhost:8080/pwd?name=yi&age=1
engine.GET("/pwd", func(c *gin.Context) {type Student struct {Name string `json:"name" form:"name"`Age int `form:"age"`}var stu Studentif err := c.ShouldBind(&stu); err != nil {c.JSON(http.StatusOK, gin.H{"err": err,})} else {fmt.Println(stu)c.JSON(http.StatusOK, stu)}})
需要注意:绑定的结构体字段需要大写(用到了反射机制),并且要带上form标签。
form标签表示从请求/表单获取数据时对应的字段。
json标签表示结构体转化为json时的字段名,c.JSON(Status,stu)会返回{name:“yi”,Age:“1”}
解析 POST raw-xml数据
engine.POST("/xml", func(c *gin.Context) {type Article struct {Name string `xml:"name" json:"name"`}article:=Article{}rawData, _ := c.GetRawData()//从request.body中获取原始数据//将xml解析成结构体if err := xml.Unmarshal(rawData, &article);err!=nil{c.JSON(200,gin.H{"err":err})}else{c.JSON(200,article)}})
获取动态路由参数
请求地址:http://localhost:8080/lists/15
engine.GET("/lists/:id", func(c *gin.Context) {id := c.Param("id") //id =15c.JSON(200, gin.H{"id": id})})
路由组
g := engine.Group("/admin"){g.GET("/v2", func(c *gin.Context) {c.String(200, "admin/v2")})g.GET("/v3", func(c *gin.Context) {c.String(200, "admin/v3")})}
项目分离
分为Controller、Routers、MiddleWare。
Controller(控制器):用于存放路由组的处理函数。func(c *gin.Context) {})
Routers:对路由组进行注册。
中间件
c.Next() 先去执行其他程序,最后返回来执行
c.Abort() 终止后继该请求的剩余处理程序,当前中间件仍然执行。
c.Set(“Key”,“Value”) 设置中间件共享变量
c.Get(“Key”) 获取中间件共享变量
engine.Use(middleWare) 注册全局中间件
gin.Default() 默认使用了Logger()、Recovery()中间件
中间件使用goroutine时,不能直接用c,要使用c.Copy(),不会影响客户端的响应。
func CountTime(c *gin.Context) {start := time.Now()c.Next() //执行其他的中间件,最后返回来执行自己end := time.Now()println(end.Sub(start).String())
}
//......
g.GET("/v2",CountTime ,func(c *gin.Context) {time.Sleep(time.Second)c.String(200, "admin/v2")
})