本文内容纲要：

- Golang使用validator进行数据校验及自定义翻译器

- 一、概述

- 二、操作符说明

- 三、常用标记说明

- 四、标记使用注意

- 五、使用示例

- 六、gin框架中使用验证翻译器

- 1. 定义错误翻译器

- 2.使用
Golang使用validator进行数据校验及自定义翻译器

包下载：go get github.com/go-playground/validator/v10

一、概述

在接口开发经常会遇到一个问题是后端需要写大量的繁琐代码进行数据校验，所以就想着有没有像前端校验一样写规则进行匹配校验，然后就发现了validator包，一个比较强大的校验工具包下面是一些学习总结，详细内容可以查看validator

二、操作符说明

标记 标记说明
, 多操作符分割
| 或操作
- 跳过字段验证

三、常用标记说明

validate:"required"validate:"omitempty"validate:"len=0"validate:"eq=0"validate:"gt=0"validate:"gte=0"validate:"lt=0"validate:"lte=0"validate:"eqfield=Field2"validate:"nefield=Field2"validate:"gtfield=Field2"validate:"gtefield=Field2"validate:"ltfield=Field2"validate:"ltefield=Field2"validate:"eqcsfield=Struct2.Field2"validate:"necsfield=Struct2.Field2"validate:"gtcsfield=Struct2.Field2"validate:"gtecsfield=Struct2.Field2"validate:"ltcsfield=Struct2.Field2"validate:"ltecsfield=Struct2.Field2"validate:"min=1"validate:"max=2"validate:"structonly"validate:"nostructlevel"validate:"gt=0,dive,len=1,dive,required"validate:"gt=0,dive,keys,eq=1|eq=2,endkeys,required"validate:"required_with=Field1 Field2"validate:"required_with_all=Field1 Field2"validate:"required_without_all=Field1 Field2"validate:"isdefault=0"validate:"oneof=5 7 9"validate:"containsfield=Field2"validate:"excludesfield=Field2"validate:"unique"validate:"alphanum"validate:"alphaunicode"validate:"alphanumunicode"validate:"numeric"validate:"hexadecimal"validate:"hexcolor"validate:"lowercase"validate:"uppercase"validate:"email"validate:"json"validate:"file"validate:"url"validate:"uri"validate:"base64"validate:"contains=@"validate:"containsany=abc"validate:"containsrune=☢"validate:"excludes=@"validate:"excludesall=abc"validate:"containsrune=☢"validate:"startswith=abc"validate:"endswith=abc"validate:"ip"validate:"ipv4"validate:"datetime"

四、标记使用注意

1、当搜索条件与特殊标记冲突时,如：逗号（,），或操作（|），中横线（-）等则需要使用 UTF-8十六进制表示形式

例：

type Test struct {
   Field1 string  `validate:"excludesall=|"`    // 错误
   Field2 string `validate:"excludesall=0x7C"` // 正确.
}

2、可通过validationErrors := errs.(validator.ValidationErrors)获取错误对象自定义返回响应错误

3、自定义校验结果翻译

// 初始化翻译器
func validateInit() {
	zh_ch := zh.New()
	uni := ut.New(zh_ch)               // 万能翻译器，保存所有的语言环境和翻译数据
	Trans, _ = uni.GetTranslator("zh") // 翻译器
	Validate = validator.New()
	_ = zh_translations.RegisterDefaultTranslations(Validate, Trans)
	// 添加额外翻译
	_ = Validate.RegisterTranslation("required_without", Trans, func(ut ut.Translator) error {
		return ut.Add("required_without", "{0} 为必填字段!", true)
	}, func(ut ut.Translator, fe validator.FieldError) string {
		t, _ := ut.T("required_without", fe.Field())
		return t
	})
}

五、使用示例

package main
import (
   "fmt"
   "github.com/go-playground/validator/v10"
)
// 实例化验证对象
var validate = validator.New()
func main() {
   // 结构体验证
   type Inner struct {
      String string `validate:"contains=111"`
   }
   inner := &Inner{String: "11@"}
   errs := validate.Struct(inner)
   if errs != nil {
      fmt.Println(errs.Error())
   }
   // 变量验证
   m := map[string]string{"": "", "val3": "val3"}
   errs = validate.Var(m, "required,dive,keys,required,endkeys,required")
   if errs != nil {
      fmt.Println(errs.Error())
   }
}

六、gin框架中使用验证翻译器

1. 定义错误翻译器

//validator.go
// 定义一个全局翻译器
var trans ut.Translator

