Tapestry 数据验证
Tapestry 数据验证
Login.html
<html>
<head>
<title>
<span key="title">①Login</span>
</title>
</head>
<body jwcid="@Body">②
<span jwcid="@Conditional" condition="ognl:beans.delegate.hasErrors">③
<div style="color: red">
<span jwcid="@Delegator" delegate="ognl:beans.delegate.firstError">④
Error Message
</span>
</div>
</span>
<p style="font-weight: bold" >
<span key="hint">Hint: Your password is your username spelled backwards.</span>
</p>
<form jwcid="@Form" listener="ognl:listeners.login" delegate="ognl:beans.delegate">
⑤
<table>
<tr>
<td align="right">
<span jwcid="@FieldLabel" field="ognl:components.inputUsername"⑥>
Username:
</span>
</td>
<td>
<input type="text" jwcid="inputUsername"⑦ value="simpson_h"
size="30"/>
</td>
</tr>
<tr>
<td align="right">
<span jwcid="@FieldLabel" field="ognl:components.inputPassword">
Password:
</span>
</td>
<td>
<input type="text" jwcid="inputPassword" hidden="true" value=""
size="30"/>
</td>
</tr>
<tr>
<td colspan="2" align="center">
<input type="submit" jwcid="@Submit" value="message:login"/>
</td>
</tr>
</table>
</form>
</body>
</html>
这 个页面模板大多数是通常的HTML。我们从页面模板中可以看到Tapestry的区域化特性：它使用一个span元素，这个span元素带有一个叫key 的属性，key的值映射到Login.properties文件里一个属性。一个Body控件被声明使用，因为它对客户端的javascript校验是必 需的。
为Form component⑤设定delegate属性激活表单输入验证。delegate属性是我们在页面规范里声明的 org.apache.tapestry.valid.IvalidationDelegate的实现类。如果验证错误发生了，我们用 Conditional component③控件判断delegate是否有任何错误，如果有就把第一个错误④显示给用户。如果ognl 表达式ognl:beans.delegate.hasErrors 为true,Conditional控件将显示它的内容实体。所有的页面类和控件类都从AbstractComponent继承来一个叫beans的属 性。这个beans属性是一个org.apache.tapestry.IbeanProvider的实例，利用它可以通过名字取得在页面规范文件里定义 的beans.FieldLabel⑥被用于为inputuserName validField控件显示标签，这个FieldLabel控件也被用来与表单的验证代理协作，指出包含错误的输入域。
InputUserName⑦控件是一个显示控件的例子。显式控件是指在页面规范文件声明的控件。InputUsername和inputPassword控件都是显式的，它们与FieldLabel联合显示它们的displayName属性。
下面的是Login页的资源文件。Login.properties跟页面规范一并存放在WEB-INF目录。
Login.properties
title = Login to the Application
hint = Hint: Your password is your username spelled backwards.
login = Login
username = Username:
password = Password:
invalidpassword = Invalid Password
Here is the page specification for the Login page.
Login.page
<?xml version="1.0"?>
<!DOCTYPE page-specification PUBLIC
"-//Apache Software Foundation//Tapestry Specification 3.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd>
<page-specification class="com.ociweb.tapestry.Login">
<bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>①
<bean name="requiredValidator"②
class="org.apache.tapestry.valid.StringValidator">
<set-property name="required" expression="true"/>
<set-property name="clientScriptingEnabled" expression="true"/>
</bean>
<property-specification name="username" type="java.lang.String"/>
<property-specification name="password" type="java.lang.String"/>
<component id="inputUsername" type="ValidField"> ③
<message-binding name="displayName" key="username"/> ④
<binding name="validator" expression="beans.requiredValidator"/> ⑤
<binding name="value" expression="username"/> ⑥
</component>
<component id="inputPassword" type="ValidField"> ⑦
<message-binding name="displayName" key="password"/>
<binding name="validator" expression="beans.requiredValidator"/>
<binding name="value" expression="password"/>
</component>
</page-specification>
Page-specification元素的class属性和两个property-specification元素与Pig Latin翻译器应用是相似的。
你会发现第一个新东西-bean元素①，bean元素把一个org.apache.tapestry.valid.ValidationDelegate
的实例指定了名称"delegate"。页面HTML模板里的Form控件把它的参数delegate设定为
ognl:beans.delegate,就是指向了这个org.apache.tapestry.valid.ValidationDelegate实例。
Bean元素②把一个org.apache.tapestry.valid.StringValidator的实例指定了名称"
requiredValidator", 以用于验证。这个bean的required属性被设为true表明使用这个bean的域是必须被验证的。这个bean的 clientScriptingEnabled属性被设定为ture,表明使用这个bean的域客户端的javascript验证功能是激活的。 RequiredValidator bean被用于验证inputUsername和inputPassword的内容。
控件 inputUsername③被控件规范声明为ValidField，ValidField是一种用于Tapestry验证子系统的特殊版本的 TextField控件。Message-binding元素被用于指定inputUsername控件的displayName参数的值，这个值是用 "username"为关键字从login.properties④文件里得到。InputUsername控件的validator参数被设定为 requiredValidator bean,这是我们在页面规范里声明过的⑤。控件的value参数跟页面Java类的username属性绑定在一起⑥。控件inputPassword 的控件规范跟控件inputUsername几乎相似，除了用于取得displayName的关键字和绑定的页面Java类的属性不同。
通 过使用ValidField控件和为表单(form)提供一个ValidationDelegate, 我们激活了Login表单的验证功能。除了服务器端的验证，Tapestry也提供了客户端的验证（利用javascript）。下面就是当用户提交一个 表单而没有为UserName域提供值时，一个javascript错误对话框弹出时的屏幕抓图。
下面就是当用户提交一个表单而没有为Password域提供值时，一个javascript错误对话框弹出时的屏幕抓图。
下面就是Login页对应的Java 类。
Login.java
package com.ociweb.tapestry;
import org.apache.tapestry.html.BasePage;
import org.apache.tapestry.IRequestCycle;
import org.apache.tapestry.valid.ValidationConstraint;
import org.apache.tapestry.valid.IValidationDelegate;
public abstract class Login extends BasePage {
public abstract String getUsername();
public abstract void setUsername(String username);
public abstract String getPassword();
public abstract void setPassword(String password);
public void login(IRequestCycle cycle) {
String username = getUsername();
String password = getPassword();
StringBuffer sb = new StringBuffer(username);
String validPassword = sb.reverse().toString();
if (password.equals(validPassword)) {
cycle.activate("Success");①
} else {
String errorMessage = getMessage("invalidpassword");②
IValidationDelegate validationDelegate =
(IValidationDelegate) getBeans().getBean("delegate");③
validationDelegate.record(errorMessage,
ValidationConstraint.CONSISTENCY);④
}
}
}
跟Pig Latin翻译器应用一样，我们的页面类也是抽象的，它有抽象方法访问在页面规范里定义的属性(properties)。Tapestry会在运行时刻创 建username和password属性。Login方法只是简单的验证一下用户输入的密码值是否刚好是用户名的反向。如果密码通过验证，用户将被引导 入Success page①。