18、Go Gin框架中的binding验证器使用

一、binding功能介绍

Gin的binding包提供了一组功能,用于将请求的数据自动绑定到结构体,并根据结构体标签进行数据验证。常用的标签有bindingvalidate,通过这些标签可以指定数据的类型和验证规则。

常见标签

  • binding:"required":表示该字段为必填项

  • binding:"-":忽略该字段,不进行绑定

  • validate:"max=10":表示该字段的值不能超过10

  • validate:"min=1":表示该字段的值不能小于1

  • validate:"email":表示该字段必须是合法的邮箱格式

结构体定义示例

Go 复制代码
type User struct {
	Name  string `json:"name" binding:"required" validate:"min=3,max=20"`
	Email string `json:"email" binding:"required" validate:"email"`
	Age   int    `json:"age" binding:"required" validate:"min=1,max=100"`
}

在上述示例中,我们定义了一个User结构体,并为每个字段添加了binding和validate标签,指定了各字段的绑定和验证规则。

二、Gin中使用binding和验证器

1. 安装Gin和validator

首先,我们需要安装Gin框架和validator库,可以使用以下命令进行安装:

Go 复制代码
go get -u github.com/gin-gonic/gin
go get -u github.com/go-playground/validator/v10

go-playground/validator是一个用于 Go 语言的结构体和字段验证包。它具有以下特点:

  • 支持跨字段和跨结构体验证

  • 支持自定义验证器

  • 提供丰富的验证约束

  • 易于使用

以下是该包的一些常见用途:

  • 验证 API 请求参数

  • 验证表单数据

  • 验证数据库模型

2. 绑定数据并验证

在Gin中,我们可以通过ShouldBindShouldBindJSON方法将请求的数据绑定到结构体,并进行验证。下面是一个具体的示例:

Go 复制代码
package main

import (
	"github.com/gin-gonic/gin"
	"github.com/go-playground/validator/v10"
	"net/http"
)

// User 结构体
type User struct {
	Name  string `json:"name" binding:"required" validate:"min=3,max=20"`
	Email string `json:"email" binding:"required" validate:"email"`
	Age   int    `json:"age" binding:"required" validate:"min=1,max=100"`
}

// CustomValidator 自定义验证器
type CustomValidator struct {
	validate *validator.Validate
}

// ValidateStruct 验证结构体
func (cv *CustomValidator) ValidateStruct(obj interface{}) error {
	if err := cv.validate.Struct(obj); err != nil {
		return err
	}
	return nil
}

// Main 函数
func main() {
	r := gin.Default()
	//中间件实现验证器验证
	r.Use(func(c *gin.Context) {
		cv := &CustomValidator{validate: validator.New()}
		c.Set("validator", cv)
	})

	//{"name":"shiph","email":"123@qq.com","age":31}
	r.POST("/user", func(c *gin.Context) {
		var user User
		if err := c.ShouldBind(&user); err != nil { //绑定
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}

		if v, ok := c.MustGet("validator").(*CustomValidator); ok { //校验
			if err := v.ValidateStruct(&user); err != nil {
				c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
				return
			}
		}
		c.JSON(http.StatusOK, gin.H{"message": "用户创建成功!", "user": user})
	})

	r.Run()
}

3. 自定义验证器

有时,内置的验证器无法满足我们的需求,我们可以定义自己的验证器。例如,我们希望验证用户名不能包含特殊字符,可以通过自定义验证器实现:

Go 复制代码
package main

import (
	"fmt"
	"github.com/gin-gonic/gin"
	"github.com/go-playground/validator/v10"
	"net/http"
	"strings"
	"unicode"
)

// User 结构体
type User struct {
	Name  string `json:"name" binding:"required" validate:"min=3,max=20"`
	Email string `json:"email" binding:"required" validate:"email"`
	Age   int    `json:"age" binding:"required" validate:"min=1,max=100"`
}

func isValidUsername(fl validator.FieldLevel) bool {
	username := fl.Field().String()
	for _, char := range username {
		if !unicode.IsLetter(char) && !unicode.IsDigit(char) {
			return false
		}
	}
	return true
}


func main() {
	r := gin.Default()
	validate := validator.New()
	//通过validate.RegisterValidation方法注册了一个自定义验证器isValidUsername,用于验证用户名是否包含特殊字符
	validate.RegisterValidation("username", isValidUsername)

	r.POST("/user", func(c *gin.Context) {
		var user User
		if err := c.ShouldBind(&user); err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}

		if err := validate.Struct(user); err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}

		c.JSON(http.StatusOK, gin.H{"message": "创建用户成功!", "user": user})
	})

	r.Run()
}

在上述示例中,我们通过validate.RegisterValidation方法注册了一个自定义验证器isValidUsername,用于验证用户名是否包含特殊字符。

四、错误处理

在实际开发中,数据验证错误需要及时反馈给客户端。Gin的binding验证器会在数据验证失败时返回详细的错误信息,我们可以根据这些错误信息进行处理:

Go 复制代码
func handleError(err error) string {
	if errs, ok := err.(validator.ValidationErrors); ok {
		var errMsgs []string
		for _, e := range errs {
			errMsgs = append(errMsgs, fmt.Sprintf("Field: %s, Error: %s", e.Field(), e.Tag()))
		}
		return strings.Join(errMsgs, ", ")
	}
	return err.Error()
}

通过上述handleError函数,我们可以将验证错误格式化为易于阅读的错误信息。

五、总结

Gin框架中的binding验证器为我们提供了简便的数据绑定和验证功能,通过合理使用binding和validate标签,我们可以确保API接口的数据合法性和完整性。此外,结合自定义验证器和错误处理机制,可以进一步提高数据验证的灵活性和用户体验。

相关推荐
-凌凌漆-22 分钟前
【Qt】QStringLiteral 介绍
开发语言·qt
程序员爱钓鱼22 分钟前
Go语言项目工程化 — 常见开发工具与 CI/CD 支持
开发语言·后端·golang·gin
军训猫猫头1 小时前
1.如何对多个控件进行高效的绑定 C#例子 WPF例子
开发语言·算法·c#·.net
真的想上岸啊1 小时前
学习C++、QT---18(C++ 记事本项目的stylesheet)
开发语言·c++·学习
明天好,会的1 小时前
跨平台ZeroMQ:在Rust中使用zmq库的完整指南
开发语言·后端·rust
丁劲犇2 小时前
用 Turbo Vision 2 为 Qt 6 控制台应用创建 TUI 字符 MainFrame
开发语言·c++·qt·tui·字符界面·curse
旷世奇才李先生2 小时前
Next.js 安装使用教程
开发语言·javascript·ecmascript
charlie1145141913 小时前
深入理解Qt的SetWindowsFlags函数
开发语言·c++·qt·原理分析
likeGhee3 小时前
python缓存装饰器实现方案
开发语言·python·缓存
whoarethenext4 小时前
使用 C++/Faiss 加速海量 MFCC 特征的相似性搜索
开发语言·c++·faiss