原文Q?nbsp; http://www.onjava.com/pub/a/onjava/2002/12/11/jakartastruts.html
译者： javaduke
Email:javaduke@263.net
QQ:658155
MSN:javaduke@hotmail.com
每个应用E序都有责Q保它们插入到后台资料库的数据是合法有效的，毕竟Q如果这些应用程序所依赖的数据一旦遭C破坏Q那是N性的Q那应用E序q能拿什么来使自己正常运转呢Q比如说Q用正规关pL据库的一个应用程序，数据库中的每个字D都有自׃定的规则和约束，来保证存储在其中的数据在一定程度上的正性。Q何要使用后台资料库数据的应用E序都有责Q保护它们提交的数据的完整性?BR> M试图插入或更CW合标准的数据的操作都有可能被发现ƈ拒绝。这U检可能遍布在整个应用E序的每个角落，在表现层可能q行一些验证，在业务逻辑层，商业逻辑对象一般也有商业逻辑的验证，q有在后台资料库也要Ҏ据进行检查?BR> 不幸的是Q由于这U验证在应用E序中无处不在，造成了应用程序在一定程度上的验证数据的代码冗余。这q不是应用程序所希望的，因ؓq种在多处的重复力_Q得应用程序的部v和维护要花去更多的时间。如果在整个应用E序中，q些验证规则可以重复使用Q将使得应用E序更加富有Ҏ，换句话说是Q部|更快捷Q定制更ҎQ程序更灉|?BR>Jakarta Commons 目Validator框架?/B>
Validator是由David Winterfeldt创徏的开源项目，它也是Jakarta Commons的一个子目。Commons目主要是提供一些像Validatorq样的一些可重用lg。其他著名的Commonslgq有如BeanUtils,Digester,Logging框架{。Validator 1.0版本发布?002q?1月初?BR>使用Validator的好?/B>
.使用Validator框架比一般的在应用程序的代码中定义验证规则有好多优点Q如Q?BR> .可以在一处ؓ应用E序定义验证规则Q?BR> .验证规则和应用程序是松耦合的；
.服务器端和客L的验证规则可以在同一处定义；
.配置新验证规则或修改已有验证规则变得更加单；
.支持国际化；
.支持正则表达式；
.可以用于Web应用E序也可用于标准的Java应用E序Q?BR> .采用声明的方法实现而不是编E实玎ͼ
除了之外QValidator最大的特征是自n支持可插性（pluggabilityQ。在文章的后
面你会看到使用Validator框架内置的验证规则来更好地完成你的工作，而更重要的是QValidator框架允许你自定义验证E序Qƈ插入到框架中?BR>Struts和Validator的关p?/B>
应该指出的是Validator框架本n是因Struts框架而徏立的。Validator的创David Winterfeldt在用Struts的过E中发现Q在许多ActionFormcM需要反复用同一个验证规则，q样造成了大量的代码冗余。于是他军_创徏Validator框架来消除这U冗余，q样Validatorp生了?BR> 管Validator架构最初是为Struts架构而生Q但它还是被设计和构造成了可以独立于Struts架构而单独用。这一个特征得你可以在Q何的应用E序中用这个框Ӟ不必它是不是Struts架构的。ƈ不会因ؓ你不使用Struts框架而媄响Validator架构对你的应用程序作用。事实上Q这是Z么Validator是Jakarta Commons目的一部分而不直接是Struts目的一部分?BR> 现在Q我们来这个框架整合应用到像基于Struts构架q样的Web应用E序上。在文章的最后中我们再介l如何把它应用到其他cd的应用程序中Q如ZEJB的应用程序?BR>Validatorlg概述
Validator架构有下面这些组件组成：
ValidatorsQ?BR> 配置文gQ?BR> 资源l定Q?BR> JSP自定义标{；
Validator Formc；
什么是Validators?
一个Validator是Q执行一个验证规则时Validator框架调用的一个JavacR框架根据配|文件中定义的方法签名来调用q个ValidaotorcR一般情况下Q每个ValidatorcL供一个单独的验证规则Q然后这些规则可以组合成更复杂的规则集?BR>
注意Q有时出于方便，一个ValidatorcM可以定义多个验证规则Q而每个规则是一个静态方法且q不包含M客户端状态信息?/I>
框架提供?4U默认的验证规则Q有时候这些规则也被称为Validator框架的“基本规则”，q些基本规则如表一Q?BR>名称 描述
byte,short,integer, 验值是否能被{换成对应的基本数据类?BR>long,float,double
creditCard 验输入域是否是一个合法的信用卡号?BR>date 验输入域是否是一个合法日?BR>email 验输入是否是一个合法Email地址
mask 验输入域是否能成功匹配一个正则表辑ּ
maxLength 验值的长度是否于{于l定的最大长?BR>minLength 验值的长度是否大于{于l定的最长?BR>range 验值的范围是否在最大值和最g?BR>required 验输入域是否Z为空Q或不包含空格值的长度是否大于?BR>表一
正像你在表一中看到的QValidator框架提供了Web应用E序需要的大多数的验证规则。你可以使用q些现有的验证规则来创徏自己验证配置文g。尽这P也正如我们前面提到的Q和后面要讲到的Q你可以Ҏ你的需要随意的增加更多的Validator?BR>现在Q让我们来讨论如何在一个基于Struts架构的应用程序中配置使用q些基本的Validator?BR> 使Validator框架hҎ的原因在于所有的验证规则和其具体l节都是通过在外部文件中配置声明实现的。你的应用程序ƈ不必要知道这些具体的验证规则。这一特征使得规则集的发生扩展和修ҎQ你q不用去动你应用E序的源代码。这一点对你要q行每次的个性化安装或当需求发生变化时来说是非帔R要的?BR> 如果你用Struts1.1的Validator框架Q你会用到这样两个配|文Ӟ一个叫validator- rules.xmlQ另一个叫validation.xmlQ其实你也可以随意的l他们命名，甚至可以把它们合q成一个XML文g。但是，你还是最好把它们分开Q因为它们各有各的用途?BR>
注意Q如果你从Jakarta|站上下载ValidatorQƈ不包含这两个文g。只有在包含的Validator框架的Struts的下载中才可以找到这两个文g?/I>
validator-rules.xml文g
validator-rules.xml文g定义应用E序可以使用的Validator。validator-rules.xml充当模板的作用，定义所有应用程序可能要用到的Validator?BR>
注意Q这个xml文g和我们下面要讨论的另一个xml文g都应该放到类加蝲器可以找得到的地斏V当我们在Web应用E序中用Validator框架Ӟ正确的位|应该是在WEB-INF下?/I>
validator-rules.xml文g服从validator- rules_1_1.dtd的管理，validator- rules_1_1.dtd可以在jakarta.apache.org/struts/dtds/validator- rules_1_1.dtd下蝲到。我们ƈ不想花太多的旉攑֜研究q个文g的具体细节上Q我们在q儿只作一些基本的介绍?BR>validator-rules.xml文g中最重要的元素包含在<validator>元素中，例如Q例一Q?BR>validator-rules.xml :
<form-validation>
<global>
<validator name="required"
classname="org.apache.struts.util.StrutsValidator"
method="validateRequired"
methodparams="java.lang.Object,
org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.apache.struts.action.ActionErrors,
javax.servlet.http.HttpServletRequest"
msg="errors.required"/>
<validator name="minlength"
classname="org.apache.struts.util.StrutsValidator"
method="validateMinLength"
methodparams="java.lang.Object,
org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.apache.struts.action.ActionErrors,
javax.servlet.http.HttpServletRequest"
depends="required"
msg="errors.minlength"/>
</global>
</form-validation>
<global> <validator name="required" classname="org.apache.struts.util.StrutsValidator" method="validateRequired" methodparams="java.lang.Object, org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.apache.struts.action.ActionErrors,
javax.servlet.http.HttpServletRequest"
msg="errors.required"/> <validator name="minlength" classname="org.apache.struts.util.StrutsValidator" method="validateMinLength" methodparams="java.lang.Object,org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.apache.struts.action.ActionErrors,
javax.servlet.http.HttpServletRequest"
depends="required" msg="errors.minlength"/> </global></form-validation>应用E序使用的每个Validator对应一?lt;validator>元素。在例一中给大家展示了两个ValidatorQ一个是hValidatorQ另一个是最长度Validator?lt;validator>元素支持许多属性。这些属性是必要的，用于告知框架q个Validator应当调用哪个正确的类和方法。例如，例一中的hValidator元素表明q个Validator调用org.apache.struts.util.StrutsValidatorcȝvalidateRequest()Ҏ。Validator也可能要依赖另一个Validator,如例一中的最长度的Validator是q样一个例子，它包含一个depends属性，用它来表C个Validator依赖于hValidator。msg属性用一个键值指定一个资源绑定，框架用它来生成正确的错误信息。资源绑定的使用有益于错误信息的本地化?BR> <validator>元素q支?lt;javascript>子元素，允许你指定一个客Lq行的JavaScript函数。这h务器端和客户端验证可以在同一处指定，q应用E序的维护变得简单?BR>
validation.xml文g
Validator框架的第二个配置文g是q个叫validation.xml的文件。其实你可以随意把它命名Z喜欢的Q何名字，也可以把它放到validator-rules.xml文g中?BR> validation.xml用于把你在validator-rules.xml中定义的各个Validator和你的应用程序中的组件映v来。由于我们在q里讨论的是在Struts中用Validator框架Q那么在q里validation.xml是把这些Validator和Struts的ActionFormcd立映。ActionFormcd实是一个类似JavaBean一Lc，在Struts中用于捕捉用戯入ƈ帮助传输q些输入C一U应用程序组件。ActionForm也提供了在用戯入被传到业务逻辑层之前验证这些输入的便利场所。例二是一个简单的validation.xml:
validation.xml:
<form-validation> <formset> <form name="checkoutForm"> <field property="firstName" depends="required"> <arg0 key="label.firstName"/> </field> <field property="lastName" depends="required"> <arg0 key="label.lastName"/> </field> </form> </formset></form-validation>资源l定
资源l定用于帮助消息本地化和一些其它文本信息的本地化处理。由于它减少了应用程序的许多冗余的硬~码Q故对应用程序有很大益处。比如，如果你要在JSP面中要使用一个“Name”标{时Q你可以把这个字W串攑ֈ一个资源绑定中Q然后用资源绑定的一个逻辑键值引用这个字W串Q而不是直接用这个字W串Q这样做的好处在于，当你xq个字符串改为“First Name”时Q你只需在资源绑定中修改一处即可，而不必修Ҏ个应用程序的全部代码?BR> 对于Validator框架Q当验证规则p|的时候，可以从资源绑定中创徏错误信息。Validator框架提供几种默认消息Q同一般的应用E序消息资源攑֜一赗如下：
application.properties:
#Normal resource bundle messageslabel.firstName=First Name
label.lastName=Last Name
#Error messages used by the Validator
errors.required={0} is required.
errors.minlength={0} can not be less than {1} characters.
errors.maxlength={0} can not be greater than {1} characters.
errors.invalid={0} is invalid
.........
label.lastName=Last Name
#Error messages used by the Validator
errors.required={0} is required.
errors.minlength={0} can not be less than {1} characters.
errors.maxlength={0} can not be greater than {1} characters.
errors.invalid={0} is invalid
.........
当一个验证规则失败时Q这个验证规则创Z个错误信息。框架将自动l消息插入参数。比如说Q我们用例一和例二的验证规则Q当checkoutForm的firstName属性ؓI时Q我们会看到q样的错误信息：
First Name is required.
你也可以修改l定或配|文件来昄你喜Ƣ的消息?BR>
“挂”Validator到Struts?/B>
现在我们已经了解了Validator框架Q感觉蛮不错吧！下面我们快速的讲一下我们是如何L地在Struts框架中用Validator框架的?BR> 首先要做的就是让Struts框架认识Validator框架。你可以使用Struts1.1的Plug-in新特性来实现它。只要在Struts配置文g中增加下面代码即可：
struts-config.xml:
<plug-in classname="org.apache.struts.validator.ValidatorPlugIn">
<set-property property="pathnames"
value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml"/>
</plug-in>
<set-property property="pathnames"
value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml"/>
</plug-in>
q样Struts可以自动识别Validator框架了?BR> 另外一个必需的步骤就是创建ActionForm BeanQ标准的或是动态的Q和保Validator框架的配|文件是可用的，q样搞定了。ƈ不需要作一些调用验证规则或做其他具体的事情QStruts框架会自动完成这些工作，q就是所谓的Z声明的配|。然后当验证规则p|的时候，你就可以用JSP标签看到昄的错误信息了?BR>
创徏自己的Validator
管Validator框架已ؓ大家提供了Web应用E序需要的大多数验证规则，但有时我们还是需要创Z些自q验证规则。幸q的QValidator框架的扩展性相当好Qؓ你提供了q种便利Q而这样做对程序造成的媄响相当小的?BR> 创徏自己的Validatorq不是一仉事，只要创徏一个实现这个规则的Javacd可。比如，Q在国外Q要去超市买二锅_要验证顾客是否达到合法饮酒年龄。你可以使用已有的验证规q行验证Q但我们觉得创徏一个验证规则进行验证要更加直截了一些。验证饮酒年龄规则Validator Java代码如下:
Validator.Java
import java.io.Serializable;
import javax.servlet.http.HttpServletRequest;
import org.apache.commons.validator.Field;
import org.apache.commons.validator.GenericValidator;
import org.apache.commons.validator.ValidatorAction;
import org.apache.commons.validator.ValidatorUtil;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.util.StrutsValidatorUtil;
public class NewValidator implements Serializable
{
public static boolean validateDrinkingAge( Object bean,ValidatorAction va,
Field field,
ActionErrors errors,
HttpServletRequest request)
{ String value = null;
if (isString(bean)) {
value = (String) bean;
} else {
value = ValidatorUtil.getValueAsString(bean, field.getProperty());
}
String sMin = field.getVarValue("drinkingAge");
if (!GenericValidator.isBlankOrNull(value)) {
try {
int iValue = Integer.parseInt(value);
int drinkingAge = Integer.parseInt(sMin);
if ( iValue < drinkingAge ){
errors.add(field.getKey(), StrutsValidatorUtil.getActionError(request, va, field));
return false;
}
} catch (Exception e) {
errors.add(field.getKey(), StrutsValidatorUtil.getActionError(request, va, field));
return false;
}
}
return true;
}
private static boolean isString(Object o) {
if (o == null) {
return (true);
}
return (String.class.isInstance(o));
}
}
在非Struts应用E序中用Validator框架
正像我们在前面谈到的QValidator框架最初是为在Struts框架中用而设计的。可是，Validator框架设计的相当灵z，q没有直接把它耦合在Struts框架中，q样你就可以在普通的应用E序中也可以使用Validator框架来进行验证。但是，你必L行一些必需的步骤?BR> 你可以利用像在Web应用E序中一样用配|文件。这也是使用Validatoe框架的另一个优炏V你可以在Struts框架使用插g的方式来定位和装载这些文件。而在非Struts应用E序中你必须Zؓ地手动的定位和装载这些配|文件。下面就是应用程序在启动时一般要调的ҎQ?BR>
ValidatorResources resources = new ValidatorResources();InputStream rules = ValidateExample.class.getResourceAsStream("validator-rules.xml");ValidatorResourcesInitializer.initialize(resources, in);InputStream forms = ValidateExample.class.getResourceAsStream("validation.xml");ValidatorResourcesInitializer.initialize(resources, forms);//假设我们已经创徏和装配了一个CheckoutForm Bean对象CheckoutForm form = new CheckoutForm();//使用chekoutForm创徏一个ValidatorValidator validator = new Validator(resources, "checkoutForm");//告诉Validator要验证哪个Beanvalidator.addResource(Validator.BEAN_KEY, form);//验证checkoutForm对象q存储验证结?/SPAN>ValidatorResults results = validator.validate();最后我们简单的阐述一下Validator框架对JavaScript的支持。因为有些应用程序需要执行一些客L验证Q在某些时候用JavaScriptq行一些客L的验证是很有必要的。这里的客户端我们一般特指Web览器?BR> Validator框架提供使用配置文g中的规则动态和自动生成JavaScript验证规则的支持。对于每?lt;validator>元素Q它可以有一?lt;javascript>子元素和包含一些JavaScript代码。当包含一些自定义标签的JSP面被解释时QJavaScript也被解释Qƈ当表单提交时执行q些验证规则。这些叫JavaScriptValidatorTag的标{被包含在Struts的标{N中。这些标{֏以像q样q行使用Q?BR><html:javascript formName="checkoutForm"/>
W者认为在需要时使用一定的JavaScript是可以接受的。当你需要执行一些客L的验证时Q用Validator框架标签是也是一U不错的选择Q而且支持Ҏ用户的区域进行本地化?BR>l束?/B>
到此为止Q我l大家简单地介绍了Validator框架Q这些其实是框架的一些表面的东西。这个框架的内容׃可测Q仅正则表达式就可以写一本小册子?BR> 像Q何一个框架一PValidator框架为大家提供的是一个基的架构，你可以根据你的需求对其进行扩展和个性化。用像Validator的框架的最重要的一点就是它们是l过千锤癄Q是技术的_֍。。你q不需重蹈前hp|的覆辙，你可以节省下旉把更多的_֊集中在对业务逻辑的开发上?BR>
作者简介：
Chuck CavanessQ毕业于Georgia TechQ获计算机工E与U学学位Q在ȝQ银行和B2B领域创徏了许多Java企业pȝQ同时也是O'Reilly的Programming Jakarta Struts ?Jakarta Struts Pocket Reference两本书的作者?/I>
]]>