(A6)Tapestry Core:Form Input and Validation

chinajavawolf

浏览: 117072 次
性别:
来自: 哈尔滨

最近访客更多访客>>

w363042254

hao_chun

feifeng3000

yao_zonghai

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

Tapestry

Tapestry 应用服务器 CSS Apache

本人翻译目的是用来学习Tapestry5的,共享出来希望大家批评指正。计划持续翻译。

chinajavawolf

表单输入和验证

对于任何应用表单输入都是必不可少的；这是更有效的从用户处收集有用信息的方法。不管它是一个搜索表单、一个登录窗口或是一个多页的注册向导，用户使用表单真正向应用表达自己。

Tapestry在创建表单和验证输入方面表现杰出。输入验证是声明式的，这意味着你只是告诉Tapestry在给出的那个表单域上应用什么验证，然后他就会在服务器端和客户端负责验证。

最后，Tapestry不仅能够将错误的信息表现给用户，还能对表单域和表单域地标签进行装饰，标记它们包含错误（主要利用CSS效果）。

表单组件

Tapestry表单核心支持表单组件。表单组件封装所有其他表单域组件，如TextField, TextArea, Checkbox等等。

表单组件产生许多的组件事件component events，你可以提供事件处理器方法给他。

当呈现的时候，表单组件发布一个”prepare”通知，以使表单容器设置将要在表单中引用的表单域或属性。这是一个创建用来呈现的临时实体对象或用来加载来自于数据库的可编辑的实体的好时机。

当用户在客户端提交表单时，服务器端会执行一系列的步骤。

首先，当表单被呈现时表单会发出一个"prepare"通知。

接下来，所有的表单域被激活从引用的请求处获值，验证它们并（如果有效）保存变化。

对Tapestry 4的用户：Tapestry 5不使用Tapestry 4中脆弱的"form rewind"方法，而是用在呈现时产生一个存放是否需要处理表单提交信息的隐藏域来代替。

表单域流程处理完后，表单发出一个"validate"事件，这是执行跨表单验证的不能明白地被描述的一个机会。

接下来，表单确定是否存在任何验证错误。如果存在，那么提交一个被评估过的失败并发出一个"failure"事件。如果没有验证错误，那么将发出一个"success"事件。

最后，表单发出一个"submit"事件（逻辑上它不考虑成功还是失败）。

跟踪验证错误

一个与表单关联的就是验证跟踪器ValidationTracker跟踪用户所有对每个表单域提供的书如何验证错误。跟踪器能够通过表单的跟踪器参数提供给表单，但这不是必需的。

表单包括isValid()和getHasErrors()方法，他们被用来了解表单验证的跟踪器中是否包含错误。

在你自己的逻辑中，你可以去纪录你自己的错误。表单包括两个不同的recordError()方法版本。一个是指定一个表单域（一个被所有表单元素组件实现的接口），另外一个是全局"global"错误，与具体的表单域无关。

请求间存储数据

由于其他的动作请求，表单提交的结果会发送给客户端一个重定向去重新呈现页面。验证跟踪器必须在请求间被持久化地存储，否则所有的验证信息将被丢失（表单提供持久化式的默认验证跟踪器）。

同样，被组件更新的单独的表单域也应该被持久化。

例如，一个用来收集用户名和密码登陆页，如下：

public class Login
{
@Persist
private String _userName;
private String _password;
@Inject
private UserAuthenticator _authenticator;
@Component(id = "password")
private PasswordField _passwordField;
@Component
private Form _form;
String onSuccess()
{
if (!_authenticator.isValid(_userName, _password))
{
_form.recordError(_passwordField, "Invalid user name or password.");
return null;
}
return "PostLogin";
}
public String getPassword()
{
return _password;
}
public void setPassword(String password)
{
_password = password;
}
public String getUserName()
{
return _userName;
}
public void setUserName(String userName)
{
_userName = userName;
}
}

因为Form表单提交事实上是两个请求（提交自己，然后重新呈现页面），他需要在两个请求间产生一个值持续存储在_userName属性中。同样_password属性也应该被这样做，除非PasswordField组件从不呈现值。

注意onSuccess()不是公有的；事件处理器方法可以有任何可见度，甚至是私有的。包私有（就是没有修饰符）是典型应用，这样它允许组件可被相同包下的测试用例类测试。

如果先前没有验证错误，表单就只发出一个"success"事件。这意味着不用写

if (_form.getHasErrors()) return;在方法的第一行。

最后，注意业务逻辑如何与表单验证相适合。UserAuthenticator服务负责userName和password的有效性。当它返回false时，我们用Form组件来记录一个错误。我们提供PasswordField实例作为第一个参数；这保证了password表单域和他的标签在表单重新呈现时被装饰以呈现错误给用户。

配置表单域和标签

页面模板包含最少的Tapestry内容

<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd">
<head>
<title>Logintitle>
head>
<body>
<h1>Please Loginh1>
<t:form>
<t:errors/>
<t:label for="userName"/>:
<input t:type="TextField" t:id="userName" t:validate="required,minlength=3" size="30"/>
<br/>
<t:label for="password"/>:
<input t:type="PasswordField" t:id="password" t:validate="required,minlength=3" size="30"/>
<br/>
<input type="submit" value="Login"/>
t:form>
body>
html>