Gin 接收前端传参几种方式小结

package main
import "github.com/gin-gonic/gin"
func main() {
	r := gin.Default()
	// 定义路由：:id 是路径参数
	r.GET("/user/:id", func(c *gin.Context) {
		// 使用 c.Param() 获取路径参数
		id := c.Param("id")
		c.JSON(200, gin.H{
			"用户ID": id,
		})
	})
	r.Run(":8080")
}

r.GET("/search", func(c *gin.Context) {
	// 1. 普通获取（没传就是空字符串）
	keyword := c.Query("keyword")

	// 2. 带默认值获取
	page := c.DefaultQuery("page", "1")

	c.JSON(200, gin.H{
		"关键词": keyword,
		"页码":   page,
	})
})

r.POST("/login", func(c *gin.Context) {
	// 1. 普通获取
	username := c.PostForm("username")
	// 2. 带默认值
	password := c.DefaultPostForm("password", "123456")
	c.JSON(200, gin.H{
		"账号": username,
		"密码": password,
	})
})

// 1. 先定义结构体（对应 JSON 字段）
type User struct {
	Name string `json:"name"` // 注意 tag 是 json
	Age  int    `json:"age"`
}
r.POST("/register", func(c *gin.Context) {
	var user User
	// 2. 使用 ShouldBindJSON 绑定 JSON 到结构体
	if err := c.ShouldBindJSON(&user); err != nil {
		c.JSON(400, gin.H{"错误": err.Error()})
		return
	}
	c.JSON(200, gin.H{
		"注册成功": user,
	})
})

fetch('http://127.0.0.1:8080/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: "张三", age: 18 })
})

r.POST("/upload", func(c *gin.Context) {
	// 1. 获取上传的文件
	file, err := c.FormFile("avatar")
	if err != nil {
		c.JSON(400, gin.H{"错误": "上传失败"})
		return
	}
	// 2. 保存到本地
	c.SaveUploadedFile(file, "./"+file.Filename)
	c.JSON(200, gin.H{
		"文件名": file.Filename,
		"大小":   file.Size,
	})
})

// 定义结构体，tag 同时支持 query 和 json
type SearchParams struct {
	Keyword string `form:"keyword" json:"keyword"`
	Page    int    `form:"page" json:"page"`
}
r.GET("/search2", func(c *gin.Context) {
	var params SearchParams
	// 自动根据请求类型绑定（Query/Form/JSON）
	if err := c.ShouldBind(&params); err != nil {
		c.JSON(400, gin.H{"错误": err.Error()})
		return
	}
	c.JSON(200, params)
})