Golang驗(yàn)證器之validator怎么使用

本文小編為大家詳細(xì)介紹“Golang驗(yàn)證器之validator怎么使用”，內(nèi)容詳細(xì)，步驟清晰，細(xì)節(jié)處理妥當(dāng)，希望這篇“Golang驗(yàn)證器之validator怎么使用”文章能幫助大家解決疑惑，下面跟著小編的思路慢慢深入，一起來(lái)學(xué)習(xí)新知識(shí)吧。

什么是validator

Validator 是一個(gè) Golang 的第三方庫(kù)，用于對(duì)數(shù)據(jù)進(jìn)行校驗(yàn)，常用于 API 的開(kāi)發(fā)中，對(duì)客戶(hù)端發(fā)出的請(qǐng)求數(shù)據(jù)進(jìn)行嚴(yán)格校驗(yàn)，防止惡意請(qǐng)求。

安裝

validator包安裝：

go get -u github.com/go-playground/validator/v10

使用方法

導(dǎo)入validator：

import "github.com/go-playground/validator/v10"

validator 應(yīng)用了 Golang 的 Struct Tag 和 Reflect機(jī)制，基本思想是：在 Struct Tag 中為不同的字段定義各自類(lèi)型的約束，然后通過(guò) Reflect 獲取這些約束的類(lèi)型信息并在校驗(yàn)器中進(jìn)行數(shù)據(jù)校驗(yàn)。

示例：

package main

import (
	"fmt"
	"github.com/go-playground/validator/v10"
)

type User struct {
	UserName string `json:"user_name" validate:"required"`
	Password string `json:"password" validate:"required,min=6,max=20"`
}
func main() {
	example := User{
		Password: "123",
	}
 
	//實(shí)例化驗(yàn)證器
	validate  := validator.New() 

	errs := validate.Struct(example)
	if errs != nil {
		for _, err := range errs.(validator.ValidationErrors) {
			fmt.Println(err)
		}
	}

}

validator包的驗(yàn)證提示默認(rèn)是英文的，輸出如下：

這樣看可能不太清楚，如果需要翻譯成中文則還需安裝驗(yàn)證提示翻譯包：

go get -u github.com/go-playground/locales
go get -u github.com/go-playground/universal-translator

修改后如下:

package main

import (
	"fmt"
	"github.com/go-playground/locales/zh"
	ut "github.com/go-playground/universal-translator"
	"github.com/go-playground/validator/v10"
	zh_translations "github.com/go-playground/validator/v10/translations/zh"
)

type User struct {
	UserName string `json:"user_name" validate:"required"`
	Password string `json:"password" validate:"required,min=6,max=20"`
}
func main() {
	example := User{
		Password: "123",
	}
	// 中文翻譯器
	uni := ut.New(zh.New())
	trans, _ := uni.GetTranslator("zh")

	//實(shí)例化驗(yàn)證器
	validate  := validator.New()
	// 注冊(cè)翻譯器到校驗(yàn)器
	err := zh_translations.RegisterDefaultTranslations(validate, trans)
	if err!=nil {
		fmt.Println(err)
		return
	}

	errs := validate.Struct(example)
	if errs != nil {
		for _, err := range errs.(validator.ValidationErrors) {
			fmt.Println(err.Translate(trans))
		}
	}

}

執(zhí)行輸出：

校驗(yàn)規(guī)則

下面列舉一部分我們開(kāi)發(fā)中經(jīng)常用到的驗(yàn)證規(guī)則

跨字段驗(yàn)證

validator 允許定義跨字段驗(yàn)證，即：驗(yàn)證某個(gè)字段與其他字段之間的關(guān)系。這種驗(yàn)證實(shí)際上分為兩種：

• 一種是參數(shù)字段就是同一個(gè)結(jié)構(gòu)體中的平級(jí)字段。

• 另一種是參數(shù)字段為結(jié)構(gòu)中其他字段的字段。

驗(yàn)證語(yǔ)法很簡(jiǎn)單，如果是驗(yàn)證同一個(gè)結(jié)構(gòu)中的字段，則在基礎(chǔ)的 Tags 后面添加一個(gè) field 后綴，例如：eqfield 定義字段間的相等（eq）約束。如果是更深層次的字段，在 field 之前還需要加上 cs（Cross-Struct），eq 就變?yōu)榱?eqcsfield。

