Iris 不包含用于验证请求数据(例如“模型”)的内置方法。但是,你没有被限制。在此示例中,我们将学习如何使用 [go-playground/validator.v9 ](https://github.com/go-playground/validator)进行请求值验证。
在 [此处](http://godoc.org/gopkg.in/go-playground/validator.v9#hdr-Baked_In_Validators_and_Tags)上查看有关标签用法的完整文档。
```
$ go get gopkg.in/go-playground/validator.v9
```
请注意,你需要在要绑定的所有字段上设置相应的绑定标签。例如,从JSON绑定时,设置 `json:"fieldname"`。
```
package main
import (
"fmt"
"github.com/kataras/iris/v12"
"gopkg.in/go-playground/validator.v9"
)
// User 包含用户信息。
type User struct {
FirstName string `json:"fname"`
LastName string `json:"lname"`
Age uint8 `json:"age" validate:"gte=0,lte=130"`
Email string `json:"email" validate:"required,email"`
FavouriteColor string `json:"favColor" validate:"hexcolor|rgb|rgba"`
Addresses []*Address `json:"addresses" validate:"required,dive,required"`
}
// Address 包含用户的地址信息。
type Address struct {
Street string `json:"street" validate:"required"`
City string `json:"city" validate:"required"`
Planet string `json:"planet" validate:"required"`
Phone string `json:"phone" validate:"required"`
}
// 使用 Validate 的单个实例,它可以缓存结构信息。
var validate *validator.Validate
func main() {
validate = validator.New()
// 为 'User' 注册验证
// 注意: 仅需为 'User' 注册一个非指针类型,
// 验证者在进行类型检查时在内部取消引用。
validate.RegisterStructValidation(UserStructLevelValidation, User{})
app := iris.New()
app.Post("/user", func(ctx iris.Context) {
var user User
if err := ctx.ReadJSON(&user); err != nil {
// [handle error...]
}
// 对于无效的验证输入,返回 InvalidValidationError
// nil 或 ValidationErrors ( []FieldError )
err := validate.Struct(user)
if err != nil {
// 仅仅当你的代码可以产生一个可以被验证器检查的值的时候,
// 才需要检查。 例如一个为 nil 的接口,大多数人包括我自己都通常没有这样的代码。
if _, ok := err.(*validator.InvalidValidationError); ok {
ctx.StatusCode(iris.StatusInternalServerError)
ctx.WriteString(err.Error())
return
}
ctx.StatusCode(iris.StatusBadRequest)
for _, err := range err.(validator.ValidationErrors) {
fmt.Println()
fmt.Println(err.Namespace())
fmt.Println(err.Field())
fmt.Println(err.StructNamespace())
fmt.Println(err.StructField())
fmt.Println(err.Tag())
fmt.Println(err.ActualTag())
fmt.Println(err.Kind())
fmt.Println(err.Type())
fmt.Println(err.Value())
fmt.Println(err.Param())
fmt.Println()
}
return
}
// [保存用户到数据库...]
})
app.Run(iris.Addr(":8080"))
}
func UserStructLevelValidation(sl validator.StructLevel) {
user := sl.Current().Interface().(User)
if len(user.FirstName) == 0 && len(user.LastName) == 0 {
sl.ReportError(user.FirstName, "FirstName", "fname", "fnameorlname", "")
sl.ReportError(user.LastName, "LastName", "lname", "fnameorlname", "")
}
}
```
JSON形式的示例请求:
```
{
"fname": "",
"lname": "",
"age": 45,
"email": "mail@example.com",
"favColor": "#000",
"addresses": [{
"street": "Eavesdown Docks",
"planet": "Persphone",
"phone": "none",
"city": "Unknown"
}]
}
```
可以在以下位置找到示例:https://github.com/kataras/iris/tree/master/_examples/http_request/read-json-struct-validation/main.go.
