建站
咨詢(xún)
售后
建站咨詢(xún)
新聞中心
?Struct?校驗(yàn)常使用以下鏈?zhǔn)讲僮鞣绞剑?/p>
g.Validator().Data(object).Run(ctx)gvalid tag規(guī)則介紹
在開(kāi)始介紹?Struct?參數(shù)類(lèi)型校驗(yàn)之前，我們來(lái)介紹一下常用的?gvalid tag?規(guī)則。規(guī)則如下：
[屬性別名@]校驗(yàn)規(guī)則[#錯(cuò)誤提示]其中：
- 屬性別名 和 錯(cuò)誤提示 為非必需字段，校驗(yàn)規(guī)則 是必需字段。
- 屬性別名 非必需字段，指定在校驗(yàn)中使用的對(duì)應(yīng)?
struct?屬性的別名，同時(shí)校驗(yàn)后返回的?error?對(duì)象中的也將使用該別名返回。例如在處理請(qǐng)求表單時(shí)比較有用，因?yàn)楸韱蔚淖侄蚊Q(chēng)往往和?struct?的屬性名稱(chēng)不一致。大部分場(chǎng)景下不需要設(shè)置屬性別名，默認(rèn)直接使用屬性名稱(chēng)即可。 - 校驗(yàn)規(guī)則則為當(dāng)前屬性的校驗(yàn)規(guī)則，多個(gè)校驗(yàn)規(guī)則請(qǐng)使用|符號(hào)組合，例如：?
required|between:1,100?。 - 錯(cuò)誤提示 非必需字段，表示自定義的錯(cuò)誤提示信息，當(dāng)規(guī)則校驗(yàn)時(shí)對(duì)默認(rèn)的錯(cuò)誤提示信息進(jìn)行覆蓋。
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#|請(qǐng)輸入用戶(hù)ID"`
Name string `v:"name @required|length:6,30#請(qǐng)輸入用戶(hù)名稱(chēng)|用戶(hù)名稱(chēng)長(zhǎng)度非法"`
Pass1 string `v:"password1@required|password3"`
Pass2 string `v:"password2@required|password3|same:Pass1#|密碼格式不合法|兩次密碼不一致，請(qǐng)重新輸入"`
}
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())
}
}可以看到，我們可以對(duì)在?struct?定義時(shí)使用了?gvalid?的?gvalid tag?來(lái)綁定校驗(yàn)的規(guī)則及錯(cuò)誤提示信息。在此示例代碼中，?same:password1?規(guī)則同使用?same:Pass1?規(guī)則是一樣的效果。也就是說(shuō)，在數(shù)據(jù)校驗(yàn)中，可以同時(shí)使用原有的?struct?屬性名稱(chēng)，也可以使用別名。但是，返回的結(jié)果中只會(huì)使用別名返回，這也是別名最大的用途。此外，在對(duì)?struct?對(duì)象進(jìn)行校驗(yàn)時(shí)，也可以傳遞校驗(yàn)或者和錯(cuò)誤提示參數(shù)，這個(gè)時(shí)候會(huì)覆蓋?struct?在定義時(shí)綁定的對(duì)應(yīng)參數(shù)。
以上示例執(zhí)行后，輸出結(jié)果為：
[
{
"uid": {
"min": "請(qǐng)輸入用戶(hù)ID",
},
},
{
"name": {
"length": "用戶(hù)名稱(chēng)長(zhǎng)度非法",
},
},
{
"password2": {
"password3": "密碼格式不合法",
},
},
]使用map指定校驗(yàn)規(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": "名稱(chēng)不能為空",
"length": "名稱(chēng)長(zhǎng)度為{min}到{max}個(gè)字符",
},
"Age": "年齡為18到30周歲",
}
)
err := g.Validator().Rules(rules).Messages(messages).Data(user).Run(ctx)
if err != nil {
g.Dump(err.Maps())
}
}在以上示例中，?Age?屬性由于默認(rèn)值?0?的存在，因此會(huì)引起?required?規(guī)則的失效，因此這里沒(méi)有使用?required?規(guī)則而是使用?between?規(guī)則來(lái)進(jìn)行校驗(yàn)。示例代碼執(zhí)行后，終端輸出：
{
"Age": {
"between": "年齡為18到30周歲"
},
"Name": {
"length": "名稱(chēng)長(zhǎng)度為6到16個(gè)字符"
}
}結(jié)構(gòu)體遞歸校驗(yàn)
支持遞歸的結(jié)構(gòu)體校驗(yàn)，即如果屬性也是結(jié)構(gòu)體（也支持嵌套結(jié)構(gòu)體（?embedded?）），那么將會(huì)自動(dòng)將該屬性執(zhí)行遞歸校驗(yàn)。使用示例：
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#請(qǐng)輸入您的密碼|您兩次輸入的密碼不一致"`
Pass2 string `valid:"password2@required|same:password1#請(qǐng)?jiān)俅屋斎肽拿艽a|您兩次輸入的密碼不一致"`
}
type User struct {
Pass
Id int
Name string `valid:"name@required#請(qǐng)輸入您的姓名"`
}
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())
}或者屬性為嵌套結(jié)構(gòu)體（?embedded?）的場(chǎng)景：
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#請(qǐng)輸入您的密碼|您兩次輸入的密碼不一致"`
Pass2 string `valid:"password2@required|same:password1#請(qǐng)?jiān)俅屋斎肽拿艽a|您兩次輸入的密碼不一致"`
}
type User struct {
Id int
Name string `valid:"name@required#請(qǐng)輸入您的姓名"`
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": "您兩次輸入的密碼不一致",
},
}網(wǎng)站題目：創(chuàng)新互聯(lián)GoFrame教程：GoFrameStruct校驗(yàn)-基本使用
分享地址：http://m.5511xx.com/article/copgicj.html
