Struts初级教程(5)-表单验证

2024-09-05 00:17:22

字体：大中小

来源：转载

供稿：网友

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

     Ø   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里面<action>元素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文件
<action
    path="/login"
    name="loginActionForm"
    scope="request"
    type="actions.LoginAction"
    validate="true"
    input="/login.jsp">
        <forward name="success" path="/success.jsp" />
        <forward name="error" path="/wrong.jsp" />
</action>
在<action>元素中，name和scope属性分别指定ActionForm的名字和它的范围，valudate属性指定是否执行表单验证，而input属性表示验证失败，所要显示用户的内容。
     4、修改login.jsp，在<body>元素添加，目的是显示错误信息，具体代码片段如下：
<div>
    <font color="red">
        <html:messages id="error">
            <li><bean:write name="error"/></li>
         </html:messages>
    </font>
</div>
<html:message/> ：用于输出消息。属性介绍如下：
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对象，它和<bean:write>标签的name属性匹配。
<bean:write/>：表示显示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)验证规则：
<validator name="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文件中的哪个验证规则进行验证。
一个自定义的验证规则如下：
<form-validation>
    <formset>
        <form name="loginActionForm">
            <field property="username" depends="required">
                <arg key="label.username" />
            </field>
            <field property="userpass" depends="required">
                <arg key="label.password" />
            </field>
        </form>
    </formset>
</form-validation>
Validator.xml文件的根元素为<form-validation>元素，它包含两个子元素：<global>和<formset>元素。
1) <global>元素可以定义<constant>子元素，它用来定义常量表达式。
2)  <formset>元素包含两个子元素：<contant>和<form>。
3) <form>元素用于为表单配置验证规则，它的name属性表示你验证formBean，必须和struts-config.xml里面FormBean名字保持一致。<form>元素可以包含一个或多个<field>子元素。
4) <field>元素是针对表单中字段的验证规则。Property属性用于指定FormBean中需要验证的字段的名称，depends属性用于指定字段的验证规则，多个用逗号分隔。
5) <arg>元素表示出错时的主体信息，key 是你属性文件里面的key。
6) 主要是对前面<depends>元素包含的验证规则的定义。
3、插入Validator
       每一个Struts应用需要知道是否使用了Validator框架，可以通过PlugIn(插件)机制将Validator框架配置到Struts应用中。
下面的代码演示了如何将Validator 作为一个插件加入到Struts 应用中，在Struts 应用的配置文件Struts-config.xml 中加入如下代码片段：
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
    <set-property property="pathnames"
                  value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>
</plug-in>
pathnames属性的值用来指定Validator 框架所使用的配置文件，多个配置文件之间用逗号分隔。当应用启动的时候，Struts框架将调用ValidatorPlugIn的init()方法。Validator框架的配置文件将会加载到内存中供应用使用。在init()方法被调用之前，pathnames所指定的值将会传递给ValidatorPlugIn的实例，ValidatorPlugIn实例将会依据这个值去加载配置文件。
案例说明：根据前面的例子我们进行进阶，要求用户输入用户名、密码。并且用户名、密码是必须，若为空，则提示错误信息。
A、服务器段验证
       1、修改FormBean
              我们以前的是继承ActionForm,现在改成ValidatorForm,导入相应的包，并删除validator和reset方法。
       2、修改struts-config.xml文件，具体代码如下：
<action
       path="/login"
       name="loginActionForm"
       scope="request"
       type="org.zhoudq.webapp.action.LoginAction"
       validate="true"
       input="/login.jsp">
              <forward name="success" path="/success.jsp" />
              <forward name="error" path="/wrong.jsp" />
</action>
      将validator改为true，告诉服务器对这个表单进行验证，input的值，是告诉服务器如果严整失败的话，将跳转的页面。
3、添加验证规则
在WEB-INF下创建validaton.xml这个文件，导入引用的dtd，添加如下内容：
<form-validation>
    <formset>
        <form name="loginActionForm">
            <field property="username" depends="required">
                <arg key="label.username" />
            </field>
            <field property="userpass" depends="required">
                <arg key="label.password" />
            </field>
        </form>
    </formset>
</form-validation>
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
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
    <set-property property="pathnames"
                  value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>
</plug-in>
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" onsubmit="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>
     <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" onsubmit="return validateLoginActionForm(this);">
当用户提交表单的时候，就会调用<html:javascript>标签生成的javascript脚本的方法，从而执行客户端的验证，其中的LoginActionForm是你FormBean的名字对用，必须和struts-config.xml里面的form一样，在这里面第一个字母大写哦。
2)运行测试：
打开IE,键入：http://localhost:8080/Struts1_Login/login.jsp，直接点确定，如下图：