• eqfield=Field：必須等于 Field 的值。

• nefield=Field：必須不等于 Field 的值。

• gtfield=Field：必須大于 Field 的值。

• gtefield=Field： 必須大于等于 Field 的值。

• ltfield=Field：必須小于 Field 的值。

• ltefield=Field：必須小于等于 Field 的值。

• eqcsfield=Other.Field：必須等于 struct Other 中 Field 的值。

• necsfield=Other.Field：必須不等于 struct Other 中 Field 的值。

• gtcsfield=Other.Field：必須大于 struct Other 中 Field 的值；

• gtecsfield=Other.Field：必須大于等于 struct Other 中 Field 的值。

• ltcsfield=Other.Field：必須小于 struct Other 中 Field 的值。

• ltecsfield=Other.Field：必須小于等于 struct Other 中 Field 的值。

另外還有幾個(gè)常用的 Tag：

• required_with=Field1 Field2：在 Field1 或者 Field2 存在時(shí)，必須；

• required_with_all=Field1 Field2：在 Field1 與 Field2 都存在時(shí)，必須；

• required_without=Field1 Field2：在 Field1 或者 Field2 不存在時(shí)，必須；

• required_without_all=Field1 Field2：在 Field1 與 Field2 都存在時(shí)，必須；

錯(cuò)誤處理

通過(guò)看源碼，我們可以看到validator 返回的錯(cuò)誤有兩種，一種是參數(shù)錯(cuò)誤，一種是校驗(yàn)錯(cuò)誤，它們都實(shí)現(xiàn)了 error 接口。

• 參數(shù)錯(cuò)誤時(shí)，返回 InvalidValidationError 類(lèi)型；

• 校驗(yàn)錯(cuò)誤時(shí)，返回 ValidationErrors 類(lèi)型。ValidationErrors 是一個(gè)錯(cuò)誤切片，保存了每個(gè)字段違反的每個(gè)約束信息。

所以 validator 校驗(yàn)返回的結(jié)果有 3 種情況：

• nil：沒(méi)有錯(cuò)誤；

• InvalidValidationError：輸入?yún)?shù)錯(cuò)誤；

• ValidationErrors：字段違反約束。

validator 返回的錯(cuò)誤有兩種，一種是參數(shù)錯(cuò)誤，一種是校驗(yàn)錯(cuò)誤，它們都實(shí)現(xiàn)了 error 接口。

參數(shù)錯(cuò)誤時(shí)，返回 InvalidValidationError 類(lèi)型；

校驗(yàn)錯(cuò)誤時(shí)，返回 ValidationErrors 類(lèi)型。ValidationErrors 是一個(gè)錯(cuò)誤切片，保存了每個(gè)字段違反的每個(gè)約束信息。

所以 validator 校驗(yàn)返回的結(jié)果只有 3 種情況：

nil：沒(méi)有錯(cuò)誤；

InvalidValidationError：輸入?yún)?shù)錯(cuò)誤；

ValidationErrors：字段違反約束。

我們可以在程序中判斷 err != nil 時(shí)，可以依次將 err轉(zhuǎn)換為 InvalidValidationError 和 ValidationErrors 以獲取更詳細(xì)的信息：

err := validate.Struct(user)
if err != nil {
    invalid, ok := err.(*validator.InvalidValidationError)
      if ok {
        fmt.Println("param error:", invalid)
        return
    }
    
    validationErrs := err.(validator.ValidationErrors)
    for _, validationErr := range validationErrs {
        fmt.Println(validationErr)
    }
}

讀到這里，這篇“Golang驗(yàn)證器之validator怎么使用”文章已經(jīng)介紹完畢，想要掌握這篇文章的知識(shí)點(diǎn)還需要大家自己動(dòng)手實(shí)踐使用過(guò)才能領(lǐng)會(huì)，如果想了解更多相關(guān)內(nèi)容的文章，歡迎關(guān)注億速云行業(yè)資訊頻道。