Java Play框架教程04 表单

表单 (form)是最常见的从客户往服务器传递数据的方式。Play框架提供了一些工具。它们可以从表单中提取数据,验证提交数据的合法性,或者在视图中显示表单。我先来介绍最简单的使用表单提交数据的方式。

增加表单

我可以用纯粹html的方式产生一个表单。在app/views下增加模板form.scala.html:

在Application控制器中,增加一个动作form(),显示模板:

在routes中增加导航

页面如下:

数据提取

在文本框中输入任意字符,点击submit后,表单将以POST方法提交到/postForm这一URL。增添负责处理该URL的动作,Application.postForm()

DynamicForm 和 Form都来自play.data。Form.form().bindFormRequest()从请求中提取表单信息,并放入到DynamicForm类型的in对象中。

我上面用 get() 方法,来提取表单中不同名字的输入栏。比如上面的"content"。postForm()动作把表单中填写的内容直接显示。

增加routes记录

在/form的页面下输入任意字符串并提交,查看效果。

我介绍了表单最基本的使用方式。下面了解Play框架提供的其它的表单工具。

表单对象

在动作内部,可以创建一个对象来指代表单。表单的每个输入栏为表单对象的一个属性。我可以通过增加标注(annotation)的方法,验证表单的输入(FormValidation)。

首先修改app/views/form.scala.html

这个表单有三个输入栏,名字分别为email, password和comment。

创建app/util/文件夹,在其中创建User.java。User类用于在Play内部指代上面的表单:

User类指代一个表单的数据。我还为两个属性增加了标注。Play服务器可以据此验证输入的合法性。比如 @Email 的限定就要求输入为"@"的形式。@Required 则要求输入栏不为空。如果违反这些限定,那么Play将抛出异常。

修改动作postForm()。User类的对象user用来保存表单数据。

最后的ok()中调用了表单对象中保存的数据。

分别输入合法和不合法的数据,观察Play返回的页面。

表单模板

我上面手动创建模板中的表单,并保持视图中的表单和表单对象一致。我还可以在模板中直接调用表单对象。这样做,能让视图中的表单和表单对象自动的保持一致。

修改form.scala.html为

这里使用了Play所提供的helper工具。helper可以在表单中增加表单form,再加入不同类型的输入栏,比如inputText和inputPassword。

修改原有的动作form()

这里,表单对象作为参数传递给模板。最后的html页面中的表单,将由Play自动生成。

总结

表单

数据提交

「Java Play框架」系列文章

文/ Vamei

0 Likes