在 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 元素資訊:
名稱 | 參數 | 功能描述 |
---|---|---|
text | No | textbox 輸入框 |
button | No | 按鈕 |
checkbox | No | 多選擇框 |
dropdown | No | 下拉選擇框 |
file | No | 檔案上傳 |
hidden | No | 隱藏元素 |
password | No | 密碼輸入框 |
radio | No | 單選框 |
textarea | No | 文字輸入框 |
以下列表將列出可被使用的原生規則
規則 | 參數 | 描述 | 舉例 |
---|---|---|---|
required | No | 如果元素為空,則回傳 FALSE | |
matches | Yes | 如果表單元素的值與參數中對應的表單欄位的值不相等,則回傳 FALSE | matches[form_item] |
is_unique | Yes | 如果表單元素的值與指定資料表欄位有重複,則回傳 False(譯者注:比如 is_unique[User.Email],那麼驗證類別會去查詢 User 表中 Email 欄位有沒有與表單元素一樣的值,如存重複,則回傳 false,這樣開發者就不必另寫 Callback 驗證程式碼。) | is_unique[table.field] |
min_length | Yes | 如果表單元素值的字元長度少於參數中定義的數字,則回傳 FALSE | min_length[6] |
max_length | Yes | 如果表單元素值的字元長度大於參數中定義的數字,則回傳 FALSE | max_length[12] |
exact_length | Yes | 如果表單元素值的字元長度與參數中定義的數字不符,則回傳 FALSE | exact_length[8] |
greater_than | Yes | 如果表單元素值是非數字型別,或小於參數定義的值,則回傳 FALSE | greater_than[8] |
less_than | Yes | 如果表單元素值是非數字型別,或大於參數定義的值,則回傳 FALSE | less_than[8] |
alpha | No | 如果表單元素值中包含除字母以外的其他字元,則回傳 FALSE | |
alpha_numeric | No | 如果表單元素值中包含除字母和數字以外的其他字元,則回傳 FALSE | |
alpha_dash | No | 如果表單元素值中包含除字母/數字/下劃線/破折號以外的其他字元,則回傳 FALSE | |
numeric | No | 如果表單元素值中包含除數字以外的字元,則回傳 FALSE | |
integer | No | 如果表單元素中包含除整數以外的字元,則回傳 FALSE | |
decimal | Yes | 如果表單元素中輸入(非小數)不完整的值,則回傳 FALSE | |
is_natural | No | 如果表單元素值中包含了非自然數的其他數值 (其他數值不包括零),則回傳 FALSE。自然數形如:0,1,2,3....等等。 | |
is_natural_no_zero | No | 如果表單元素值包含了非自然數的其他數值 (其他數值包括零),則回傳 FALSE。非零的自然數:1,2,3.....等等。 | |
valid_email | No | 如果表單元素值包含不合法的 email 地址,則回傳 FALSE | |
valid_emails | No | 如果表單元素值中任何一個值包含不合法的 email 地址(地址之間用英文逗號分割),則回傳 FALSE。 | |
valid_ip | No | 如果表單元素的值不是一個合法的 IP 地址,則回傳 FALSE。 | |
valid_base64 | No | 如果表單元素的值包含除了 base64 編碼字元之外的其他字元,則回傳 FALSE。 |
- 目錄
- 上一節:Session 支援
- 下一節:使用者認證