使用Struts提供的Validator框架进行验证(lp)

 

Validator支持服务器端和客户端（JavaScript）的验证。使用Validator框架的步骤为：

 

一、添加struts 应用。

       “Add web project Capabilitily” →“Add Struts Capabilitily”在我们为工程“Add Struts Capabilitily”时会自动生成validator-rules.xml，ApplicationResources.properties两文件。

 

二、启用Validator插件

虽然Validator框架是与Struts封装在一起提供的，但在默认状况下Validator并不被启用。为了启用Validator，要在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 >

该定义告诉Struts为你的应用程序加载并初始化Validator插件。在初始化时，该插件装入由路径名属性指定的、用逗号分隔的Validator配置文件清单。每个配置文件的路径应该用与Web应用程序的相关的路径来指定，

 

 

三、创建Form Bean

为了使用Validator，你的应用程序的Form Bean必须归到Validator的ActionForm的某一子类，而不是ActionForm本身。Validator的ActionForm子类提供了ActionForm的validate( )方法（它嵌入到Validator框架中）的实施过程。你不必从头编写验证代码并把它投入validate( )方法中，相反，可以完全忽略该方法，因为Validator为你提供了验证代码。

public class UserBean extends ValidatorForm {……}

注意：继承的时候应选择 org.apache.struts.validator.ValidatorForm 。

 

四、struts-config.xml中增加验证功能。

Struts-config.xml

< form-beans >

       < form-bean name = "userBean" type = "com.lipeng.bean.UserBean" />

</ form-beans >

 

< action

      attribute = "userBean"

      input="/login.jsp" validate="true"

      name = "userBean"  path="/login" scope="request"

      type = "com.lipeng.action.LoginAction" >

      < forward name = "ok" path = "/loginok.jsp" />

      < forward name = "fail" path = "/loginfail.jsp" />

   </ action >

 

五、配置validation.xml

validation.xml确定哪个验证例行程序应用到哪个Form Bean。文件中的定义使用struts-config.xml文件给出的Form Bean的逻辑名称以及validator-rules.xml文件给出的验证例行程序的逻辑名称，以便把二者关联起来。

       < form name = "userBean" >

           < field property = "username" depends = "required" >

              < arg0 key = "personal.key1" ></ arg0 >

           </ field >

    </ form >

 

附：这里的required是validator-rules.xml中定义的：

    Arg0 是required中msg 中的参数，即代替 errors.required 中的 {0}

 

六、配置ApplicationResources.properties

Validator使用Struts的资源绑定（Resource Bundle）机制将错误消息具体化。不用在框架中对错误消息进行硬编码，Validator使你能在ApplicationResources.properties文件中为一个消息指定一个键值，如果验证失败则将返回该键值。validator-rules.xml文件中的每个验证例行程序都用validator-rules.xml中的validator标记的 msg 属性指定错误消息的键值，如下所示：

< validator name = "required"

            classname = "org.apache.struts.validator.FieldChecks"

             ……

                  msg = "errors.required" />

ApplicationResources.properties文件：

errors.required= {0} is required.

errors.minlength= {0} cannot be less than {1} characters.

errors.maxlength= {0} cannot be greater than {2} characters.

errors.invalid= {0} is invalid.

errors.byte= {0} must be a byte.

errors.short= {0} must be an short.

errors.integer= {0} must be an integer.

errors.long= {0} must be an long.

errors.float= {0} must be an float.

errors.double= {0} must be an double.

errors.date= {0} is not a date.

errors.range= {0} is not in the range {1} through {2} .

errors.creditcard= {0} is not a valid credit card number.

errors.email= {0} is an invalid e-mail address.

 

personal.key1= username

 

 

七、启用客户端验证

Validator除了提供了简化服务器端表单数据验证过程的框架外，它还提供了执行客户端验证时易于使用的方法。在validator-rules.xml文件中定义的每一个验证例行程序都可以随意指定JavaScript代码，这些代码可以在浏览器（客户端上的）中运行，从而执行与服务器端进行的验证相同的验证过程。在客户端进行验证时，除非所有表单都通过验证，否则这些表单不允许被提交。

 

要启动客户端验证，你必须在相应的JSP文件中做如下设置：

1. 为<html:form>增加onsubmit属性 

< html:form action = "/login" method = "post"  onsubmit = "return validateUSserBean(this);" >

2. 设置Javascript支持 

javascript标记要求使用formName属性来为想要对其执行验证的表单指定validation.xml文件中给出的表单定义名，如下所示：

    < html:javascript formName = "userBean"   dynamicJavascript

= "true"    staticJavascript = "true" />

 

 

附：login.jsp

   < body >

  < html:errors /> // 输出验证失败的信息

    < html:javascript formName = "userBean" />

< html:form action = "/login" method = "post"  onsubmit = "return validateUSserBean(this);" >

      < table border = "0" >

        < tr > Username: < html:text property = "username" /></ tr >

        < tr > Password: < html:password property = "password" /></ tr >

        < tr >< html:submit /> </ tr >

      </ table >

    </ html:form >

</ body >

 

为表单定义指定的服务器端的所有验证都将在客户端运行。由于客户端验证用JavaScript执行，所以可以有多种方法不去执行它。要确保验证过程总是能运行，不论你是否选择启用了客户端验证，Validator都在服务器端执行这些验证。此时，Struts将根据xml配置文件中的定义来检验表单输入，并将不符合要求的错误信息输出到页面。但是你可能会想：这个功能虽然好，可是什么检验都跑到服务器端执行，效率方面和用户易用性方面是不是有些问题？你可能会怀念起那简单的JavaScript客户端验证。不用担心，在Struts 1.1中也支持JavaScript客户端验证。如果你选择了客户端验证，当某个表单被提交以后，Struts 1.1启动客户端验证，如果浏览器不支持JavaScript验证，则服务器端验证被启动，这种双重验证机制能够最大限度地满足各种开发者的需要。JavaScript验证代码也是在validator-rules.xml文件中定义的。