新聞中心
這里有您想知道的互聯(lián)網營銷解決方案
創(chuàng)新互聯(lián)GoFrame教程:GoFrameStruct校驗-基本使用
?Struct?校驗常使用以下鏈式操作方式:

g.Validator().Data(object).Run(ctx)gvalid tag規(guī)則介紹
在開始介紹?Struct?參數(shù)類型校驗之前,我們來介紹一下常用的?gvalid tag?規(guī)則。規(guī)則如下:
[屬性別名@]校驗規(guī)則[#錯誤提示]其中:
- 屬性別名 和 錯誤提示 為非必需字段,校驗規(guī)則 是必需字段。
- 屬性別名 非必需字段,指定在校驗中使用的對應?
struct?屬性的別名,同時校驗后返回的?error?對象中的也將使用該別名返回。例如在處理請求表單時比較有用,因為表單的字段名稱往往和?struct?的屬性名稱不一致。大部分場景下不需要設置屬性別名,默認直接使用屬性名稱即可。 - 校驗規(guī)則則為當前屬性的校驗規(guī)則,多個校驗規(guī)則請使用|符號組合,例如:?
required|between:1,100?。 - 錯誤提示 非必需字段,表示自定義的錯誤提示信息,當規(guī)則校驗時對默認的錯誤提示信息進行覆蓋。
gvalid tag使用示例
package main
import (
"github.com/GOgf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
type User struct {
Uid int `v:"uid @integer|min:1#|請輸入用戶ID"`
Name string `v:"name @required|length:6,30#請輸入用戶名稱|用戶名稱長度非法"`
Pass1 string `v:"password1@required|password3"`
Pass2 string `v:"password2@required|password3|same:Pass1#|密碼格式不合法|兩次密碼不一致,請重新輸入"`
}
func main() {
var (
ctx = gctx.New()
user = &User{
Name: "john",
Pass1: "Abc123!@#",
Pass2: "123",
}
)
err := g.Validator().Data(user).Run(ctx)
if err != nil {
g.Dump(err.Items())
}
}可以看到,我們可以對在?struct?定義時使用了?gvalid?的?gvalid tag?來綁定校驗的規(guī)則及錯誤提示信息。在此示例代碼中,?same:password1?規(guī)則同使用?same:Pass1?規(guī)則是一樣的效果。也就是說,在數(shù)據(jù)校驗中,可以同時使用原有的?struct?屬性名稱,也可以使用別名。但是,返回的結果中只會使用別名返回,這也是別名最大的用途。此外,在對?struct?對象進行校驗時,也可以傳遞校驗或者和錯誤提示參數(shù),這個時候會覆蓋?struct?在定義時綁定的對應參數(shù)。
以上示例執(zhí)行后,輸出結果為:
[
{
"uid": {
"min": "請輸入用戶ID",
},
},
{
"name": {
"length": "用戶名稱長度非法",
},
},
{
"password2": {
"password3": "密碼格式不合法",
},
},
]使用map指定校驗規(guī)則
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
func main() {
type User struct {
Age int
Name string
}
var (
ctx = gctx.New()
user = User{Name: "john"}
rules = map[string]string{
"Name": "required|length:6,16",
"Age": "between:18,30",
}
messages = map[string]interface{}{
"Name": map[string]string{
"required": "名稱不能為空",
"length": "名稱長度為{min}到{max}個字符",
},
"Age": "年齡為18到30周歲",
}
)
err := g.Validator().Rules(rules).Messages(messages).Data(user).Run(ctx)
if err != nil {
g.Dump(err.Maps())
}
}在以上示例中,?Age?屬性由于默認值?0?的存在,因此會引起?required?規(guī)則的失效,因此這里沒有使用?required?規(guī)則而是使用?between?規(guī)則來進行校驗。示例代碼執(zhí)行后,終端輸出:
{
"Age": {
"between": "年齡為18到30周歲"
},
"Name": {
"length": "名稱長度為6到16個字符"
}
}結構體遞歸校驗
支持遞歸的結構體校驗,即如果屬性也是結構體(也支持嵌套結構體(?embedded?)),那么將會自動將該屬性執(zhí)行遞歸校驗。使用示例:
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
func main() {
type Pass struct {
Pass1 string `valid:"password1@required|same:password2#請輸入您的密碼|您兩次輸入的密碼不一致"`
Pass2 string `valid:"password2@required|same:password1#請再次輸入您的密碼|您兩次輸入的密碼不一致"`
}
type User struct {
Pass
Id int
Name string `valid:"name@required#請輸入您的姓名"`
}
var (
ctx = gctx.New()
user = &User{
Name: "john",
Pass: Pass{
Pass1: "1",
Pass2: "2",
},
}
)
err := g.Validator().Data(user).Run(ctx)
g.Dump(err.Maps())
}或者屬性為嵌套結構體(?embedded?)的場景:
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
func main() {
type Pass struct {
Pass1 string `valid:"password1@required|same:password2#請輸入您的密碼|您兩次輸入的密碼不一致"`
Pass2 string `valid:"password2@required|same:password1#請再次輸入您的密碼|您兩次輸入的密碼不一致"`
}
type User struct {
Id int
Name string `valid:"name@required#請輸入您的姓名"`
Pass Pass
}
var (
ctx = gctx.New()
user = &User{
Name: "john",
Pass: Pass{
Pass1: "1",
Pass2: "2",
},
}
)
err := g.Validator().Data(user).Run(ctx)
g.Dump(err.Maps())
}執(zhí)行后,終端輸出:
{
"password1": {
"same": "您兩次輸入的密碼不一致",
},
"password2": {
"same": "您兩次輸入的密碼不一致",
},
} 當前題目:創(chuàng)新互聯(lián)GoFrame教程:GoFrameStruct校驗-基本使用
當前地址:http://www.5511xx.com/article/copgicj.html


咨詢
建站咨詢
