Gin 中 c.BindJSON与 c.JSON的实现示例

在 Gin 中，c.BindJSON 和 c.JSON 是前后端交互的两个核心操作，它们构成了数据从前端到后端再返回前端的完整链路。

1.c.BindJSON：接收前端数据

假设前端发送 POST 请求：

{"title":"学Gin","status":false}

后端代码：

var body struct {
    Title  string `json:"title"`
    Status bool   `json:"status"`
}
c.BindJSON(&body)

赋值过程详解：

1. 读取 Body

   • Gin 从 HTTP 请求中获取请求 Body。
   • Body 是原始 JSON 数据：{"title":"学Gin","status":false}

2. 解析 JSON

   • Gin 调用 Go 标准库 encoding/json 对 JSON 进行解析。

3. 结构体字段匹配

   • 标签 json:"title" 对应 Go 的 Title
   • 标签 json:"status" 对应 Go 的 Status

4. 填充值

   • "title":"学Gin" → body.Title = "学Gin"
   • "status":false → body.Status = false

此时，结构体 body 中的数据已经完全对应前端发送的数据。

fmt.Println(body.Title)  // 输出: 学Gin
fmt.Println(body.Status) // 输出: false

总结：c.BindJSON 的作用是“拆包 + 填字段”，把前端 JSON 数据装入 Go 结构体中，方便后续业务逻辑使用。

2.c.JSON：返回数据给前端

处理完数据后，后端需要把结果返回给前端，常用方法是 c.JSON。

c.JSON(200, gin.H{
    "message": "创建成功",
    "todo":    body,
})

执行过程：

1. 接收 Go 对象

   • gin.H 是 map[string]interface{} 的简写，用于快速构造 JSON 数据
   • 结构体 body 也可以直接返回

2. 序列化 JSON

   • Gin 内部使用 encoding/json.Marshal 将 Go 对象转换成 JSON 字符串
   • 结构体标签 json:"..." 决定了 JSON 字段名
     • Title → "title"
     • Status → "status"

3. 返回 HTTP 响应

   • 状态码 200
   • 响应 Body 为 JSON 字符串：

{
  "message": "创建成功",
  "todo": {
    "title": "学Gin",
    "status": false
  }
}

总结：c.JSON 的作用是“打包 + 发快递”，把 Go 对象转换成 JSON 返回给前端。

3. 前后端完整交互流程

前端 JSON.stringify → 发 POST 请求
        ↓
Gin c.BindJSON → 装进结构体
        ↓
业务逻辑处理
        ↓
Gin c.JSON → 转 JSON → 返回前端
        ↓
前端 JSON.parse → 更新页面

示例代码：

type Todo struct {
    Title  string `json:"title"`
    Status bool   `json:"status"`
}

r.POST("/todos", func(c *gin.Context) {
    var body Todo
    if err := c.BindJSON(&body); err != nil {
        c.JSON(400, gin.H{"error": err.Error()})
        return
    }

    // 假设保存数据库成功
    c.JSON(200, gin.H{
        "message": "创建成功",
        "todo":    body,
    })
})

4. 总结

结合使用 c.BindJSON + c.JSON，就完成了前后端的数据闭环，实现了完整的请求处理和响应返回。

到此这篇关于Gin 中 c.BindJSON与 c.JSON的实现示例的文章就介绍到这了,更多相关Gin c.BindJSON与 c.JSON内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论