关于Spring中Commons Validator的使用说明及MVC验证的配置步骤

关于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：

 

<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-dd  yy/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>

 

①         这里演示的是两个日期的验证，要达到开始日期不能晚于结束日期，加入compareTwoField 验证规则

②         定义第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:url value="scripts/validator.jsp"/>"></script>

 

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

 

如此以来，基本上可以算完成了validate的验证配置。

（特别注意： controller 中的commandName； validation.xml中的form name； jsp中v:javascript标签的formName三者必须保持一致。）

 

参考：http://blog.csdn.net/lyq1985/archive/2009/02/23/3926650.aspx

Spring MVC验证的配置步骤

这是我在练习MVC验证时的大致步聚,其中不少文件来源于appFuse框架.先记下来,供自己以后参考. ^_^

看这个步骤前,最好先看一下” jamyy2000的专栏”(我已经在我的另一篇文章中做了转发).

1.从appFuse中拷贝 ApplicationResources_zh_CN.properties 和 ApplicationResouces.properties到项目的src根目录下

2.拷贝 validation.xml 和 validator-rules.xml 到WebRoot/WEB-INF下

3.在web.xml中加:
    <!--加载资源文件-->
    <context-param>
        <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
        <param-value>ApplicationResources</param-value>
    </context-param>

4.在application中加:
    <bean id="validatorFactory" class="org.springmodules.validation.commons.DefaultValidatorFactory">
        <property name="validationConfigLocations">
            <list>
                <value>/WEB-INF/validation.xml</value>
                <value>/WEB-INF/validator-rules.xml</value>
            </list>
        </property>
    </bean>

    <bean id="beanValidator" class="org.springmodules.validation.commons.DefaultBeanValidator">
        <property name="validatorFactory" ref="validatorFactory"/>
    </bean>
   
   
   <!-- 加载资源文件 -->
   <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
        <property name="basename" value="ApplicationResources"/>
    </bean>

5.controller的配置为:
 <bean id="controller.TestCtrl" class="controller.TestCtrl">
  <property name="formView">     -->刚开始进去时要执行的JSP文件
    <value>/jsp/test</value>
  </property>
  <property name="successView">   -->在controller中判断如果执行submit后,要去的JSP
    <value>/8jsearch/jsp/welcome.jsp</value>
  </property>
  <property name="commandName" value="user"/>   -->domain类名,注意一定要小写,
         并且和validation.xml中form的名字一样
  <property name="commandClass" value="domain.User"/>
  <property name="validator" ref="beanValidator"/>  
 </bean>

6.(1)下载springmodules.jar时,一个要下那个带依赖类的, 要验证email时,需要导入包 oro-2.0.8.jar
  (2)antlr/错误,少一个antlr.jar包,是用来扫描代码用的,是代码扫描器.hibernate3.0包中,就用它来翻译hql语句. 可以到www.antlr.org下载
  (3)我用到的jar包:
     antlr-2.7.5.jar
     commons-beanutils-1.7.0.jar
     commons-digester-1.7.jar
     commons-validator-1.3.0.jar
     jstl.jar
     oro-2.0.0.jar
     spring-modules-0.5-all.jar
     spring.jar
     standard.jar

参考：http://www.itus.cn/programe/design/5/Java-21193.shtml