关于Spring中Commons Validator的使用说明

spring的validate验证需要两个bean（ValidatorFactory、BeanValidator）及两xml文件（validator-rules.xml、validation.xml）的支持，ValidatorFactory用于制造BeanValidator，后者则是在程序中执行校验的控制bean。Validatorrules.xml中定义了各种验证的规则，如字段不为空，字段输入值必须为整数等等。Validation.xml中则定义了那些bean及bean中的哪些属性字段需要验证，使用哪些验证规则。validate 分为两级验证，客户端验证（javascript）和服务器端验证。以下是使用validate的步骤：
1. 在配置文件中声明ValidatorFactory 和 BeanValidator：

[align=left]<bean id="validatorFactory" class="org.springmodules.commons.validator.DefaultValidatorFactory"> -----①[/align]
[align=left] <property name="validationConfigLocations"> -----②[/align]
[align=left] <list>[/align]
[align=left] <value>/WEB-INF/validator-rules.xml</value>[/align]
[align=left] <value>/WEB-INF/validation.xml</value>[/align]
[align=left] </list>[/align]
[align=left] </property>[/align]
[align=left] </bean>[/align]
[align=left] <bean id="beanValidator" [/align]
[align=left]class="org.springmodules.commons.validator.DefaultBeanValidator"> -------③[/align]
[align=left] <property name="validatorFactory">[/align]
[align=left] <ref bean="validatorFactory" /> --------④[/align]
[align=left] </property>[/align]
</bean>

① 声明validatoFactory 这里我们使用spring 的DefaultValidatorFactory
② 定义其validationConfigLocations属性，将validator-rules.xml和validation.xml传入
③ 声明beanValidator 这里我们使用spring的DefaultBeanValidator
④ 在其属性中指明要使用的validatorFactory 。这里我们使用刚刚定义的validatorFactory

2. 在需要进行验证的controller（即要使用form表单或者command的controller）中声明validate。

<beanid="xxxxController" ……>
<property name="commandName" value="userCommand"/> -----①
<property name="commandClass" value="com.resoft.User"/> -----②
<property name="validator" ref="beanValidator"/> -------③
……
</bean>

① commandName 用于指明需要验证的 command的名字，这个名字必须和 validation.xml中<formname=" xxxxx "> 所写的名字保持一致。
② commandClass用于指定这个command的类型。其必须与你jsp提交的form最后形成的command类型相一致。
③ 声明该controller使用validator，这里将我们刚刚定义的beanValidator传入进去。

3. 在validation.xml文件中，定义你要校验的formbean（或者说是command） ，定义这个bean中有哪几个field需要验证，使用何种规则验证。（注意：这里定义的form name 必须和前面controller中定义的commandName保持一致）以下是几种常用的验证示例：

<form-validation>
[align=left]<formset>[/align]
[align=left]<form name=" userCommand "> -----①[/align]
[align=left] <field property="userId" depends="required"> -----② [/align]
[align=left] <arg0 key="用户代码" /> -------③ [/align]
[align=left] </field> [/align]
[align=left] [/align]
① 这里是定义要验证的bean的名字，要求去上面定义的commandName相同
② 这里定义要验证的bean属性为userId，使用规则为required(不为空)
③ 这里定义的是显示信息，arg0表示位置 0 的显示信息，显示key 所标明的信息（如果你还有多个信息就用 arg1，arg2 等）出错信息将会显示为： 用户代码不能为空
[align=left] [/align]
[align=left] [/align]
[align=left]<field property="age" depends="required,integer,mask"> -----①[/align]
[align=left] <arg0 key="年龄" />[/align]
[align=left] <msgname="mask" key="errors.negative"/> -----②[/align]
[align=left] <var>[/align]
[align=left] <var-name>mask</var-name>[/align]
[align=left] <var-value>^[1-9]</var-value>-------③[/align]
[align=left] </var>[/align]
</field>

