Struts从0开始5：Struts中验证数据实例

 一、Struts的ActionForm的表单验证

　　ActionForm类用于在视图层和控制层之间传递HTML表单数据。控制层可以从ActionForm Bean中读取用户输入的表单数据，也可以把来自模型层的数据存放到ActionForm Bean中，然后把数据返回给视图。即ActionForm Bean从HTML表单中获取用户输入的数据并将传递给Action类，也可以把从业务层返回的数据用来填充ActionForm Bean，然后JSP页面用它来为HTML表单提供各种输出字段的数据。此外，ActionForm Bean还具有表单验证功能，可以过路不合法的数据。

　　ActionForm Bean有两种存在范围：request和session。如果ActionForm Bean存在于request范围，它仅在当前的请求/响应生命周期中有效。如果ActionForm Bean存在于session范围，同一个ActionForm Bean实例在整个HTTP会话中都有效。

　　在Struts框架中，使用ActionForm Bean来实现应用程序系统的非持久性数据存储和维护功能，它采用了自动填充属性和调用的机制。所以必须继承ActionForm类，并且包涵用户表单输入的属性，以及相应的get方法和set方法。另外，还可以根据需要重写父类的reset()和validate()方法，实现属性的重置和表单数据验证功能。

　　 validate()方法

　　这个方法主要负责检查数据的格式和语法，而不负责检查数据是否符合业务逻辑。

　　ActionForm基类中的validate()方法在默认情况下将返回null。如果创建了ActionForm的子类，那么应该在子类覆盖validate()方法。

　　 reset()方法

　　这个方法用于恢复ActionForm Bean 的属性的默认值。例如：把字符串属性设为null或某个初始值。

　　1、 修改前面我们写的LoginActionForm，如果你不清楚的话，请您先看前几个实例，具体代码如下：

　　public ActionErrors validate(ActionMapping actionMapping,

　　HttpServletRequest httpServletRequest) {

　　ActionErrors errors = new ActionErrors();

　　if (username == null|| username.equals("")) {

　　errors.add(ActionErrors.GLOBAL_MESSAGE,

　　new ActionError("loginform.error.username"));

　　}

　　if (userpass == null||userpass.equals("")) {

　　errors.add(ActionErrors.GLOBAL_MESSAGE,

　　new ActionError("loginform.error.password"));

　　}

　　return errors;

　　}

　　这个方法返回ActionErrors对象，如果返回的ActionErrors对象为null,或者不包含任何ActionMessage对象，就表示没有错误，数据验证通过。如果ActionErrors中包含ActionMessage对象，就表示发生了验证错误，此时就回把请求转发到你struts.xml里面元素input属性指定的web资源。

　　new ActionError("loginform.error.username")；取得资源文件里面的键值，用于页面的输出。

　　2、 打开applicationResource.properties，加入如下信息：

　　loginform.error.username=please enter your username

　　loginform.error.password=please enter your password

　　因为我们前面做了国际化，所以打开applicationResource_zh_CN.properties文件，添加如下：

　　loginform.error.username=请输入用户名

　　loginform.error.password=请输入密码

　　3、 修改struts-config.xml文件

　　path="/login"

　　name="loginActionForm"

　　scope="request"

　　type="actions.LoginAction"

　　validate="true"

　　input="/login.jsp">

　　在元素中，name和scope属性分别指定ActionForm的名字和它的范围，valudate属性指定是否执行表单验证，而input属性表示验证失败，所要显示用户的内容。

　　4、 修改login.jsp，在元素添加，目的是显示错误信息，具体代码片段如下：

　　：用于输出消息。属性介绍如下：

　　n name：指定ActionMessages对象存放在request或session范围内的属性key。标签处理类将根据这一属性key来检索request或session范围的ActionMessages对象。

　　n message属性：指定消息的来源。如果为true,则从request或session范围内检索出属性key为Globals.MESSAGE_KEY的ActionMessages对象，此时name属性无效；如果为false,则根据name属性来检索ActionMessage对象，如果此时没有设置name属性，将采取默认值Globals.ERROR_KEY.message属性的默认值为false。

　　n id属性：用来命名从消息中检索出来的每个ActionMessage对象，它和标签的name属性匹配。

　　：表示显示javaBean或其属性的内容。

　　5、 运行

　　打开IE,键入如下地址：http://localhost:8080/Struts1_Login/login.jsp

　　不输入任何东西，我们直接点几击“确定”，如下：

　　

 

 

　　二、Struts的Validator验证框架

　　Validator 目前是Jakarta Commons 项目的一部分，它也被包含在Struts主分发里面，可以直接使用Struts 中自带的Validator 库，也可以去网站上下载http://jakarta.apache.org/commons/。

　　Struts框架能够通过ActionForm Bean的validate()方法对用户输入的表单数据进行验证。但是这种验证方式又有一定的局限性。必须由具体的代码来实现验证逻辑，如果验证逻辑发生了改变，就需要重新编写程序代码。此外，如果系统中有多个ActionForm Bean,并且他们包含一些相同的验证逻辑时，那么开发人员必须对每个ActionForm Bean进行重复开发呢?

