14.3. 表单及验证支持

在 Web 开发中对于这样的一个流程可能很眼熟：

• 打开一个网页显示出表单。
• 用户填写并提交了表单。
• 如果用户提交了一些无效的信息，或者可能漏掉了一个必填项，表单将会连同用户的数据和错误问题的描述信息返回。
• 用户再次填写，继续上一步过程，直到提交了一个有效的表单。

在接收端，脚本必须：

• 检查用户递交的表单数据。
• 验证数据是否为正确的类型，合适的标准。例如，如果一个用户名被提交，它必须被验证是否只包含了允许的字符。它必须有一个最小长度，不能超过最大长度。用户名不能与已存在的他人用户名重复，甚至是一个保留字等。
• 过滤数据并清理不安全字符，保证逻辑处理中接收的数据是安全的。
• 如果需要，预格式化数据（数据需要清除空白或者经过 HTML 编码等等。）
• 准备好数据，插入数据库。

尽管上面的过程并不是很复杂，但是通常情况下需要编写很多代码，而且为了显示错误信息，在网页中经常要使用多种不同的控制结构。创建表单验证虽简单，实施起来实在枯燥无味。

表单和验证

对于开发者来说，一般开发过程都是相当复杂，而且大多是在重复一样的工作。假设一个场景项目中忽然需要增加一个表单数据，那么局部代码的整个流程都需要修改。我们知道 Go 里面 struct 是常用的一个数据结构，因此 beego 的 form 采用了 struct 来处理表单信息。

首先定义一个开发 Web 应用时相对应的 struct，一个字段对应一个 form 元素，通过 struct 的 tag 来定义相应的元素信息和验证信息，如下所示：

type User struct{
    Username    string  `form:text,valid:required`
    Nickname    string  `form:text,valid:required`
    Age         int     `form:text,valid:required|numeric`
    Email       string  `form:text,valid:required|valid_email`
    Introduce   string  `form:textarea`
}

定义好 struct 之后接下来在 controller 中这样操作

func (this *AddController) Get() {
    this.Data["form"] = beego.Form(&User{})
    this.Layout = "admin/layout.html"
    this.TplNames = "admin/add.tpl"
}       

在模板中这样显示表单

<h1>New Blog Post</h1>
<form action="" method="post">
{{.form.render()}}
</form>

上面我们定义好了整个的第一步，从 struct 到显示表单的过程，接下来就是用户填写信息，服务器端接收数据然后验证，最后插入数据库。

func (this *AddController) Post() {
    var user User
    form := this.GetInput(&user)
    if !form.Validates() {
        return
    }
    models.UserInsert(&user)
    this.Ctx.Redirect(302, "/admin/index")
}       

表单类型

以下列表列出来了对应的 form 元素信息：

表单验证

以下列表将列出可被使用的原生规则