Strus2（十三）---输入验证

(1)struts2的输入验证
—基于Xwork Validation Framework的声明式验证,需要声明的内容包括
~~对哪个Action或Model的哪个字段进行验证;
~~使用什么验证规则;
~~如果验证失效,转向哪一个页面,显示是什么错误消息;
—编程式验证
~~可以使Action类实现Validateable接口,ActionSupport类已经实现了Validateable接口;
(2)声明式验证
—字段验证:判断某个字段属性的输入是否有效.
—非字段验证:不只针对某个字段,而是针对多个字段的输入值之间的逻辑关系进行校验.例如:对再次输入密码进行判断.
—使用声明式验证程序的步骤:
I 先明确对哪一个Action的哪一个字段进行验证.
II 编写配置文件.它的文件名必须是以下两种格式之一:
· 若一个Action类的多个action使用同样的验证规则:ActionClassName-validation.xml;
· 若一个Action的多个action使用不同的验证规则:ActionClassName-AliasName(即action的请求名)-validation.xml

例:

III 确定验证失败时的响应页面:在struts.xml文件中定义一个的元素。 (若验证失败,则转向input的那个result,所以需要配置name=”input”的result)
(3)Struts2内置的验证规则及作用:

· required: 确保某给定字段的值不是空值 null .

· requiredstring: 确保某给定字段的值既不是空值 null, 也不是空白.

• trim 参数. 默认为 true, 表示 struts 在验证该字段值之前先剔除前后空格.

· stringlength: 验证一个非空的字段值是不是有足够的长度.

• minLength: 相关字段的最小长度. 若没有给出这个参数, 该字段将没有最小长度限制 .
• maxLength:相关字段的最大长度. 若没有给出这个参数, 该字段将没有最大长度限制.
• trim: 在验证之前是否去除前后空格

· date: 确保某给定日期字段的值落在一个给定的范围内

• max:相关字段的最大值. 若没给出这个参数, 该字段将没有最大值限制.
• min:相关字段的最小值. 若没给出这个参数, 该字段将没有最小值限制.

· email: 检查给定 String 值是否是一个合法的 email.
· url: 检查给定 String 值是否是一个合法的 url.
· regex: 检查某给定字段的值是否与一个给定的正则表达式模式相匹配.

• expresssion*: 用来匹配的正则表达式.
• caseSensitive: 是否区分字母的大小写. 默认为 true.
• trim: 是否去除前后空格. 默认为 true.

· int: 检查给定整数字段值是否在某一个范围内.

• min: 相关字段的最小值. 若没给出这个参数, 该字段将没有最小值限制.
• max: 相关字段的最大值. 若没给出这个参数, 该字段将没有最大值限制.

· conversion: 检查对给定 Action 属性进行的类型转换是否会导致一个转换错误. 该验证程序还可以在默认的类型转换消息的基础上添加一条自定义的消息.
· expression 和 fieldexpression: 用来验证给定字段是否满足一个 OGNL 表达式.

• 前者是一个非字段验证程序, 后者是一个字段验证程序.
• 前者在验证失败时将生成一个 action 错误, 而后者在验证失败时会生成一个字段错误.
• expression*: 用来进行验证的 OGNL 表达式.
  例:
  

(4)声明式验证的配置文件内容:

~~自定义验证程序的出错消息的国际化配置

<message key="error.int">message>
//再在国际化配置文件中加入一个键值对:error.int = 自定义的消息

(5)如何显示错误消息?
–若使用的是非simple主题,则自动显示错误消息.
–若使用的是simple主题,则需要使用s:fielderror标签或直接使用EL表达式(使用OGNL);
例:

${fieldErrors.age[0]} OR "age"/>

(6)声明式验证框架的原理
~~Struts2默认的拦截器栈中提供了一个Validation拦截器.
~~每个具体的验证规则都会对应一个具体的拦截器.有一个配置文件把验证规则名称和验证器关联起来了,而实际上关联的是那个验证器,该文件位于com.opensymphony.xwork2.validator.validators下的default.xml

(7)短路验证器
~~若一个字段使用多个验证器,默认情况下会执行所有的验证,若希望前面的验证没有通过,后面的就不在验证,可以使用短路验证.元素和元素可以指定一个可选的short-circuit属性,该属性指定该验证器是否是短路验证器,默认值是false.

        <field-validator type="conversion" short-circuit="true">
            <message>^Conversion Error Occurredmessage>
        field-validator>

//注: 若类型转换失败, 默认情况下还会执行后面的拦截器, 还会进行 验证. 可以通过修改 ConversionErrorInterceptor 源代码的方式使当类型转换失败时, 不再执行后续的验证拦截器, 而直接返回 input 的 result
    Object action = invocation.getAction();
        if (action instanceof ValidationAware) {
            ValidationAware va = (ValidationAware) action;

            if(va.hasFieldErrors() || va.hasActionErrors()){
                return "input";
            }
        }

(8)关于非字段验证: 不是针对于某一个字段的验证.

<validator type="expression">
        <param name="expression">param>
        <message>Password is not equals to password2message>
    validator>
  //显示非字段验证的错误消息, 使用 s:actionerror 标签:  <s:actionerror/>  

(9)错误消息的重用性:即多个字段使用同样的验证规则,适用同一条验证消息

error.int=${getText(fieldName)} needs to be between ${min} and ${max}

age=\u5E74\u9F84
count=\u6570\u91CF  

具体分析:

(10) 自定义验证器:

I. 定义一个验证器的类

> 自定义的验证器都需要实现 Validator. 
> 可以选择继承 ValidatorSupport 或 FieldValidatorSupport 类
> 若希望实现一个一般的验证器, 则可以继承 ValidatorSupport
> 若希望实现一个字段验证器, 则可以继承 FieldValidatorSupport

> 具体实现可以参考目前已经有的验证器. 

> 若验证程序需要接受一个输入参数, 需要为这个参数增加一个相应的属性

II. 在配置文件中配置验证器

> 默认情况下下, Struts2 会在 类路径的根目录下加载 validators.xml 文件. 在该文件中加载验证器.
     该文件的定义方式同默认的验证器的那个配置文件: 位于 com.opensymphony.xwork2.validator.validators 下的 default.xml

> 若类路径下没有指定的验证器, 则从 com.opensymphony.xwork2.validator.validators 下的 default.xml 中的验证器加载     

III. 使用: 和目前的验证器一样.
(11)编程式验证
· Struts2 提供了一个 Validateable 接口, 可以使 Action 类实现这个接口以提供编程验证功能.
· ActionSupport 类已经实现了 Validateable 接口