导包

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")
})