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:
<bean id="validatorFactory" class="org.springmodules.commons.validator.DefaultValidatorFactory">①<property name="validationConfigLocations"> ②<list>
<value>/WEB-INF/validator-rules.xml</value>
<value>/WEB-INF/validation.xml</value></list></property>
</bean><bean id="beanValidator" class="org.springmodules.commons.validator.DefaultBeanValidator">③
<property name="validatorFactory">
<ref bean="validatorFactory"/> ④</property>
</bean>
① 声明validatoFactory 这里我们使用spring的DefaultValidatorFactory
② 定义其validationConfigLocations属性,将validator-rules.xml和validation.xml传入
③ 声明beanValidator 这里我们使用spring的DefaultBeanValidator
④ 在其属性中指明要使用的validatorFactory 。这里我们使用刚刚定义的validatorFactory
2. 在需要进行验证的controller(即要使用form表单或者command的controller)中声明validate。
<bean id="xxxxController" ……>
<property name="commandName" value="userCommand"/> ①
<property name="commandClass" value="com.resoft.User"/> ②
<property name="validator" ref="beanValidator"/> ③
……
</bean>
① commandName 用于指明需要验证的command的名字,这个名字必须和validation.xml中<form name=" xxxxx"> 所写的名字保持一致。
② commandClass用于指定这个command的类型。其必须与你jsp提交的form最后形成的command类型相一致。
③ 声明该controller使用validator,这里将我们刚刚定义的beanValidator传入进去。
3. 在validation.xml文件中,定义你要校验的formbean(或者说是command),定义这个bean中有哪几个field需要验证,使用何种规则验证。(注意:这里定义的form name必须和前面controller中定义的commandName保持一致)以下是几种常用的验证示例:
<form-validation>
<formset>
<form name="userCommand"> ① <field property="userId"depends="required"> ② <arg0 key="用户代码"/> ③ </field>
①这里是定义要验证的bean的名字,要求去上面定义的commandName相同
②这里定义要验证的bean属性为userId,使用规则为required(不为空)
③这里定义的是显示信息,arg0表示位置0的显示信息,显示key所标明的信息(如果你还有多个信息就用arg1,arg2等)出错信息将会显示为: 用户代码不能为空
<field property="age" depends="required,integer,mask"> ① <arg0 key="年龄" /> <msg name="mask" key="errors.negative"/> ② <var> <var-name>mask</var-name> <var-value>^[1-9]</var-value>③ </var></field>
① mask标记验证,使用正则表达式来约束表单输入值。(如:只能输入数字,字母或指定的字符)
② msg标签用来定义验证规则和出错信息的关联,这里表示当出现mask校验失败时,显示errors.negative指明的信息。
③ 整个<var>标签就是用来定义具体的规则的,如<var-name>mask</var-name>指明是用于mask的规则,<var-value>^[1-9]</var-value>表示只允许1-9这几个数字开头。所以上面验证信息是年龄字段不可以为空,必须为整数,而且必须为1-9开头 也就杜绝了负数和零的情况。
<field property="birthday" depends="required,date"> ①
<arg0 key="生日"/> <var>
<var-name>datePatternStrict</var-name> ②
<var-value>yyyy-MM-dd</var-value> ③
</var>
</field></formset>
① 使用“date”加入对日期的格式的校验
② 开始定义日期格式,var-name必须写为datePatternStrict
③ 定义你希望的日期格式如:yyyy-mm-ddyy/mm/dd等等都可以。
<field property="startDate" depends="required,date">
<arg0 key="开始日期"/>
<var>
<var-name>datePatternStrict</var-name>
<var-value>yyyy-MM-dd</var-value>
</var>
</field>
<field property="endDate"depends="required,date,compareTwoField"> ①
<arg0 key="结束日期" />
<arg1 key="开始日期" /> ②
<var>
<var-name>datePatternStrict</var-name>
<var-value>yyyy-MM-dd</var-value>
</var>
<var>
<var-name>secondField</var-name> ③
<var-value>startDate</var-value>
</var>
</field>
① 这里演示的是两个日期的验证,要达到开始日期不能晚于结束日期,加入ompareTwoField验证规则
② 定义第2个显示参数agr1“开始日期”
③ 加入一个var其var-name为secondField(这个是在程序中写死的,必须写为secondField)
④ var-value定义为开始日期的属性名,如在本例中为startDate
注:compareTwoField是我们自己编写的一个校验规则,用于比较两个字段值大小。
4. 在jsp页面中定义错误信息显示语句:
<spring:bind path="tableCrashDO.*"> ①
<c:if test="${not empty status.errorMessages}">
<div class="error">
<c:forEach var="error" items="${status.errorMessages}">
<c:out value="${error}" escapeXml="false"/><br/>
</c:forEach>
</div>
</c:if>
</spring:bind>
① 这里的path必须要与传入该jsp的bean的名字一样。如传入该jsp的数据bean叫tableCrashDO,path就应该写为tableCrashDO.*。
5.使客户端产生javascript代码:
<v:javascript formName="tableCrashDO" ①
staticJavascript="false"xhtml="true"cdata="false"/>
<script type="text/javascript"src="<c:urlvalue="scripts/validator.jsp"/>"></script>
①v:javascript标签是spring的标签,定义在spring-commons-validator.tld。其中formName必须与validation.xml中form的name保持一致。
(特别注意: controller中的commandName; validation.xml中的form name; jsp中v:javascript标签的formName三者必须保持一致。)
以上以即为所用到的validation.xml的应用方面,我们还忽略了一个重要部分,即validation-rule.xml,该文件必须包含Spring框架模型中的基本元素。从名字即可知道这个文件的作用,即定义验证规则,抽取文件中验证规则的一个如下:
<validator name="required"
classname="org.springmodules.validation.commons.FieldChecks"
method="validateRequired"
methodParams="java.lang.Object,
org.apache.commons.validator.ValidatorAction,
org.apache.commons.validator.Field,
org.springframework.validation.Errors"
msg="errors.required">
<javascript><![CDATA[
function validateRequired(form) {
var isValid = true;
var focusField = null;
var i = 0;
var fields = new Array();
oRequired = new required();
for (x in oRequired) {
var field = form[oRequired[x][0]];
if (field.type == 'text' ||
field.type == 'textarea' ||
field.type == 'file' ||
field.type == 'select-one' ||
field.type == 'radio' ||
field.type == 'password') {
var value = '';
// get field's value
if (field.type == "select-one") {
var si = field.selectedIndex;
if (si >= 0) {
value = field.options[si].value;
}
} else {
value = field.value;
}
if (trim(value).length == 0) {
if (i == 0) {
focusField = field;
}
fields[i++] = oRequired[x][1];
isValid = false;
}
}
}
if (fields.length > 0) {
focusField.focus();
alert(fields.join('\n'));
}
return isValid;
}
// Trim whitespace from left and right sides of s.
function trim(s) {
return s.replace( /^\s*/, "" ).replace( /\s*$/, "" );
}
]]>
</javascript>
</validator>
完毕