[align=left]① mask 标记验证，使用正则表达式来约束表单输入值。（如：只能输入数字，字母或指定的字符）[/align]
[align=left]② msg标签用来定义验证规则和出错信息的关联，这里表示当出现 mask 校验失败时，显示 errors.negative指明的信息。[/align]
③ 整个<var>标签就是用来定义具体的规则的，如<var-name>mask</var-name>指明是用于mask的规则，<var-value>^[1-9]</var-value> 表示只允许1-9这几个数字开头。
所以上面验证信息是年龄字段不可以为空，必须为整数，而且必须为1-9开头 也就杜绝了负数和零的情况。
[align=left] [/align]
[align=left] <field property="birthday" depends="required,date">-----①[/align]
[align=left] <arg0 key="生日" />[/align]
[align=left] <var>[/align]
[align=left] <var-name>datePatternStrict</var-name>-----②[/align]
[align=left] <var-value>yyyy-MM-dd</var-value> -----③[/align]
[align=left] </var>[/align]
</field>
[align=left] </formset>[/align]
[align=left] [/align]
[align=left]① 使用“date”加入对日期的格式的校验[/align]
[align=left]② 开始定义日期格式，var-name必须写为 datePatternStrict[/align]
[align=left]③ 定义你希望的日期格式如：yyyy-mm-dd yy/mm/dd 等等都可以。[/align]
[align=left] [/align]
[align=left] [/align]
[align=left]<field property="startDate" depends="required,date">[/align]
[align=left] <arg0 key="开始日期" />[/align]
[align=left] <var>[/align]
[align=left] <var-name>datePatternStrict</var-name>[/align]
[align=left] <var-value>yyyy-MM-dd</var-value>[/align]
[align=left] </var>[/align]
[align=left] </field>[/align]
[align=left] <field property="endDate" depends="required,date,compareTwoField"> -----①[/align]
[align=left] <arg0 key="结束日期" />[/align]
[align=left] <arg1 key="开始日期" /> -----②[/align]
[align=left] <var>[/align]
[align=left] <var-name>datePatternStrict</var-name>[/align]
[align=left] <var-value>yyyy-MM-dd</var-value>[/align]
[align=left] </var>[/align]
[align=left] <var>[/align]
[align=left] <var-name>secondField</var-name> -------③[/align]
[align=left] <var-value>startDate</var-value>[/align]
[align=left] </var>[/align]
[align=left] </field>[/align]
[align=left] [/align]
[align=left]① 这里演示的是两个日期的验证，要达到开始日期不能晚于结束日期，加入compareTwoField验证规则[/align]
[align=left]② 定义第2个显示参数agr1“开始日期”[/align]
[align=left]③ 加入一个var其var-name为secondField（这个是在程序中写死的，必须写为secondField）[/align]
[align=left]④ var-value定义为开始日期的属性名，如在本例中为 startDate [/align]
[align=left] [/align]
[align=left]注：compareTwoField 是我们自己编写的一个校验规则，用于比较两个字段值大小。[/align]
[align=left] [/align]
[align=left]4. 在jsp页面中定义错误信息显示语句：[/align]
[align=left] [/align]
[align=left]<spring:bindpath="tableCrashDO.*"> -----①[/align]
[align=left] <c:iftest="${not empty status.errorMessages}">[/align]
[align=left] <div class="error"> [/align]
[align=left] <c:forEachvar="error" items="${status.errorMessages}">[/align]
[align=left] <c:outvalue="${error}"escapeXml="false"/><br/>[/align]
[align=left] </c:forEach>[/align]
[align=left] </div>[/align]
[align=left] </c:if>[/align]
[align=left]</spring:bind>[/align]
[align=left] [/align]
① 这里的path必须要与传入该 jsp的bean的名字一样。如传入该jsp的数据bean叫tableCrashDO，path就应该写为tableCrashDO.*。

5．使客户端产生javascript代码：

[align=left]<v:javascriptformName="tableCrashDO" -----①[/align]
[align=left]staticJavascript="false" xhtml="true" cdata="false"/>[/align]
<script type="text/javascript" src="<c:urlvalue="scripts/validator.jsp"/>"></script>

① v:javascript标签是spring的标签，定义在spring-commons-validator.tld 。其中formName必须与validation.xml中form的name保持一致。

[align=center]如此以来，基本上可以算完成了validate的验证配置。[/align]
（特别注意： controller 中的commandName； validation.xml中的form name； jsp中v:javascript标签的formName三者必须保持一致。）