作者：Vamei 出處：http://www.cnblogs.com/vamei 歡迎轉載，也請保留這段聲明。謝謝！
表單(form)是最常見的從客戶往服務器傳遞數據的方式。Play框架提供了一些工具。它們可以從表單中提取數據，驗證提交數據的合法性，或者在視圖中顯示表單。我先來介紹最簡單的使用表單提交數據的方式。
增加表單
我可以用純粹html的方式產生一個表單。在app/views下增加模板form.scala.html:
<!DOCTYPE html>
<html>
<body>
<form method="POST" action="/postForm">
<input type="text" name="content"></input>
<input type="submit"></input>
</form>
</body>
</html>
在Application控制器中，增加一個動作form()，顯示模板:
public static Result form() { return ok(views.html.form.render()); }
在routes中增加導航
GET /form controllers.Application.form()
頁面如下：
數據提取
在文本框中輸入任意字符，點擊submit后，表單將以POST方法提交到/postForm這一URL。增添負責處理該URL的動作，Application.postForm()
public static Result postForm() { DynamicForm in = Form.form().bindFromRequest(); String result = in.get("content"); return ok(result); }
DynamicForm和Form都來自play.data。Form.form().bindFormRequest()從請求中提取表單信息，並放入到DynamicForm類型的in對象中。
我上面用get()方法，來提取表單中不同名字的輸入欄。比如上面的"content"。postForm()動作把表單中填寫的內容直接顯示。
增加routes記錄
POST /postForm controllers.Application.postForm()
在/form的頁面下輸入任意字符串並提交，查看效果。
我介紹了表單最基本的使用方式。下面了解Play框架提供的其它的表單工具。
表單對象
在動作內部，可以創建一個對象來指代表單。表單的每個輸入欄為表單對象的一個屬性。我可以通過增加標注(annotation)的方法，驗證表單的輸入(Form Validation)。
首先修改app/views/form.scala.html
<!DOCTYPE html>
<html>
<body>
<form method="POST" action="/postForm">
<label>Email</label>
<input type="email" name="email">
<label>Password</label>
<input type="password" name="password">
<label>Comment</label>
<input type="text" name="comment">
<input type="submit">
</form>
</body>
</html>
這個表單有三個輸入欄，名字分別為email, password和comment。
創建app/util/文件夾，在其中創建User.java。User類用於在Play內部指代上面的表單：
package util; import play.data.validation.Constraints.Email; import play.data.validation.Constraints.Required; public class User { @Email public String email; @Required public String password; public String comment; }
User類指代一個表單的數據。我還為兩個屬性增加了標注。Play服務器可以據此驗證輸入的合法性。比如@Email的限定就要求輸入為"*@*"的形式。@Required則要求輸入欄不為空。如果違反這些限定，那么Play將拋出異常。
修改動作postForm()。User類的對象user用來保存表單數據。
public static Result postForm() { Form<User> userForm = Form.form(User.class); User user = userForm.bindFromRequest().get(); return ok(user.email + " " + user.password); }
最后的ok()中調用了表單對象中保存的數據。
分別輸入合法和不合法的數據，觀察Play返回的頁面。
表單模板
我上面手動創建模板中的表單，並保持視圖中的表單和表單對象一致。我還可以在模板中直接調用表單對象。這樣做，能讓視圖中的表單和表單對象自動的保持一致。
修改form.scala.html為
@(userForm: Form[util.User]) <!DOCTYPE html>
<html>
<body> @helper.form(action = routes.Application.postForm()) { @helper.inputText(userForm("email")) @helper.inputPassword(userForm("password")) @helper.inputText(userForm("comment")) <input type="submit"> } </body>
</html>
這里使用了Play所提供的helper工具。helper可以在表單中增加表單form，再加入不同類型的輸入欄，比如inputText和inputPassword。
修改原有的動作form()
public static Result form() { Form<User> userForm = Form.form(User.class);
return ok(views.html.form.render(userForm)); }
這里，表單對象作為參數傳遞給模板。最后的html頁面中的表單，將由Play自動生成。
總結
表單
數據提交
歡迎繼續閱讀“Java快速教程”系列文章