原生校验器

我们都知道Struts2校验框架原生（自带）有不少校验规则 。

有时候我们会频繁使用到某些后台参数校验逻辑，如果始终使用正则表达式，在书写校验文件的时候比较冗长。

这时候我们可以针对自身需求定制一个专门的校验器。

常见原生校验

• required:必填校验器
• requiredstring:必填字符串校验器
• int:整数校验器
• double:双精度浮点数校验器
• date:日期校验器
• email:电子邮件校验器
• url:网址校验器
• stringlength:字符串长度校验器
• regex:正则表达式校验器

校验配置文件

校验配置文件放在Action目录下，命名：Action名-方法名-validation.xml

例如：RunningManAction-createRuningMan-validation.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC "-//Apache Struts//XWork Validator 1.0.3//EN" 
   "http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
   <validators>
       <!-- 本样例主要说明各类元素标签，实际应用可能仅使用部分标签 -->
       <!-- 校验参数名 -->
       <field name="runningMan.userName">
       <!-- 指定校验器，此处指定了自定义的校验器customer -->
       <field-validator type="customer">
           <!-- 入参，主要分两类，值/正则 -->
           <!-- 入参需要合法不要出现收参转换失败的情况，如给整型传字母 -->
           <param name="exclusionChar">#'&,;"|</param>
           <!-- 正则入参需要注意语法，比如限制输入数字字母 -->
           <param name="regex"><![CDATA[^[A-Za-z0-9]$]]> </param>
           <message>userName invalid format.</message>
       </field-validator>
       <field-validator type="required">
           <!-- 略...多个校验器 --> 
       </field-validator>
   </field>
</validators>

自定义校验器

上文中我们使用到了一个自定义的校验器customer。

这个校验器并不存在，需要定义这样一个校验器。

validators.xml一般放在工程根目录下WBE-INFO/class。

<?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">
    <validators>
        <!-- 指定自定义的校验类，如检查特殊符号校验类 -->
        <validator name="customer" class="com.mebugs.validation.CheckSpecialSymbol"/>
    </validators>

代码实例

CheckSpecialSymbol自定义校验器类代码实例。

package com.mebugs.validation;
import com.opensymphony.xwork2.validator.ValidationException;
import com.opensymphony.xwork2.validator.validators.FieldValidatorSupport;
public class CheckSpecialSymbol extends FieldValidatorSupport {
    //校验文件中的入参，限制哪些字符不可出现
    private String exclusionChar;
    @Override 
    public void validate(Object object) throws ValidationException {
        //校验参数名
        String fieldName = getFieldName();
        //参数名对应的参数值
        Object value = getFieldValue(fieldName, object);
        if ( value != null ) {
            if (!(value instanceof String)) {
                //不是字符串报错
                addFieldError(fieldName, object);
            } else {
                String s = (String)value;
                for (int i = 0;i < s.length(); i++) { 
                    //存在了此字符串，报错
                    if (exclusionChar.indexOf(s.charAt(i)) != -1) {
                        addFieldError(fieldName, object);
                    } 
                }
            }
        }
    }
    public String getExclusionChar() {
        return exclusionChar;
    }
    public void setExclusionChar(String exclusionChar) {
        this.exclusionChar = exclusionChar;
    }
}

完成以上逻辑，可以使自定义的校验器生效。