// InitTrans 初始化翻译器
func InitTrans(locale string) (err error) {
	//修改gin框架中的Validator属性，实现自定制
	if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
		// 注册一个获取json tag的自定义方法
		v.RegisterTagNameFunc(func(fld reflect.StructField) string {
			name := strings.SplitN(fld.Tag.Get("json"), ",", 2)[0]
			if name == "-" {
				return ""
			}
			return name
		})

		zhT := zh.New() //中文翻译器
		enT := en.New() //英文翻译器

		// 第一个参数是备用（fallback）的语言环境
		// 后面的参数是应该支持的语言环境（支持多个）
		// uni := ut.New(zhT, zhT) 也是可以的
		uni := ut.New(enT, zhT, enT)

		// locale 通常取决于 http 请求头的 'Accept-Language'
		var ok bool
		// 也可以使用 uni.FindTranslator(...) 传入多个locale进行查找
		trans, ok = uni.GetTranslator(locale)
		if !ok {
			return fmt.Errorf("uni.GetTranslator(%s) failed", locale)
		}

		// 添加额外翻译
		_ = v.RegisterTranslation("required_with", trans, func(ut ut.Translator) error {
			return ut.Add("required_with", "{0} 为必填字段!", true)
		}, func(ut ut.Translator, fe validator.FieldError) string {
			t, _ := ut.T("required_with", fe.Field())
			return t
		})
		_ = v.RegisterTranslation("required_without", trans, func(ut ut.Translator) error {
			return ut.Add("required_without", "{0} 为必填字段!", true)
		}, func(ut ut.Translator, fe validator.FieldError) string {
			t, _ := ut.T("required_without", fe.Field())
			return t
		})
		_ = v.RegisterTranslation("required_without_all", trans, func(ut ut.Translator) error {
			return ut.Add("required_without_all", "{0} 为必填字段!", true)
		}, func(ut ut.Translator, fe validator.FieldError) string {
			t, _ := ut.T("required_without_all", fe.Field())
			return t
		})

		// 注册翻译器
		switch locale {
		case "en":
			err = enTranslations.RegisterDefaultTranslations(v, trans)
		case "zh":
			err = zhTranslations.RegisterDefaultTranslations(v, trans)
		default:
			err = enTranslations.RegisterDefaultTranslations(v, trans)
		}
		return
	}
	return
}

func addValueToMap(fields map[string]string) map[string]interface{} {
	res := make(map[string]interface{})
	for field, err := range fields {
		fieldArr := strings.SplitN(field, ".", 2)
		if len(fieldArr) > 1 {
			NewFields := map[string]string{fieldArr[1]: err}
			returnMap := addValueToMap(NewFields)
			if res[fieldArr[0]] != nil {
				for k, v := range returnMap {
					res[fieldArr[0]].(map[string]interface{})[k] = v
				}
			} else {
				res[fieldArr[0]] = returnMap
			}
			continue
		} else {
			res[field] = err
			continue
		}
	}
	return res
}

// 去掉结构体名称前缀
func removeTopStruct(fields map[string]string) map[string]interface{} {
	lowerMap := map[string]string{}
	for field, err := range fields {
		fieldArr := strings.SplitN(field, ".", 2)
		lowerMap[fieldArr[1]] = err
	}
	res := addValueToMap(lowerMap)
	return res
}

//handler中调用的错误翻译方法
func ErrResp(err error) *gin.H {
	errs, ok := err.(validator.ValidationErrors)
	fmt.Println(reflect.TypeOf(err))
	if !ok {
		return &gin.H{
			"errCode": -1,
			"errMsg":  err.Error(), // 翻译校验错误提示
		}
	}
	return &gin.H{
		"errCode": -1,
		"errMsg":  removeTopStruct(errs.Translate(trans)), // 翻译校验错误提示
	}
}

2.使用

//router.go
//初始化翻译器，这部分可放在main.go或router.go中
if err := util.InitTrans("zh"); err != nil {
		log.Fatalf("init trans failed, err:%v\n", err)
		return
}

//handler.go
//翻译错误
func (h handler) Login(c *gin.Context) {
    req := models.LoginReq{}
    err := c.ShouldBindWith(&req, binding.JSON)
	if err != nil {
		c.JSON(http.StatusBadRequest, util.ErrResp(err)) //这里调用翻译
		return
	}
}

本文内容总结：Golang使用validator进行数据校验及自定义翻译器，一、概述，二、操作符说明，三、常用标记说明，四、标记使用注意，五、使用示例，六、gin框架中使用验证翻译器，1. 定义错误翻译器，2.使用，

原文链接：https://www.cnblogs.com/zj420255586/p/13542395.html