Struts2输入校验

1、编写校验规则文件

（<ActionName>-validation.xml），文件放在Action类文件相同的路径下校验失败返回input的result。

 

---

 

  <validators>

    <!-- 校验Action的name属性 -->

    <field name="name">

        <!-- 指定name属性必须满足必填规则 -->

        <field-validator type="requiredstring">

            <param name="trim">true</param>

            <message key="name.requried"/>     <!--国际化信息（国际化资源文件中有name.requried=必须输入用户名）-->

        </field-validator>

        <!-- 指定name属性必须匹配正则表达式 -->

        <field-validator type="regex">

            <param name="regex"><![CDATA[(\w{4,25})]]></param>

            <message key="name.regex"/>

        </field-validator>

    </field>

  <!-- 指定age属性必须在指定范围内-->

    <field name="age">

        <field-validator type="int">

            <param name="min">1</param>

            <param name="max">150</param>

            <message key="age.range"/>

        </field-validator>

    </field>

    <!-- 指定birth属性必须在指定范围内-->

    <field name="birth">

        <field-validator type="date">

            <!-- 下面指定日期字符串时，必须使用本Locale的日期格式 -->

            <param name="min">1900-01-01</param>

            <param name="max">2050-02-21</param>

            <message key="birth.range"/>

        </field-validator>

    </field>

</validators>            

---

2、使用客户端校验

    1）将输入页面表单元素改为使用Struts2标签来生成表单。

    2）为该<s:form../>元素增加validate=“true”属性。

        <s:fielderror/>

                <s:form action="regist" validate="true">

                <s:textfield name="name" label="用户名"/>

                <s:textfield name="pass" label="密码"/>

                <s:textfield name="age" label="年龄"/>

                <s:textfield name="birth" label="生日"/>

                <s:submit value="注册"/>

        </s:form>

 

     客户端校验仍然是基于JavaScript的，因为JS本身的限制，有些服务器端校验不能转换成客户端校验。

        客户端校验仅支持下面几种：    

                required validator必填校验器

                requiredstring validator必填字符串校验器

                stringlength validator字符串长度校验器

                regex validator表达式校验器

                email validator邮件校验器

                url validator网址校验器

                int validator整数校验器

                double validator双精度

    

          客户端校验需要注意：

                    不要将<s:form../>元素的theme属性指定为simple

                    浏览器直接访问启用客户端校验的表单页会引发异常，可把这些表单放WEB-INF下，通过核心Filter后再访问

                    如果客户端校验需要输出国际化提示信息，则需要使用全局国际化资源文件，不能使用Action范围的文件

                    启用客户端校验的表单页面的action和namespace要分开写（<s:form action="regist"                                                                                                                             namespace="/wj"> not <s:form action="wj/regist">）

 

3、校验器配置风格

        字段校验器风格

              参考1里面的校验文件      

        非字段校验器风格

            <!-- 配置指定必填字符串的校验器 -->

          <validator type="requiredstring">

            <!-- 使用该校验器校验name属性 -->

            <param name="fieldName">name</param>

            <param name="trim">true</param>

            <!-- 指定校验失败后输出name.required对应的国际化信息 -->

            <message key="name.requried"/>

        </validator>

        <!-- 配置指定正则表达式的校验器 -->

        <validator type="regex">

            <!-- 使用该校验器校验name属性 -->

            <param name="fieldName">name</param>

            <param name="trim">true</param>

            <param name="regex"><![CDATA[(\w{4,25})]]></param>

            <!-- 指定校验失败后输出name.required对应的国际化信息 -->

            <message key="name.regex"/>

        </validator>

 

4、短路校验器

            <field-validator type="requiredstring" short-circuit="true">

        

5、校验文件搜索规则

            遇到下列情况时:

          <action name="*Pro" class="org.crazyit.app.action.RegistAction"

            method="{1}">

            解决方案：

            为校验规则文件添加Action别名来指定需要校验的处理逻辑：

            <ActionClassName>-<ActionAliasName>-validation.xml

               

             假设系统有两个Action:BaseAction和RegistAction,RegistAction继承了BaseAction，系统搜索文件顺序如下：

                1）BaseAction-validation.xml

                2）BaseAction-别名-validation.xml

                3）RegistAction-Validation.xml

                4）RegistAction-别名-validation.xml

                搜索到第一个校验文件后，还会继续搜索。

                搜索从上到下，实际规则是所有规则总和，有冲突时，以后面规则为准。

 

6、校验顺序和短路

            校验器执行顺序有如下原则：

                    先非字段风格校验器，再字段；排在前面的先执行。

            校验器短路原则：

                    所有非字段校验器优先，某个非字段校验器失败，对应字段的字段校验器不再校验，其他非字段校验器仍要执行，字段校验器失败后的其他字段校验器不会执行。

            

7、内建校验器

               Struts2包下xwork-2.3.16.3.jar中com\opensymphony\xwork2\validator\validators 下的default.xml文件。

  

---

 

                  

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE validators PUBLIC

        "-//Apache Struts//XWork Validator Definition 1.0//EN"

        "http://struts.apache.org/dtds/xwork-validator-definition-1.0.dtd">

 

<!-- START SNIPPET: validators-default -->

<validators>

    <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>

    <validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>

    <validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>

    <validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>

    <validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>

    <validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>

    <validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>

    <validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>

    <validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>

    <validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>

    <validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>

    <validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>

    <validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>

    <validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>

    <validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>

    <validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/>

</validators>

<!--  END SNIPPET: validators-default -->

---

8、基于注解的输入校验

        可以简化开发，但是会给维护带来一定的困难

    

    // 使用注解指定必填、正则表达式两个校验规则

    @RequiredStringValidator(key = "name.requried"

        , message = "")

    @RegexFieldValidator(regex = "\\w{4,25}"

        ,key = "name.regex" , message = "")

    public void setName(String name)

    {

        this.name = name;

    }

    // age的setter和getter方法

    @IntRangeFieldValidator(message = ""

        , key = "age.range", min = "1"

        , max = "150")

    public void setAge(int age)

    {

        this.age = age;

    }

 

    // birth的setter和getter方法

    @DateRangeFieldValidator(message = ""

        , key = "birth.range", min = "1900/01/01"

        , max = "2050/01/21")

    public void setBirth(Date birth)

    {

        this.birth = birth;

    }

 

 

9、手动完成输入校验

        1）重写validate()方法

        2）重写validateXxx方法

 

10、Struts2输入校验步骤

        1）类型转换器对字符串的请求参数执行类型转换，并将这些值设置为Action属性值。

        2）类型转换过程中如果出现异常，将异常信息保存到ActionContext中，conventionError拦截器负责将其封装到FieldError里。

        3）使用Struts2中配置的校验器进行输入校验。

        4）通过反射调用validateXxx()方法。

        5）调用validate()方法。

        6）若没有出现FieldError时调用Action里的处理方法，出现了则转入input逻辑视图所指定的视图资源。