struts2-声明式验证

一个好的，健壮的web应用必须要确保用户的输入是合法的，有效的。当然除了直接把前端的值传到后端验证之外，struts2也支持输入验证。
基于 XWork Validation Framework 的声明式验证：Struts2 提供了一些基于 XWork Validation Framework 的内置验证代码。使用验证过程不需要编程, 只要在一个 XML 文件里对验证程序应该如何工作作出声明就可以了。需要声明的内容包括: 哪些字段需要进行验证、使用什么验证规则、在验证失败时应该把什么样的出错消息发送到浏览器端。
当然，还有一种编程式验证，用的比较少，所以就不记录了。

声明式验证程序开发

确定好要验证的字段或非字段，然在该字段的Action或Model包的同路径下创建配置文件，文件名为ActionClassName-validation.xml，如果一个Action类的不同action需要不同的验证规则，那就在中间加别名来区分，一般写为ActionClass-alias-validation.xml, 例如 UserAction-User_create-validation.xml。配置好后，在struts.xml文件中为验证失败的结果做result配置，定义一个<result name="input">/register.jsp</result>的元素

<action name="register" class="com.struts.validate.RegisterAction">
        <result name="success">/success.jsp</result>
        <result name="input">/register.jsp</result>
</action>

这些配置可以参考struts-2.3.15.3/docs/WW/docs/validation.html 文档。

对字段属性的验证

简单的验证如下配置

标红的名字一定要一样

同时还有注意struts.xml文件中要配置请求的失败结果

<action name="validate-age" class="com.example.action.MyValidationAction">
    <result>/success.jsp</result>
	<!--如果验证失败就转向-->
    <result name="input">/index.jsp</result>
</action>

这样就会在值栈中有个字段名的错误信息，才能在页面上显示。

对非字段验证

<!--字段验证方式-->
<field name="email_address"> 
 <field-validator type="required"> 
     <message>You cannot leave the email address field empty.</message> 
 </field-validator> 
 <field-validator type="email"> 
     <message>The email address you entered is not valid.</message> 
 </field-validator> 
</field> 
<!--非字段验证方式-->
<validator type="required"> 
 <param name="fieldName">email_address</param> 
 <message>You cannot leave the email address field empty.</message> 
</validator> 
<validator type="email"> 
 <param name="fieldName">email_address</param> 
 <message>The email address you entered is not valid.</message> 
</validator> 

声明式验证框架的原理

1.validator type

type="email"、type="required"这些验证规则其实是struts2定义好的一个个验证器，把它加到默认的packagestruts-default里，然后继承就能使用这些验证器。

2.验证器的param

我们在int类型的验证器里些的参数min、max等就是这个验证器类的属性。

<field-validator type="int">
    <param name="min">15</param>
    <param name="max">50</param>
    <message>You must enter a value for age.</message>
</field-validator>

短路验证

短路验证: 若对一个字段使用多个验证器, 默认情况下会执行所有的验证. 若希望前面的验证器验证没有通过, 后面的就不再验证, 可以使用短路验证。

<!-- 设置短路验证配置，如果类型转换失败就不进行下面的验证 -->
<field-validator type="conversion" short-circuit="true">
   <message>^Conversion Error Occurred</message>
</field-validator>
<field-validator type="int">
   <param name="min">10</param>
   <param name="max">60</param>
<message>You must enter a legal value for age.</message>
</field-validator>	

应用

不同的字段使用同样的验证规则, 而且使用同样的响应消息，如何实现？
就是用国际化配置，然后把字段变量名用${getText(fieldName)} 替换，例如下面的配置

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

如何自定义验证器

自定义验证器必须实现 Validator 接口.
ValidatorSupport 和 FieldValidatorSupport 实现了 Validator 接口

若需要普通的验证程序, 可以继承 ValidatorSupport 类
若需要字段验证程序, 可以继承 FieldValidatorSupport 类
若验证程序需要接受一个输入参数, 需要为这个参数增加一个相应的属性
注册验证程序: 自定义验证器需要在类路径里的某个 validators.xml 文件里注册: 验证框架首先在根目录下找validators.xml文件,没找到validators.xml文件, 验证框架将调用默认的验证设置,即default.xml里面的配置信息.

参考的博文：struts2之声明式验证
参考的struts doc：struts-2.3.16.1/docs/WW/docs/validation.html