验证框架使用指南

    技术2022-05-11  85

    配置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.(你可以根据需要修改称中文)

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

           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 ================================== -->

    <plug-in className="org.apache.struts.validator.ValidatorPlugIn">

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

    </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" οnsubmit="return validateXXXX(this);">

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

    <html:javascript formName="mytestForm"/>

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

    2、            ValidatorFormvalidate方法

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

    public ActionErrors validate (ActionMapping mapping,HttpServletRequest request) {

    ActionErrors errors = new ActionErrors();

    。。。。。。

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

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

    }

    。。。。。。

    return errors;

    }

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

    2、创建你的ActionForm并让它继承org.apache.struts.validator.ValidatorForm类。创建你的Action实现,并和上面定义的ActionForm关联。这里需要注意的是,在定义此Action时一定将validate属性设置为true,并且在你定义的ActionForm中不要实现它的validate方法――这就意味着你将使用ValidatorFormvalidate方法,这样才能保证你的错误验证正常进行。配置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>

    注意:此处的arg0arg1就代表了ApplicationResources文件中使用“{}”括起来的参数。比如:

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

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

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

    定义了02两个参数,所以你就需要定义<arg0><arg2>两个参数。

                         <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里设置相应的项目,比如说mytextmytextarea什么的,执行的时候会动态生成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);

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

    }

    就可以实现特殊验证了。

     

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

    范例:

    Struts 验证器:验证两个字段匹配

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

    怎样添加两个字段的验证器

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

     

    public static boolean validateTwoFields(

    Object bean,

    ValidatorAction va,                                       

    Field field,

    ActionErrors errors,

    HttpServletRequest request) {

     

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

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

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

     

        if (!GenericValidator.isBlankOrNull(value)) {

            try {

                if (!value.equals(value2)) {

                    errors.add(field.getKey(),

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

     

                    return false;

                }

            } catch (Exception e) {

                errors.add(field.getKey(),

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

     

                return false;

            }

        }

     

        return true;

    }

    Step 2: 编辑 validator-rules.xml ,加入"twofields" 规则。

    <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为你的表单配置验证:

    <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方法

    /**

     * 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;

    }

     

    最新回复(0)