　　Validator框架能够克服在ActionForm Bean中进行数据验证的局限性，它允许为Struts应用灵活的配置验证规则，无需编程。

　　Validator框架主要依赖于两个JAR文件：

　　 Jakarta-oro.jar

　　提供了一组处理文本的类，具有文本替换，过录和分割等功能。

　　 commons-validator.jar

　　提供了一个简单、可扩展的验证框架，包含了通用的验证方法和验证规则。

　　主要的Struts验证组件

　　组件

　　说明

　　验证器

　　处理原生和其它通用类型。基本验证器包括required，mask(匹配正则表达式)，minLength，maxLength，range，nativetypes， date，email，和creditCard。也可以定义定制 (或者插件) 验证器。

　　资源文件

　　提供(本地化的)标注和消息。默认与Struts 共享消息资源。

　　XML 配置文件

　　根据需要定义针对字段的表单集和验证。验证器可以在一个单独的文件中定义。

　　JSP 标签

　　对给定的表单或Action 路径产生Javascript 验证器。

　　ValidatorForm

　　根据FormBean 的名称自动验证属性（在运行时通过ActionMapping 参数传到validate 方法)。必须被扩展才能提供表单之上的期望属性的验证。

　　ValidatorActionForm

　　基于action 路径自动验证属性(在运行时通过ActionMapping参数传到validate 方法)。必须被扩展才能提供表单之上的期望属性的验证。

　　有些字段可能必须要求有数据输入。而邮政编码总是具有已知的长度。其它公共字段类型包括数值、日期、身份证号码等等。

　　验证器本身具有一些基本的验证器来处理这些公共需要，当然还有其它一些需要。如果你的验证不能被基本验证器或者正则表达式满足，你可以开发你自己的验证器并插入到包中。基本验证器支持其自身附带的基本插件。

　　安装和配置

　　Validator框架采用两个基于XML的配置文件来配置验证规则。一个是validator-rules.xml，另一个是validation.xml，这两个文件应该部署在对应于WEB应用程序的WEB-INF文件夹下，对应的两个jar文件也添加到WEB-INF/lib目录下。

1、 validation-rules.xml

　　在validation-rules.xml 文件中配置了一些全局性的验证规则，使得你在应用程序中使用校验而不用关注实现细节。这个配置文件是Validator 框架自带的，可以用在所有Struts应用中。它默认配置了许多很常用的规则，一般来说，不用去更改它，除非需要扩展或修改这些默认的验证规则。

　　建议：即使你需要扩展一些规则，也不要去修改validation-rules.xml，而是通过新的配置文件去定义你所扩展的校验规则。

　　validator-rules.xml文件的根元素是form-validation，它包含一到多个global元素，global元素包含一到多个validator 元素。

　　每一个validator 元素定义了一个唯一的验证规则。下面是validation-rules.xml 文件中的一个片断， (mask)验证规则：

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

　　method="validateMask"

　　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.invalid"/>

　　1） name： 赋予验证规则的一个唯一的名称。

　　2） classname： 指的是具体实现验证规则的类。

　　3） method： 指包含具体实现类的方法。

　　4） methodParams： 声明method属性所指定的方法参数，多个参数之间用逗号分隔。

　　5） depends： 指定在调用当前的严整规则之前必须先调用的其他验证规则。多个则用逗号分隔。

　　6） msg： 指定来自于Resource Bundle中的消息key。当验证失败时，validator框架根据这个消息key到Resource Boundle中查找匹配的消息。

　　2、 validation.xml

　　Validator框架所需要的第二个配置文件是validation.xml，这个配置文件是具体应用(项目)所特定的，可以根据你的应用(项目)情况进行自定义配置。它描述了具体的ActionForm使用validation-rules.xml文件中的哪个验证规则进行验证。

　　一个自定义的验证规则如下：

　　Validator.xml文件的根元素为元素，它包含两个子元素：和元素。

　　1） 元素可以定义子元素，它用来定义常量表达式。

　　2) 元素包含两个子元素：和。

　　3) 元素用于为表单配置验证规则，它的name属性表示你验证formBean，必须和struts-config.xml里面FormBean名字保持一致。元素可以包含一个或多个子元素。

　　4) 元素是针对表单中字段的验证规则。Property属性用于指定FormBean中需要验证的字段的名称，depends属性用于指定字段的验证规则，多个用逗号分隔。

　　5） 元素表示出错时的主体信息，key 是你属性文件里面的key。

　　6) 主要是对前面元素包含的验证规则的定义。

　　3、插入Validator

　　每一个Struts应用需要知道是否使用了Validator框架，可以通过PlugIn(插件)机制将Validator框架配置到Struts应用中。

　　下面的代码演示了如何将Validator 作为一个插件加入到Struts 应用中，在Struts 应用的配置文件Struts-config.xml 中加入如下代码片段：

　　value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>

