表单(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自动生成。
总结
表单
数据提交