上一篇文章介紹了 GoFrame數(shù)據(jù)校驗(yàn)之校驗(yàn)對(duì)象 | 校驗(yàn)結(jié)構(gòu)體 ，得到了大家積極的反饋。

再接再厲，這篇總結(jié)分享：GoFrame數(shù)據(jù)校驗(yàn)之校驗(yàn)結(jié)果總結(jié)分享。

基本介紹

校驗(yàn)結(jié)果為一個(gè)Error接口對(duì)象。當(dāng)數(shù)據(jù)規(guī)則校驗(yàn)成功時(shí)，校驗(yàn)方法返回的結(jié)果為nil。

當(dāng)數(shù)據(jù)規(guī)則校驗(yàn)失敗時(shí)，返回的該對(duì)象是包含結(jié)構(gòu)化的層級(jí)map，包含多個(gè)字段及其規(guī)則及對(duì)應(yīng)錯(cuò)誤信息，以便于接收端能夠準(zhǔn)確定位錯(cuò)誤規(guī)則。

方法示例

首先我們看一下Error的數(shù)據(jù)結(jié)構(gòu)：

type Error interface {
    Current() error
    Error() string
    FirstItem() (key string, messages map[string]string)
    FirstRule() (rule string, err string)
    FirstString() (err string)
    Items() (items []map[string]map[string]string)
    Map() map[string]string
    Maps() map[string]map[string]string
    String() string
    Strings() (errs []string) 
} 

注意問(wèn)題

可以通過(guò)Maps()方法獲得該原始錯(cuò)誤信息數(shù)據(jù)結(jié)構(gòu)map。

在項(xiàng)目開發(fā)中，我們可以通過(guò)Error接口的其他方法來(lái)獲取特定的錯(cuò)誤信息。

當(dāng)我們并不關(guān)心具體出錯(cuò)的校驗(yàn)規(guī)則時(shí)，可以使用String方法，直接返回所有的錯(cuò)誤信息。

方法詳解

獲取校驗(yàn)結(jié)果的值可以通過(guò)多個(gè)校驗(yàn)結(jié)果方法獲?。?/p>

Items()在順序性校驗(yàn)中將會(huì)按照校驗(yàn)規(guī)則返回校驗(yàn)錯(cuò)誤的信息數(shù)組。其順序性只有使用順序校驗(yàn)規(guī)則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。

Map() 會(huì)返回FirstItem中的出錯(cuò)規(guī)則及對(duì)應(yīng)的錯(cuò)誤信息map。

Maps() 會(huì)返回所有的出錯(cuò)鍵名及對(duì)應(yīng)的出錯(cuò)規(guī)則及對(duì)應(yīng)的錯(cuò)誤信息(map[string]map[string]string)。

String() 會(huì)返回所有的錯(cuò)誤信息，構(gòu)成一條字符串返回，多個(gè)規(guī)則錯(cuò)誤信息之間以;符號(hào)連接。其順序性只有使用順序校驗(yàn)規(guī)則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。我們會(huì)比較常用。

Strings 會(huì)返回所有的錯(cuò)誤信息，構(gòu)成[]string類型返回。其順序性只有使用順序校驗(yàn)規(guī)則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。

FirstItem 在有多個(gè)鍵名/屬性校驗(yàn)錯(cuò)誤的時(shí)候，用以獲取出錯(cuò)的第一個(gè)鍵名，以及其對(duì)應(yīng)的出錯(cuò)規(guī)則和錯(cuò)誤信息。其順序性只有使用順序校驗(yàn)規(guī)則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。

FirstRule 會(huì)返回FirstItem中得第一條出錯(cuò)的規(guī)則及錯(cuò)誤信息。其順序性只有使用順序校驗(yàn)規(guī) 則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。

FirstString 會(huì)返回FirstRule中得第一條規(guī)則錯(cuò)誤信息。其順序性只有使用順序校驗(yàn)規(guī)則時(shí)有效，否則返回的結(jié)果是隨機(jī)的。

進(jìn)階

因?yàn)?code>gvalid.Error實(shí)現(xiàn)了Current() error接口，因此可以通過(guò)gerror.Current方法獲取它的第一條錯(cuò)誤信息，這在接口校驗(yàn)失敗時(shí)返回錯(cuò)誤信息非常方便。

注意問(wèn)題

數(shù)據(jù)校驗(yàn)時(shí)存在順序性校驗(yàn)和非順序性校驗(yàn)，這會(huì)對(duì)獲取第一條錯(cuò)誤信息的結(jié)果產(chǎn)生影響。

關(guān)于順序與非順序性校驗(yàn)，可以關(guān)注我，后面的文章中會(huì)更新說(shuō)明。

總結(jié)

這篇文章為大家介紹了GoFrame gvalid 校驗(yàn)結(jié)果相關(guān)的知識(shí)點(diǎn)：

校驗(yàn)結(jié)果為一個(gè)Error接口對(duì)象。當(dāng)數(shù)據(jù)規(guī)則校驗(yàn)成功時(shí)，校驗(yàn)方法返回的結(jié)果為nil。

當(dāng)數(shù)據(jù)規(guī)則校驗(yàn)失敗時(shí)，返回的該對(duì)象是包含結(jié)構(gòu)化的層級(jí)map，包含多個(gè)字段及其規(guī)則及對(duì)應(yīng)錯(cuò)誤信息，以便于接收端能夠準(zhǔn)確定位錯(cuò)誤規(guī)則。

更多關(guān)于GoFrame數(shù)據(jù)校驗(yàn)Error接口對(duì)象的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！