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

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

基本介紹

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

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

注意問題

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

在項目開發(fā)中，我們可以通過Error接口的其他方法來獲取特定的錯誤信息。

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

方法詳解

獲取校驗結(jié)果的值可以通過多個校驗結(jié)果方法獲?。?/p>

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

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

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

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

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

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

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

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

進階

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

注意問題

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

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

總結(jié)

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

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

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

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

最新評論