go语言的成神之路-筑基篇-gin常用功能

@VON

发布于 2025-12-21 09:18:32

760

第一节- gin参数绑定

ShouldBind 是 gin 框架中的一个方法，用于将请求中的数据绑定到指定的结构体上。

ShouldBind简要概述

功能：
- 它会根据请求的 Content-Type 自动解析请求中的数据，并将其绑定到传入的结构体指针所指向的结构体中。
- 对于 GET 请求，它会尝试从查询参数中解析数据；对于 POST 请求，它会根据 Content-Type 进行不同的解析，例如 application/x-www-form-urlencoded 或 application/json 等。
使用场景：
- 当你需要从客户端请求中提取数据并存储到结构体中时，使用 ShouldBind 可以方便地将请求中的数据映射到结构体的字段上。
- 它会自动处理数据类型的转换，将请求中的字符串数据转换为结构体字段对应的类型。
可能的错误：
- 如果请求中的数据无法正确解析或转换为结构体字段的类型，ShouldBind 会返回错误。
- 例如，如果请求中某个字段的值无法转换为结构体中相应字段的类型（如将字符串 "abc" 转换为 int 类型），会导致绑定失败并返回错误。

实例代码

package main

import (
	"fmt"
	"net/http"

	"github.com/gin-gonic/gin"
)

// 定义结构体
type UserInfo struct {
	UserName string `form:"username"`
	Password string `form:"password"`
}

func main() {
	r := gin.Default()
	r.GET("/user", func(c *gin.Context) {
		var u UserInfo
		err := c.ShouldBind(&u)
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{
				"error": err.Error(),
			})
		} else {
			fmt.Printf("u:%#v\n", u)
			c.JSON(http.StatusOK, gin.H{
				"username": u.UserName,
				"password": u.Password,
			})
		}
	})

	
	r.Run(":1205")
}

效果展示

第二节-gin文件上传

选择要上传的文件

// 处理 POST 请求到 /upload 路径
	r.POST("/upload", func(c *gin.Context) {
		// 从请求中获取名为 f1 的文件
		f, err := c.FormFile("f1")
		if err != nil {
			// 记录错误信息
			log.Printf("Error retrieving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Failed to retrieve file",
			})
			return
		}
		// 验证文件大小，假设限制文件大小为 5MB
		if f.Size > 1024*1024*5 {
			// 记录文件大小超出限制的错误信息
			log.Printf("File size too large: %v", f.Size)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "File size exceeds limit",
			})
			return
		}
		// 验证文件类型，假设只允许 JPEG 和 PNG
		if f.Header.Get("Content-Type") != "image/jpeg" && f.Header.Get("Content-Type") != "image/png" {
			// 记录文件类型错误信息
			log.Printf("Invalid file type: %v", f.Header.Get("Content-Type"))
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Invalid file type",
			})
			return
		}
		// 构建保存文件的目标路径
		dst := path.Join("./", f.Filename)
		// 保存上传的文件
		if err := c.SaveUploadedFile(f, dst); err != nil {
			// 记录保存文件时的错误信息
			log.Printf("Error saving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusInternalServerError, gin.H{
				"error": "Failed to save file",
			})
			return
		}
		// 返回成功响应
		c.JSON(http.StatusOK, gin.H{
			"status": "ok",
		})
	})

对上传的文件进行相对应的操作。

选择要上传的文件。

效果展示

代码部分

因为前端部分较为简单，在这里就不再进行展示了。

package main

import (
	"log"
	"net/http"
	"path"

	"github.com/gin-gonic/gin"
)

func main() {
	// 创建一个默认的 gin 路由
	r := gin.Default()
	// 加载 index.html 文件
	r.LoadHTMLFiles("./index.html")
	// 处理 GET 请求到 /index 路径
	r.GET("/index", func(c *gin.Context) {
		// 渲染 index.html 文件
		c.HTML(http.StatusOK, "index.html", nil)
	})

	// 处理 POST 请求到 /upload 路径
	r.POST("/upload", func(c *gin.Context) {
		// 从请求中获取名为 f1 的文件
		f, err := c.FormFile("f1")
		if err != nil {
			// 记录错误信息
			log.Printf("Error retrieving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Failed to retrieve file",
			})
			return
		}
		// 验证文件大小，假设限制文件大小为 5MB
		if f.Size > 1024*1024*5 {
			// 记录文件大小超出限制的错误信息
			log.Printf("File size too large: %v", f.Size)
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "File size exceeds limit",
			})
			return
		}
		// 验证文件类型，假设只允许 JPEG 和 PNG
		if f.Header.Get("Content-Type") != "image/jpeg" && f.Header.Get("Content-Type") != "image/png" {
			// 记录文件类型错误信息
			log.Printf("Invalid file type: %v", f.Header.Get("Content-Type"))
			// 返回错误响应
			c.JSON(http.StatusBadRequest, gin.H{
				"error": "Invalid file type",
			})
			return
		}
		// 构建保存文件的目标路径
		dst := path.Join("./", f.Filename)
		// 保存上传的文件
		if err := c.SaveUploadedFile(f, dst); err != nil {
			// 记录保存文件时的错误信息
			log.Printf("Error saving file: %v", err)
			// 返回错误响应
			c.JSON(http.StatusInternalServerError, gin.H{
				"error": "Failed to save file",
			})
			return
		}
		// 返回成功响应
		c.JSON(http.StatusOK, gin.H{
			"status": "ok",
		})
	})
	// 启动服务器，监听 1205 端口
	r.Run(":1205")
}