　　pathnames属性的值用来指定Validator 框架所使用的配置文件，多个配置文件之间用逗号分隔。

　　当应用启动的时候，Struts框架将调用ValidatorPlugIn的init()方法。Validator框架的配置文件将会加载到内存中供应用使用。在init()方法被调用之前，pathnames所指定的值将会传递给ValidatorPlugIn的实例，ValidatorPlugIn实例将会依据这个值去加载配置文件。

 

 

　　案例说明：根据前面的例子我们进行进阶，要求用户输入用户名、密码。并且用户名、密码是必须，若为空，则提示错误信息。

　　A、服务器段验证

　　1、修改FormBean

　　我们以前的是继承ActionForm,现在改成ValidatorForm,导入相应的包，并删除validator和reset方法。

　　2、修改struts-config.xml文件，具体代码如下：

　　path="/login"

　　name="loginActionForm"

　　scope="request"

　　type="org.zhoudq.webapp.action.LoginAction"

　　validate="true"

　　input="/login.jsp">

　　将validator改为true，告诉服务器对这个表单进行验证，input的值，是告诉服务器如果严整失败的话，将跳转的页面。

　　3、添加验证规则

　　在WEB-INF下创建validaton.xml这个文件，导入引用的dtd，添加如下内容：

　　3、修改Resource Boundle文件：

　　英文的资源文件：applicationResource_en_US.properties

　　errors.required={0} is required.

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

　　errors.maxlength={0} can not be greater than {1} characters.

　　errors.invalid={0} is invalid.

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

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

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

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

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

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

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

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

　　errors.creditcard={0} is an invalid credit card number.

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

　　button.submit=Submit

　　button.reset=Reset

　　button.cancel=Cancel

　　label.username=UserName:

　　label.password=Password:

　　loginform.error.username=please enter your username

　　loginform.error.password=please enter your password

　　loginform.fail=invalidation name and password，login error！

　　中文的资源文件：applicationResource_zh_CN.properties

　　errors.required={0} 是必须的.

　　errors.minlength={0} 不能少于 {1} 个字符.

　　errors.maxlength={0} 不能多于 {1} 个字符.

　　errors.invalid={0} 是非法的.

　　errors.byte={0} 必须是 byte 类型.

　　errors.short={0} 必须是 short 类型.

　　errors.integer={0} 必须是 Integer 类型.

　　errors.long={0} 必须是 long 类型.

　　errors.float={0} 必须是 float 类型.

　　errors.double={0} 必须是 double 类型.

　　errors.date={0} 不是一个日期.

　　errors.range={0} 不在 {1}- {2} 之间.

　　errors.creditcard={0} 是一个非法的身份证号r.

　　errors.email={0} 是一个非法的油箱地址.

　　button.submit=确定

　　button.reset=重置

　　button.cancel=取消

　　label.username=用户名:

　　label.password=密码:

　　loginform.error.username=请输入用户名

　　loginform.error.password=请输入密码

　　loginform.fail=用户名或密码错误，登录失败!

 

 

　　5、在struts-config.xml添加validator

　　value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>

　　5、运行

　　打开IE,键入：http://localhost:8080/Struts1_Login/login.jsp，直接点确定，如下图：

　　

　　

　　B、客户端验证

　　这也表现了Validator验证框架的强大之处，又服务器生成javascript脚本，这样就直接在客户端进行验证了，从而减少了服务器的压力，万事有力又有避，这中方式服务器在生成脚本的同时又牺牲能性能，呵呵，看如何实现吧，一定很振奋吧.

　　1) 修改login.jsp页面

<%@ page contentType="text/html; charset=GBK"%>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
<html:html>
    <head><title>login</title></head>
    <body bgcolor="#ffffff">
    <h1>login</h1>
    <div>
        <font color="red">
            <html:messages id="error">
                <li><bean:write name="error"/></li>
            </html:messages>
           </font>

      </div>
              
    <html:javascript formName="loginActionForm" />
    <html:form action="login.do" οnsubmit="return validateLoginActionForm(this);">
    <bean:message key="label.username"/>
    <html:text property="username" />
    <br />
    <bean:message key="label.password"/>
    <html:text property="userpass" />
    <br>
    <html:submit property="submit"><bean:message key="button.submit"/></html:submit>
    &nbsp;<html:reset><bean:message key="button.reset"/></html:reset>
    </html:form>
    </body>
</html:html>

    a）<html：javascript formName="loginActionForm" />表示生成js代码，formName属性指定验证表单的名字，必须和struts-config.xml里面的form一样。

    b） <html：form action="login.do" οnsubmit="return validateLoginActionForm（this）；">当用户提交表单的时候，就会调用<html：javascript>标签生成的javascript脚本的方法，从而执行客户端的验证，其中的LoginActionForm是你FormBean的名字对用，必须和struts-config.xml里面的form一样，在这里面第一个字母大写哦。

    2）运行测试：打开IE，键入：http://localhost：8080/Struts1_Login/login.jsp，直接点确定，如下图：

   

   

    简单吗？嘿嘿，两步就搞定了吧。