转自:http://student.csdn.net/space.php?uid=126037&do=blog&id=28776
我们按照开发步骤讲解:
1. 首先我们新建一个项目,导入Struts框架;
2. 导入Struts框架之后我们可以看到,在WEB-INF目录下有一个validator-rules.xml,这说明在导入Struts的时候validate框架也被导入进来了。validator-rules.xml 验证模板,里面定义了各种常见的验证规则,我们不需要对这个文件进行编辑,我们只需要使用模板里面定义的验证规则即可.当然我们也可以自己手写一个validator-rules.xml文件,但是必须以http://jakarta.apache.org/commons/dtds/validator_1_1_3.dtd约束它。
3. 在此基础上我们还必须自己定义一个xml文件。文件名可以任意命名,例如:validator.xm(同样他必须导入相应版本的dtd文件约束它),但是,文件必须创建在类加载器能够加载到得目录下,一般我们放在WEB-INF目录下; 这个配置文件由我们自己编辑,描述使用哪种类型的验证模板来进行验证.
4. 由于Validate框架是Struts之外的框架部分,所以我们必须在Struts中导入验证框架的插件(org.apache.struts.validator.ValidatorPlugIn);在基于以上的步骤之后,我们必须配置Struts-config.xml,加载插件和插件所学要的文件了,如下: <plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>
<!-- set-property property="stopOnFirstError" value="true"/> -->
</plug-in>
5. 接下来我们就开始做具体的验证了,我们看如下代码:
<form-validation>
<global></global>
<formset>
<constant>
<constant-name></constant-name>
<constant-value></constant-value>
</constant>
<form name="regForm">
<!-- Validate name -->
<field property="name" depends="required,maxlength">
<arg0 key="name"/>
<arg1 key="${var:maxlength}" resource="false"/>
<var>
<var-name>maxlength</var-name>
<var-value>20</var-value>
</var>
</field>
</formset>
</form-validation>
这是我们在/WEB-INF/validator.xml中配置的一段验证用户名的简单配置信息,接下来我们看看相应的dtd文件的定义:
<!ELEMENT form-validation (global*, formset*)> --根元素(必须有1-n个global,formset)
<!ELEMENT formset (constant*, form+)> --form是必须有一个的,constant可选的
<!ATTLIST formset language CDATA #IMPLIED>
<!ATTLIST formset country CDATA #IMPLIED>
<!ATTLIST formset variant CDATA #IMPLIED>
<!ELEMENT form (field+)> --field也是至少有一个
<!ATTLIST form name CDATA #REQUIRED>
<!ELEMENT field (msg|arg|arg0|arg1|arg2|arg3|var)*> --在field中可以有o-n个msg|arg| var
<!ATTLIST field property CDATA #REQUIRED>
<!ATTLIST field depends CDATA #IMPLIED>
<!ATTLIST field page CDATA #IMPLIED>
<!ATTLIST field indexedListProperty CDATA #IMPLIED>
<!ELEMENT msg EMPTY>
<!ATTLIST msg key CDATA #REQUIRED>
<!ATTLIST msg name CDATA #REQUIRED>
<!ATTLIST msg bundle CDATA #IMPLIED>
<!ATTLIST msg resource CDATA #IMPLIED>
<!ELEMENT arg EMPTY>
<!ATTLIST arg key CDATA #REQUIRED>
<!ATTLIST arg bundle CDATA #IMPLIED>
<!ATTLIST arg name CDATA #IMPLIED>
<!ATTLIST arg resource CDATA #IMPLIED>
<!ATTLIST arg position CDATA #IMPLIED>
…………
……
<!ELEMENT var (var-name, var-value, var-jstype?)>
<!ELEMENT var-name (#PCDATA)>
<!ELEMENT var-value (#PCDATA)>
<!ELEMENT var-jstype (#PCDATA)>
这里我们就不一一讲解dtd文件了,这不是今天的重点,结合dtd和以上的xml文件可以一目了然的了解验证的结构,这里我们简单的讲述下一些元素和属性的作用:、
Global: 着这里我们可以定义formset一些公用的属性或者对象;
Formset:要验证表单的集合;
Constant:着这里我们可以定义form一些公用的属性或者对象;
Form: 相当于就是一个表单元素,他有一个name属性,如:name="regForm";
我们说这里的name的值可以不与struts-config.xml中From的一样,有些时候我们可以填写一个Action的路径;
Field: 表单字段
|-property="name" 该属性表示了字段的名字,和AcitionForm中的必须一致;
|-depends="required,maxlength";该属性用于指定验证的规则;
Arg:用于填充验证结果的参数;
|-key="" ;该属性用于指向参数的值;
|-resource="" ;该属性用于控制程序是否读取配置文件;
|-name=””;该属性用于指定验证规则的名字;
Msg:用于覆盖验证规则文件中的消息信息,(自定义信息);
6. 既然我们是要验证表单,当然我们在struts-config.xml中的Action配置validate=”true” input=”…”是必须的。
7. 这个时候我们就需要在资源文件中配置好验证要用到的信息了;建议大家从validator-rules.xml 直接拷贝即可;
8. 我们以前在一个最普通的ActionFrom中做验证是实现它的Validate(……)方法,手工写验证步骤,在我们用了validate框架之后呢? 我的From就不直接继承ActionFrom了,我们改变继承ValidatorForm,这个类里面已经为我们写好了一个验证的方法,所以我们如果在自己的Form中还保留这个方法的话就会覆盖父类中的验证方法,这对于我们来说是毫无意义的,所以我们必须在自己的Form中注释或者删除验证方法。这里需要我们注意的是:当使用的是动态From时候,我们继承是ValidatorActionForm
9. 到这里我们已经是万事俱备,只欠显示了,最后我们在页面上打入struts标签库,<bean:message ……/>可以完成我们的验证了。
10.我上述讲解的是后台验证,在struts中结合validate框架可以轻松的实现前台的JavaScript验证,从而减轻服务器的负担,因为它会自动生成JavaScript脚本,下面我们来看看前台验证的步骤:
1).前提是后台已经实现了一套validate验证;
2).在jsp页面上的JavaScript区域(head之间)加上如下代码:
<html:javascriptform Name="regForm" method="validateRegForm"/>
Name属性是Form的名称;method:生成JavaScript验证方法的名称,默认为validate+From名称;
3).在表单上添加 onSubmit 方法即可,如:οnsubmit=”return validateRegForm(this)”,这里必须传入一个参数,这个参数真是我们当前的from对象。
--值得我们注意的是:上面只是简单的讲述validate框架在struts使用步骤,我们知道验证框架是一个非常强大的独立的验证体系,他可以应用于我们很多的应用程序,它不依赖于struts,如果想更深入如的了解这个框架,必须去看他的api和源码,在validate框架中为我们提供的验证规则也就是基本的验证,不能满足我在开发中的需求,但是框架我们提供了自定义的验证方法,只需要按照他的规则定义并且配置validator-rules.xml的相关信息即可,这里只提供思路:
一、 首先我们自定一个验证的类:CheckIdCard.java
public class CheckIdCard implements Serializable {
public static boolean validateIdCard(Object bean,
ValidatorAction va,
Field field,
ActionMessages errors,
Validator validator,
HttpServletRequest request) {
//此处写我们验证的逻辑。
。。。。。。。。。。。。。。
}
类里面定义的都是静态的方法哦。
二、配置validator-rules.xml的相关信息
<validator name="idCard"
classname="org.rao.struts.util.CheckIdCard "
method=" validateIdCard "
methodParams="java.lang.Object,
org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.apache.struts.action.ActionMessages,
org.apache.commons.validator.Validator,
javax.servlet.http.HttpServletRequest"
depends=""
msg="errors.idCard"
jsFunction="******* "/>
这就相当我们已经注册好了一个验证规则了,jsFunction="******* ":这里我们没有实现它的JavaScript验证,大家有兴趣可以自己研究。
关于struts validate框架基于不同actionForm,配置文件中validate属性的默认值区别
Form Bean中:
1、<form-bean name="loginForm" type="com.lwf.action.LoginForm"/> ,LoginForm继承自ActionForm; 那么<action 中默认validate属性值为true,会执行验证,但是客户点击验证提示后会自动提交到action处理,所以验证相当于无效的。即使设置了validate="true"属性,验证后也会提交到action处理,验证无效。
2、<form-bean name="loginForm" type="com.lwf.action.LoginForm"/>,LoginForm继承自ValidatorForm;那么<action 中默认validate属性值为true,会执行验证,客户点击验证提示后不会自动提交到action处理,所以验证有效。
3、<form-bean name="loginForm" type="org.apache.struts.validator.DynaValidatorForm"> 那么<action 中默认validate属性值为true,会执行验证,客户点击验证提示后不会自动提交到action处理,所以验证有效。
4、<form-bean name="loginForm" type="org.apache.struts.action.DynaActionForm">那么<action 中默认validate属性值为true,会执行验证,但是客户点击验证提示后会自动提交到action处理,所以验证相当于无效的。即使设置了validate="true"属性,验证后也会提交到action处理,验证无效。
附件为与validate相关的文档