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

教程Tag：暂无Tag,欢迎添加,赚取U币!

推荐：Struts初级教程(4)-对国际化的支持
随着全球经济的在体化趋势，网页设计开发者应该开发出支持多国语言、国家化的web应用程序。就是一个web应用程序在运行时能够根据客户端请求所来自的国家和语言的不同显示不同的用户界面。这样当需要在应用程序中添加对一种新的语言的支持时，不需要对已有的软

     应该清楚在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，直接点确定，如下图：

分享：Struts初级教程(3)-结合数据库应用
这一节我们开始用 Struts 结合数据库设计程序，主要将上一节的程序略做修改，如下所示：效果图：显示结果如下图：如果您输入的是不合法的话，则如下图：程序修改步骤： A、数据源配置在struts-config.xml文件中有一data-sources元素是用来配置应用所需要