struts2数据校验

1.      重写ActionSupport中的validate方法进行数据校验

如果有数据不符合规则,addFieldError(“字段名”,”错误提示”);或 addFieldError(“字段名”,getText(“错误信息的key”));方法结束后,如果有错误,那么会到input对应的视图

 

在Action中也可以写validateXxx对不同的方法进行校验,例如validateAdd就是对add方法传入的参数进行校验

 

2.      数据校验流程

a)        类型转换器对参数进行转换,给 action里的属性赋值

b)        如果在类型转换出现异常,异常信息保存到ActionContext中,conversionError拦截器负责把错误放到fieldError中,然后执行下面的这一步

c)        调用validateXxx

d)        调用validate

e)        上面的4步都没有出现fieldError,调用对应的Xxxx方法,如果有错误,到input

来自百度图片

 

3.      编写校验规则文件

给Action指定一个校验文件ActionName-validation.xml,例如UserAction-validation.xml

给Action的某方法指定校验文件ActionClassName-actionName-validation.xml例如:UserAction-add-validation.xml表示一个action的<action name=“add” 对应的类是UserAction

为了一个Action类可以处理多个请求，又可以对不同的请求进行验证，一般会在配置文件中使用通配符，例如 <action name="user_*" method="{1}" 那么 user_add.action 对应UserAction里的add方法，对应的验证文件是UserAction-user_add-validation.xml

参考:

http://blog.163.com/yangmo_119/blog/static/18204602020112239574393/

执行顺序:

1. 所有非字段校验风格的校验器优先于字段校验风格的校验器； 
2. 所有非字段校验风格的校验器中，排在前面的会先执行； 
3. 所有字段校验风格的校验器，排在前面的会先执行；      

短路情况:

1. 所有非字段检验器时最优先执行的，如果某个非字段校验器校验失败了，则该字段上的所有字段校验器都不会获得校验机会； 
2. 非字段校验校验失败，不会阻止其他非字段校验执行； 
3. 如果一个字段校验器校验失败后，则该字段下且排在该校验失败后的检验器之后的其他字段校验器不会获得校验机会； 
4. 字段校验器永远不会阻止非字段校验器的执行！

当然这些短路要在验证文件里设置=true才会对后面的验证器起作用

在这里会发现如果几个验证器顺序排列，都没设置短路，应该第一个验证不通过，对第二个不影响，但是有时候发现前面的验证错误会显示，后面的验证错误不显示，例如一个非空验证和正则验证，如果没输入内容，那么只会匹配非空验证，正则验证则没有提示，如果出现这种情况，可以从源代码中找到答案，正则验证中的部分代码：

com.opensymphony.xwork2.validator.validators.RegexFieldValidator:

public void validate(Object object) throws ValidationException {
        String fieldName = getFieldName();
        Object value = this.getFieldValue(fieldName, object);
        // if there is no value - don't do comparison
        // if a value is required, a required validator should be added to the field
        if (value == null || expression == null) {
            return;
        }

        // XW-375 - must be a string
        if (!(value instanceof String)) {
            return;
        }

        // string must not be empty
        String str = ((String) value).trim();
        if (str.length() == 0) {
            return;
        }

你会发现正则验证中前提是非null和非空字符串

 

4.      struts2内部内置的数据校验

 

required(必填校验器,要求field的值不能为null)

requiredstring   (必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格)
stringlength       (字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格)
regex        (正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进行正则表达式匹配时,是否区分大小写,默认值为true) 用<![CDATA[(正则表达式)]]>以免特殊字符的错误
int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值)
double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)
fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过)
email(邮件地址校验器,要求如果field的值非空,则必须是合法的邮件地址)
url(网址校验器,要求如果field的值非空,则必须是合法的url地址)
date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)
conversion(转换校验器,指定在类型转换失败时,提示的错误信息)
visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性) 类名-contextValue-validation.xml放在和要检验的Bean类放在一个路径中,如果不写appendPrefix那么就表示没有前缀,而不是写成false!

expression(OGNL表达式校验器,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中) 这个验证器对应的类没有”fieldName字段”

 

5.      自定义数据校验

在src下新建一个validators.xml模仿com.opensymphony.xwork2.validator.validators下的default.xml,如果struts在classes下找到一个validators.xml就不会加载默认的default.xml,所以应该把default.xml中的内容复制到我们自己新建的validators.xml中

自己的数据校验可以模仿内置的校验器,可参考:

http://www.cnblogs.com/eggbucket/archive/2012/02/07/2340943.html

http://www.cnblogs.com/over140/articles/982934.html

 

6.      在form中写validate="true",主题不是simple那么,客户端自动添加js脚本,不建议使用(不灵活)