Revel提供了内建函数用于验证参数。它提供了:
一个`Validation`上下文集合来管理验证错误信息(键与消息内容)
辅助函数用于检查数据并将错误信息放入上下文
一个模板函数用于从`Validation`上下文以键的方式获取错误信息
##内嵌错误信息
这个例子演示了字段验证与内嵌错误信息:
func (c MyApp) SaveUser(username string) revel.Result {
// Username 参数必须是4~15个长度,名且匹配正则 ^\w*$
c.Validation.Required(username)
c.Validation.MaxSize(username, 15)
c.Validation.MinSize(username, 4)
c.Validation.Match(username, regexp.MustCompile("^\w*$"))
if c.Validation.HasErrors() {
// 存储参数与异常信息至flash,并重转向
c.Validation.Keep()
c.FlashParams()
return c.Redirect(Hotels.Settings)
}
// All the data checked out!
...
}
整个步骤如下:
1、验证`username`必须符合四种情况(必填、最长15个、最少4个,匹配正则)
2、每一次验证返回一个`ValidationResult`对象,失败的`ValidationResult`存储在`Validation`上下文
3、在构建项目时,revel会记录每个需要验证参数的变量名,并且将它作为默认的`validation`上下文中的key
4、`Validation.HasErrors()` 如果`validation`上下文包含错误信息,则返回`true`
5、`Validation.Keep()`使`ValidationErrors`错误信息写入flash cookies
6、重定向至`Hotels.Settings`
`Hotels.Settings`会渲染如下模板:
{{/* app/views/Hotels/Settings.html */}}
...
{{if .errors}}Please fix errors marked below!{{end}}
...
Username:
{{.errors.username.Message}}
它做了3个事:
1、检查错误信息map中`username`键是否存在错误
2、使用`username`中的值预填充input标签
3、在input标签下面显示错误信息。
##顶部的错误信息
错误信息可以被显示在一个固定的地方,这样可以简化错误显示机制。例如,在页面上方有个红色边框的区域显示这些信息。
这与上面的例子有两点不同:
1、我们使用`Message`,而不是`ValidationError`的`Key`
2、我们在表单的上部显示所有错误信息
代码:
func (c MyApp) SaveUser(username string) revel.Result {
// Username 参数必须是4~15个长度,名且匹配正则 ^\w*$
c.Validation.Required(username)
c.Validation.MaxSize(username, 15)
c.Validation.MinSize(username, 4)
c.Validation.Match(username, regexp.MustCompile("^\w*$"))
if c.Validation.HasErrors() {
// 存储参数与异常信息至flash,并重转向
c.Validation.Keep()
c.FlashParams()
return c.Redirect(Hotels.Settings)
}
// All the data checked out!
...
}
模板:
{{/* app/views/Hotels/Settings.html */}}
...
{{if .errors}}
{{range .errors}}
- {{.Message}}
{{end}}
{{end}}
...