Struts 2 之校验器

对于输入校验，Struts2提供了两种方式，1、使用validate方法；2、基于XML配置实现 。

validate()方法

支持校验的Action必须实现Validateable接口，一般直接继承ActionSupport就可以了

   public void validate() {  //会对所有的Action起作用
        if(username == null ||"".equals(this.username.trim())){
            this.addFieldError("username", "用户名不能为空");
        }
        if(mobile == null ||"".equals(this.mobile.trim())){
           this.addFieldError("mobile", "手机号不能为空");
        }else{
                                    if(!Pattern.compile("^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){
                this.addFieldError("mobile","手机号格式不正确") ;
            }
        }
       super.validate();
    } 

   public void validateUpdate(){ //假设此Action有个名为update()的方法
        //只对update()方法进行校验validateXxx,方法名第一个必须大写
        if(username == null ||"".equals(this.username.trim())){
           this.addFieldError("username", "用户名不能为空");
        }
        if(mobile == null ||"".equals(this.mobile.trim())){
           this.addFieldError("mobile", "手机号不能为空");
        }else{
           if(!Pattern.compile("^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){
               this.addFieldError("mobile", "手机号格式不正确");
            }
        }
        super.validate() ;
    }

对这些错误信息，在JSP页面可以使用标签<s:fielderror/>来显示

基于XML的校验方式

基于XML方式实现校验时，Action类也需要继承ActionSupport类，并且提供校验文件，校验文件同Action类放在一个包内，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为Action类的简单名字

<! DOCTYPE validators PUBLIC
        "-//OpenSymphony Group//XWorkValidator 1.0.3//EN"
        "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">    

<validators>
    <field name="username">
        <field-validator type="requiredstring">
            <param name="trim">true</param>
            <message>用户名不能为空</message>
        </field-validator>
    </field>
    <field name="mobile">
        <field-validator type="requiredstring">
            <param name="trim">true</param>
            <message>手机号不能为空</message>
        </field-validator>    

        <field-validator type="regex">
            <param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
            <message>手机号格式不正确</message>
        </field-validator>
    </field>
</validators> 

Struts 2常用内置校验器

位于xwork-2.0.4.jar压缩包中（com.opensymphony.xwork2.validator.validators）有个文件default.xml ，该文件中定义了Struts2框架内建的校验器。default.xml文件定义了常用的校验器类型。

1、类型转换检验器：

（1）非字段校验：

 <validator type="conversion">
        <param name="fieldName">myField</param>
        <message>类型转换错误</message>
        <param name="repopulateField">true</param>
  </validator>

（2）字段校验：

<field name="myField">
        <field-validator type="conversion">
            <message>类型转换错误</message>
            <param name="repopulateField">true</param>
        </field-validator>
</field>

fieldName：该参数指定检查是否存在转换异常的字段名称，如果是字段校验，则不用指定该参数。

repopulateField：该参数指定当类型转换失败后，返回input页面时，类型转换失败的表单是否保留原来的错误输入。true为保留，false为不保留。

2、日期校验器：

（1）非字段校验：

  <validator type="date">
        <param name="fieldName">birthday</param>
        <param name="min">1990-01-02</param>
        <param name="max">2010-07-28</param>
        <message>生日数据错误</message>
  </validator>

（2）字段校验：

 <field name="birthday">
        <field-validator type="date">
            <param name="min">1990-01-01</param>
            <param name="max">2010-07-28</param>
            <message key="error.birthday"></message>
        </field-validator>
  </field>

min：指定字段日期值的最小值，该参数为可选参数。

max：指定字段日期值的最大值，该参数为可选参数。

3、浮点数值校验器：

（1）非字段校验：

<validator type="double">
        <param name="fieldName">percentage</param>
        <param name="minInclusive">20.1</param>
        <param name="maxInclusive">50.1</param>
        <message>生日数据错误</message>
</validator>

（2）字段校验：

<field name="percentage">
        <field-validator type="double">
            <param name="minInclusive">20.1</param>
            <param name="maxInclusive">50.1</param>
            <message key="error.percentage"></message>
       </field-validator>
 </field>

minInclusive|minExclusive：指定字段的最小值，包含该值|不包含该值。

maxInclusive|maxExclusive：指定字段的最大值， 包含该值|不包含该值。

4、邮件地址校验器：

（1）非字段校验：

  <validator type="email">
        <param name="fieldName">MyEmail</param>
        <message>非法的邮件地址</message>
   </validator>

（2）字段校验：

 <field name="MyEmail">
        <field-validator type="email">
           <message>非法的邮件地址</message>
        </field-validator>
  </field>

5、表达式校验器：

 <validator type="expression">
        <param name="expression">.......</param>
        <message>Failed to meet OgnlExpression...</message>
 </validator>

expression：该参数为一个逻辑表达式，该参数使用OGNL表达式，并基于值栈计算，返回一个Boolean类型值。

6、字段表达式校验器：

（1）非字段校验：

  <validator type="fieldexpression">
        <param name="fieldName">myField</param>
        <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
        <message>My credit limit shouldbe MORE than my girlfriend</message>
    </validator>

（2）字段校验：

<field name="myField">
        <field-validator type="fieldexpression">
            <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
            <message>My credit limitshould be MORE than my girlfriend</message>
        </field-validator>
</field>

7、整数校验器：

（1）非字段校验：

<validator type="int">
        <param name="fieldName">age</param>
        <param name="min">10</param>
        <param name="max">100</param>
        <message>年龄必须在在${min}到${max}之间</message>
</validator>

（2）字段校验：

  <field name="age">
        <field-validator type="int">
            <param name="min">10</param>
            <param name="max">100</param>
            <message>年龄必须在在${min}到${max}之间</message>
        </field-validator>
   </field><span style="font-family: Arial, Helvetica, sans-serif; background-color: rgb(255, 255, 255);"> </span>

8、正则表达式校验器：

（1）非字段校验：

 <validator type="regex">
        <param name="fieldName">myStrangePostcode</param>
        <param name="expression"><![CDATA[([aAbBcCdD][123][eEfFgG][456])]></param>
 </validator>

（2）字段校验：

 <field name="myStrangePostcode">
        <field-validator type="regex">
            <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
            <message>My credit limitshould be MORE than my girlfriend</message>
        </field-validator>
  </field>

expression：为必选参数，指定匹配有的表达式。

caseSensitive：指明进行匹配时，是否区分大小写，为可选参数，默认为true。

9、必填校验器：

（1）非字段校验：

<validator type="required">
        <param name="fieldName">username</param>
        <message>用户名不能为空</message>
</validator>

（2）字段校验：

 <field name="username">
        <field-validator type="required">
            <message>用户名不能为空</message>
        </field-validator>
  </field>

10、必填字符串校验器：

（1）非字段校验：

<validator type="requiredstring">
        <param name="fieldName">username</param>
        <param name="trim">true</param>
        <message>用户名不能为空</message>
</validator>

（2）字段校验：

<field name="username">
        <field-validator type="requiredstring">
            <param name="trim">true</param>
            <message>用户名不能为空</message>
        </field-validator>
 </field>

trim：可选参数，用于指定是否在校验之前对字符串进行整理，默许为true。

11、字符串长度校验器：

（1）非字段校验：

 <validator type="stringlength">
        <param name="fieldName">username</param>
        <param name="minLength">4</param>
        <param name="maxLength">10</param>
        <message>用户名长度在${minLength}到${maxLength}之间</message>
    </validator>

（2）字段校验：

 <field name="username">
        <field-validator type="stringlength">
            <param name="minLength">4</param>
            <param name="maxLength">10</param>
            <param name="trim">true</param>
            <message key="error.length.username"></message>
        </field-validator>
    </field>

12、网址校验器：

（1）非字段校验：

<validator type="url">
        <param name="fieldName">myHomePage</param>
        <message>Invalid homepageurl</message>
</validator>

（2）字段校验：

 <field name="myHomePage">
        <field-validator type="url">
            <message>Invalid homepageurl</message>
        </field-validator>
 </field>

13、visitor校验器：

该校验器名称为：visitor，用来校验Action中定义的复合类型属性，支持简单的复合类型、数组类型、Map等集合类型。

（1）非字段校验：

<validator type="visitor">
        <param name="fieldName">user</param>
        <param name="context">myContext</param>
        <param name="appendPrefix">true</param>
    </validator>

（2）字段校验：

<field name="user">
        <field-validator type="visitor">
            <param name="context">myContext</param>
            <param name="appendPrefix">true</param>
        </field-validator>
</field>

如果想自定义一个自己的校验器，可以在Web工程的WEB-LIB\lib目录下增加一个validators.xml配置文件，在该文件中定义自己的校验器。

注意：如果使用validators.xml配置文件，则系统默认的default.xml配置文件不会加载，所以需要将default.xml的内容复制到validators.xml配置文件中。否则不能使用系统内建的校验器。