`

Struts Validator验证器使用指南(二)

阅读更多

一个简明的Struts验证器API指南 可以帮助你开始。

验证器资源

Struts Validator: Validating Two Fields Match作者Matt Raible。(两个字段匹配验证)关于使用方法的文章。(范例部分为翻译此文内容)

DynaForms and the Validator作者James Turner and Kevin Bedell。Struts Kickstart的其中一章(动态form和验证器),可以自由下载PDF).

Validating user input作者 David Winterfeldt and Ted Husted。Struts in Action的其中一章,可以自由下载(PDF)。


 

使用方法

作者:

丑陋 && Snowtears:经过2周的不懈努力,阅读了大量的资料,终于对Validator有了个初步的认识,整理了一下,浅浅的谈了谈写法,希望能有一定的帮助,其中肯定有许多说的不对不准确的地方,还请多指教 real_herozx@163.net<o:p></o:p>

       王艺:

       根据以上两位的文章正理而成

配置ruts-config.xml

1、            添加ApplicationResources配置文件。

如:

<!-- ========== Message Resources Definitions =========================== -->

<message-resources parameter="com.dc.sibss.om.struts.ApplicationResources" />

其中com.sibss.om.struts.ApplicationResources"的部分是资源文件的路径,此文件的作用是提供错误信息的非编程定制化和多语言支持。如果我们使用中文平台操作系统,则默认情况下将首先查找ApplicationResource_zh_CN.properties文件,然后是ApplicationResources_zh.properties,如果前两个文件没有被找到则将查找ApplicationResources.properties文件。

为了能够在页面上显示错误提示信息,我们还需要将以下内容添加到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 an 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.

以上仅是struts现在支持的错误类型的错误提示信息,如果你自定义了新类型的错误验证,则还需要在此加上你自己的内容。

以上内容中的{0}指的是错误提交的参数。比如:当你需要页面上的“用户名”不能为空时(也就是上面的errors.required),这个{0}就代表“用户名”,所以如果你没有填写用户名将抛出如下错误:

       用户名 is required.(你可以根据需要修改称中文)<o:p></o:p>

我们可能已经注意到了,既然错误提示信息需要配置,那么上例中“用户名”系统是如何得到的呢?没错!也是通过修改此配置文件,内容如下:

       visitCust.error.name.required=<br>用户名

这样当“用户名”为空时,struts后台程序将联合以上两处定义显示错误信息。

另外,上面的“visitCust.error.name.required”是在Validation.xml配置验证内容时指定的。具体见以下介绍

注意:一般情况下,你的系统只需要一个ApplicationResources文件,所以开发组的成员不要添加自己的resource文件。只有在你的项目分组开发时才需要使用多个ApplicationResources文件,但是,同时你的struts-config.xml文件也会有相同的数量对应。

2、            在struts-config.xml文件中加入validator插件:

加入这个插件后你的应用就具备使用Validator的环境,如:

<!-- ========== Plug Ins Configuration ================================== --><o:p></o:p>

<plug-in className="org.apache.struts.validator.ValidatorPlugIn"><o:p></o:p>

<set-property value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" property="pathnames" /><o:p></o:p>

</plug-in>

这里如果是想使用多个***.xml文件的话,value部分写法如下value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml, /WEB-INF/validation1.xml , /WEB-INF/validation2.xml "

在<action-mappings>里,定义需要验证的画面对应的Action的时候要加上validate="true"

四种使用方法

1、            用Javascript在客户端进行验证

配置:在需要验证的JSP文件中写入

<html:form action="/XXX" onsubmit="return validateXXXX(this);"><o:p></o:p>

这里的XXX 是与要进行验证的 forward name,validateXXXX (this);里面的XXXX是需要进行验证的ActionForm名。

<html:javascript formName="mytestForm"/><o:p></o:p>

在validation.xml文件中写入验证代码就可以进行基本的验证了。这种方法是在客户端进行验证,客户端可以看到JAVASCRIPT部分的全代码。安全性不高

2、            ValidatorForm的validate方法

1、validate()方法:使自己的ActionForm继承ValidatorForm类,在里面编写自己的方法:

public ActionErrors validate (ActionMapping mapping,HttpServletRequest request) {

ActionErrors errors = new ActionErrors();<o:p></o:p>

。。。。。。

if ( mytext.equals("aaa") ) {

//my exampleerrors.add("mytext",new ActionError("mytext.error"));

}

。。。。。。

return errors;<o:p></o:p>

}

此时,如果写了这个方法,就会屏蔽掉在Validation.xml中定义的验证部分,换句话说就是系统运行时,Validation.xml里对应此ActionForm的定义的错误验证部分不实行,如果不写这个方法的话,系统运行时会进行Validation.xml里对应此ActionForm的定义的错误验证部分的操作。此类方法是在服务器端进行验证,验证部分代码客户端不可见。

2、创建你的ActionForm并让它继承org.apache.struts.validator.ValidatorForm类。创建你的Action实现,并和上面定义的ActionForm关联。这里需要注意的是,在定义此Action时一定将validate属性设置为true,并且在你定义的ActionForm中不要实现它的validate方法――这就意味着你将使用ValidatorForm的validate方法,这样才能保证你的错误验证正常进行。配置validation.xml文件。基本内容如下:

<form-validation>

<!-- ========== Default Language Form Definitions ===================== -->

    <formset>

              <form name="custGNewForm">需要验证页面上form的名字

                     <field property="certifiCode"需要校验的属性

                                   depends="required,maxlength">校验内容

                            <arg0 key="prompt.certifiCode"/>ApplicationResource文件中对应

                            <arg1 key="${var:maxlength}" name="maxlength" resouce="false"/>

                            <var>确定最长限制的长度

                                   <var-name>maxlength</var-name>

                                   <var-value>20</var-value>

                            </var>

                     </field>

注意:此处的arg0和arg1就代表了ApplicationResources文件中使用“{}”括起来的参数。比如:<o:p></o:p>

errors.range={0} is not in the range {1} through {2}.<o:p></o:p>

定义了三个参数,所以你这里也要定义<arg0>、<arg1>、<arg2>三个参数才能完整的显示错误信息。<o:p></o:p>

errors.maxlength={0} cannot be greater than {2} characters.<o:p></o:p>

定义了0、2两个参数,所以你就需要定义<arg0>和<arg2>两个参数。<o:p></o:p>

                     <field        property="userName"

                                   depends="required,maxlength">

                            <arg0 key="prompt.userName"/>

                            <arg2 key="${var:maxlength}" name="maxlength" resouce="false"/>

                            <var>

                                   <var-name>maxlength</var-name>

                                   <var-value>80</var-value>

                            </var>

                     </field>

                     <field property="email"

                    depends="email">

                <arg0 key="prompt.email"/>

            </field>

              </form>

              <form name="custGNewCheckForm">

                     <field       property="certifiCode"

                                   depends="required">

                            <arg0 key="prompt.certifiCode"/>

                     </field>

              </form>

    </formset>

</form-validation>

在校验页面的<body>前添加如下内容:<html:errors/>

3、            DynaValidatorForm

不需要再写对应的ActionForm,只需在struts-config.xml里把自己的ActionForm进行配置:

<form-bean name="testForm" type="org.apache.struts.validator. DynaValidatorForm">

       <form-property name="mytext" type="java.lang.String"/>

<form-property name="mytextarea" type="java.lang.String"/>

       <form-property name="mydatetext" type="java.lang.String"/>

</form-bean>

在form-property里设置相应的项目,比如说mytext,mytextarea什么的,执行的时候会动态生成ActionForm,再在validation.xml里写入所希望的验证代码,就可以了。JSP文件里不需要写入任何东西,验证也是在服务器端进行,验证部分代码在JSP中不可见。

4、            组合验证

如果使用动态验证DynaValidatorForm的话,不许编写自己的对应的ActionForm,相应的特殊验证会受到相当程度的限制。这个时候,需要将特殊验证部分写入对应的Action,

if(mytext.equals("aaa")){//My Example

ActionErrors errors = new ActionErrors();

errors.add("***",new ActionError("***.error"));      

saveErrors(request,errors);<o:p></o:p>

return (mapping.findForward("false"));

}

就可以实现特殊验证了。

 <o:p></o:p>

       实际上你的FORM还可以继承ValidatorActionForm和DynaValidatorActionForm,这两种与他们对应的ValidatorForm和DynaValidatorForm的唯一区别正如开篇就讲到的:在struts-config.xml中查找对应的FORM类时,前者根据ACTION的PATH值,而后者使用NAME值。

范例:

Struts 验证器:验证两个字段匹配<o:p></o:p>

在使用指南中,有一节讲述怎样创建验证器来验证两个字段匹配,我用这个服务器端验证器(象例子中显示的那样)做口令,确定口令验证。这个已经可以正常工作了;但我还想用客户端的javascript验证器来试一试。我写了自己的程序来比较两个字段,但他们和推荐给你的那个不同(from validator-rules.xml)。所以昨天,我补充了怎样添加JavaScript方法到validator-rules.xml 这里就是怎样配置的的整个过程(大部分在使用指南中已经包含了,保存JavaScript)。<o:p></o:p>

怎样添加两个字段的验证器<o:p></o:p>

Step 1: 生成一个包含validateTwoFields方法的类。在我的代码重,我的类定义为ValidationUtil,他有下列方法:

 <o:p></o:p>

public static boolean validateTwoFields(

Object bean,

ValidatorAction va,                                       

Field field,

ActionErrors errors,

HttpServletRequest request) {

 <o:p></o:p>

    String value = ValidatorUtil.getValueAsString(bean, field.getProperty());

    String sProperty2 = field.getVarValue("secondProperty");

String value2 = ValidatorUtil.getValueAsString(bean, sProperty2);

 <o:p></o:p>

    if (!GenericValidator.isBlankOrNull(value)) {

        try {

            if (!value.equals(value2)) {

                errors.add(field.getKey(),

                           Resources.getActionError(request, va, field));

 <o:p></o:p>

                return false;

            }

        } catch (Exception e) {

            errors.add(field.getKey(),

                       Resources.getActionError(request, va, field));

 <o:p></o:p>

            return false;

        }

    }

 <o:p></o:p>

    return true;

}

Step 2: 编辑 validator-rules.xml ,加入"twofields" 规则。<o:p></o:p>

<validator name="twofields" classname="org.appfuse.webapp.util.ValidationUtil"

method="validateTwoFields"

    methodParams="java.lang.Object,

                  org.apache.commons.validator.ValidatorAction,

                  org.apache.commons.validator.Field,

                  org.apache.struts.action.ActionErrors,

                  javax.servlet.http.HttpServletRequest"

   depends="required" msg="errors.twofields">

    <javascript><![CDATA[

        function validateTwoFields(form) {

            var bValid = true;

            var focusField = null;

            var i = 0;

            var fields = new Array();

            oTwoFields = new twofields();

            for (x in oTwoFields) {

                var field = form[oTwoFields[x][0]];

                var secondField = form[oTwoFields[x][2]("secondProperty")];

           

                if (field.type == ′text′ ||

                    field.type == ′textarea′ ||

                    field.type == ′select-one′ ||

                    field.type == ′radio′ ||

                    field.type == ′password′) {

           

                    var value;

                    var secondValue;

                    // get field′s value

                    if (field.type == "select-one") {

                        var si = field.selectedIndex;

                        value = field.options[si].value;

                        secondValue = secondField.options[si].value;

                    } else {

                        value = field.value;

                        secondValue = secondField.value;

                    }

               

                    if (value != secondValue) {

                   

                        if (i == 0) {

                            focusField = field;

                        }

                        fields[i++] = oTwoFields[x][1];

                        bValid = false;

                    }

                }

            }

           

            if (fields.length > 0) {

                focusField.focus();

                alert(fields.join(′\n′));

            }

           

            return bValid;

        }]]></javascript>

</validator>

Step 3:validation.xml为你的表单配置验证:<o:p></o:p>

<field property="password" depends="required,twofields">

  <msg name="required" key="errors.required"/>

  <msg name="twofields" key="errors.twofields"/>

  <arg0 key="userForm.password"/>

  <arg1 key="userForm.confirmPassword"/>

  <var>

    <var-name>secondProperty</var-name>

    <var-value>confirmPassword</var-value>

  </var>

</field>

这里errors.twofields字段 ′{0}′必须与字段′{1}′ 的值相同。第三步的一个可选的工作就时使用 XDoclet 来生成validation.xmlrequires (1) 配置XDoclet (当然)和(2) 在你的表单中添加添加一些@struts 标签setPassword方法<o:p></o:p>

/**

 * Returns the password.

 * @return String

 *

 * @struts.validator type="required" msgkey="errors.required"

 * @struts.validator type="twofields" msgkey="errors.twofields"

 * @struts.validator-args arg1resource="userForm.password"

 * @struts.validator-args arg1resource="userForm.confirmPassword"

 * @struts.validator-var name="secondProperty" value="confirmPassword"

 */

public String setPassword() {

       return password;

}

我昨天已经把这个作为建议发送给struts-dev邮件列表, 但还没有收到任何消息。

来源:http://www.java-asp.net/java/200511/t_44525.html

分享到:
评论

相关推荐

    Struts Validator验证器使用指南

    ### Struts Validator 验证器使用指南 #### 一、Struts Validator 概览 **Struts Validator** 是一个强大的框架,用于简化Web应用程序中的表单验证过程。它首次出现在Struts 0.5版本中,并逐渐发展成为Struts 1.1...

    Struts Validator验证器使用指南.doc

    Struts Validator是一个强大的工具,用于在Struts框架中执行客户端和服务器端的数据验证。这个验证器自Struts 1.1版本开始成为其核心组成部分,极大地增强了应用的健壮性和用户体验。以下是对Struts Validator使用的...

    Struts Validator 开发指南

    通过配置 `struts-config.xml` 和 `validation.xml` 文件,以及利用 `Validator-rules.xml` 中的预定义验证器,开发者可以确保用户提交的数据符合预期格式和规则,从而降低程序出错的可能性并提高应用的质量。

    struts中 validator验证实例和文档

    Validator验证在Struts应用程序中扮演着至关重要的角色,它能够确保用户输入的数据符合预设的规则,从而提高应用的健壮性和用户体验。在这个实例和文档中,我们将深入探讨Struts Validator的工作原理、配置以及如何...

    Struts2-plus.rar_plus_struts2 plus_struts2 validator _strutsplus

    另一个文件"Struts2QuickValidation.pdf"很可能是一个用户指南或文档,详细介绍了如何使用Struts2 Plus进行数据验证,包括如何配置插件、定义验证规则、处理验证错误以及如何在视图层展示验证结果等。这个文档对于...

    struts2权威指南光盘源码-第18章源码

    - **`struts2struts1validator`** 模块:这部分源码可能展示了如何在Struts2中使用Struts1的Validator框架进行数据验证。Struts2提供了内置的验证框架,但也可以与Struts1的Validator规则文件和验证类集成,以利用...

    struts-tiles和validator-strut2教程pdf

    同时,Struts 2内置了验证框架,类似于Struts 1的Validator,但更加强大和易于使用。开发者可以通过注解或XML配置文件定义验证规则,并能轻松地处理错误信息。 **validator-strut2-11.pdf**: 这份文档很可能是关于...

    struts快速学习指南 pdf电子书

    本快速学习指南将帮助初学者深入理解Struts框架的核心概念、架构和使用方法,从而快速上手开发Java Web应用。 首先,我们来了解Struts的基本架构。Struts通过分离业务逻辑、视图展示和控制流程,实现了应用的模块化...

    commons-validator-1.3.1.zip

    3. **文档**:可能包含`docs`目录,其中包含API文档、用户指南和开发者文档,帮助用户快速上手并了解如何使用验证器。 4. **配置文件**:如`conf`目录下的`validation.xml`,这是Validator的核心配置文件,用于定义...

    Struts验证的五种方案

    Struts2支持许多第三方验证框架,如Hibernate Validator和Apache Commons Validator。这些框架提供了丰富的验证注解和API,可以方便地在Action类或模型对象上定义验证规则。这种方式提高了验证的灵活性和扩展性,...

    Struts快速学习指南

    Struts的Validator框架允许开发者定义表单验证规则,自动检查用户输入的有效性,减少业务逻辑中的错误。 七、Struts 2的发展 随着技术的发展,Struts 1逐渐被Struts 2所取代。Struts 2融合了更多框架的优点,如...

    struts2权威指南光盘源码-第18-21章源码

    3. **Struts2验证框架** (18.4\struts2struts1validator) 验证是确保用户输入有效性和安全性的关键部分。这里你将了解到Struts2的验证框架,包括自定义验证逻辑、配置文件中的验证规则、以及如何在Action中应用验证...

    struts2权威指南

    - Struts2的拦截器是其核心特性之一,它们按照预定义的顺序在Action调用前后执行,用于实现通用的功能,如日志记录、权限验证、数据转换等。 - 拦截器链可以自定义,通过配置文件或编程方式添加或删除拦截器。 3....

    struts快速学习指南

    - 集成了各种验证框架,如Commons Validator,方便表单验证。 - 可扩展性强,可通过插件扩展功能。 **5. Struts的局限性与升级** 尽管Struts1在早期Web开发中广泛使用,但随着时间的推移,其性能和安全问题逐渐暴露...

    struts2.1权威指南(2)

    5. **模型绑定与数据校验**:探讨了Struts2中的模型驱动和数据校验机制,包括使用OGNL表达式进行属性绑定,以及利用Validator插件进行表单验证。 6. **国际化与本地化**:阐述了如何在Struts2中实现多语言支持,...

    Struts2 权威指南 (代码)

    同时,Struts2的Validator框架允许开发者定义表单验证规则,确保输入数据的有效性。 9. **Ajax支持**:通过Struts2的AJAX插件,可以轻松实现部分页面的异步更新,提升用户体验。 10. **插件架构**:Struts2拥有...

Global site tag (gtag.js) - Google Analytics