Struts2输入校验

1、编写校验规则文件
（<ActionName>-validation.xml），文件放在Action类文件相同的路径下校验失败返回input的result。

<validators>
<!-- 校验Action的name属性 -->
<field name="name">
<!-- 指定name属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<message key="name.requried"/> <!--国际化信息（国际化资源文件中有name.requried=必须输入用户名）-->
</field-validator>
<!-- 指定name属性必须匹配正则表达式 -->
<field-validator type="regex">
<param name="regex"><![CDATA[(\w{4,25})]]></param>
<message key="name.regex"/>
</field-validator>
</field>

<!-- 指定age属性必须在指定范围内-->
<field name="age">
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<message key="age.range"/>
</field-validator>
</field>
<!-- 指定birth属性必须在指定范围内-->
<field name="birth">
<field-validator type="date">
<!-- 下面指定日期字符串时，必须使用本Locale的日期格式 -->
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<message key="birth.range"/>
</field-validator>
</field>

</validators>

2、使用客户端校验
1）将输入页面表单元素改为使用Struts2标签来生成表单。
2）为该<s:form../>元素增加validate=“true”属性。
<s:fielderror/>
<s:form action="regist" validate="true">
<s:textfield name="name" label="用户名"/>
<s:textfield name="pass" label="密码"/>
<s:textfield name="age" label="年龄"/>
<s:textfield name="birth" label="生日"/>
<s:submit value="注册"/>
</s:form>

客户端校验仍然是基于JavaScript的，因为JS本身的限制，有些服务器端校验不能转换成客户端校验。
客户端校验仅支持下面几种：
required validator必填校验器
requiredstring validator必填字符串校验器
stringlength validator字符串长度校验器
regex validator表达式校验器
email validator邮件校验器
url validator网址校验器
int validator整数校验器
double validator双精度

客户端校验需要注意：
不要将<s:form../>元素的theme属性指定为simple
浏览器直接访问启用客户端校验的表单页会引发异常，可把这些表单放WEB-INF下，通过核心Filter后再访问
如果客户端校验需要输出国际化提示信息，则需要使用全局国际化资源文件，不能使用Action范围的文件
启用客户端校验的表单页面的action和namespace要分开写（<s:form action="regist" namespace="/wj"> not <s:form action="wj/regist">）

3、校验器配置风格
字段校验器风格
参考1里面的校验文件
非字段校验器风格
<!-- 配置指定必填字符串的校验器 -->
<validator type="requiredstring">
<!-- 使用该校验器校验name属性 -->
<param name="fieldName">name</param>
<param name="trim">true</param>
<!-- 指定校验失败后输出name.required对应的国际化信息 -->
<message key="name.requried"/>
</validator>
<!-- 配置指定正则表达式的校验器 -->
<validator type="regex">
<!-- 使用该校验器校验name属性 -->
<param name="fieldName">name</param>
<param name="trim">true</param>
<param name="regex"><![CDATA[(\w{4,25})]]></param>
<!-- 指定校验失败后输出name.required对应的国际化信息 -->
<message key="name.regex"/>
</validator>

4、短路校验器
<field-validator type="requiredstring" short-circuit="true">

5、校验文件搜索规则
遇到下列情况时:
<action name="*Pro" class="org.crazyit.app.action.RegistAction"
method="{1}">
解决方案：
为校验规则文件添加Action别名来指定需要校验的处理逻辑：
<ActionClassName>-<ActionAliasName>-validation.xml

假设系统有两个Action:BaseAction和RegistAction,RegistAction继承了BaseAction，系统搜索文件顺序如下：
1）BaseAction-validation.xml
2）BaseAction-别名-validation.xml
3）RegistAction-Validation.xml
4）RegistAction-别名-validation.xml
搜索到第一个校验文件后，还会继续搜索。
搜索从上到下，实际规则是所有规则总和，有冲突时，以后面规则为准。

6、校验顺序和短路
校验器执行顺序有如下原则：
先非字段风格校验器，再字段；排在前面的先执行。
校验器短路原则：
所有非字段校验器优先，某个非字段校验器失败，对应字段的字段校验器不再校验，其他非字段校验器仍要执行，字段校验器失败后的其他字段校验器不会执行。

7、内建校验器
Struts2包下xwork-2.3.16.3.jar中com\opensymphony\xwork2\validator\validators 下的default.xml文件。

<?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">

<!-- START SNIPPET: validators-default -->
<validators>
<validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>
<validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>
<validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>
<validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>
<validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>
<validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>
<validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>
<validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>
<validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>
<validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>
<validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>
<validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>
<validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>
<validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/>
</validators>
<!-- END SNIPPET: validators-default -->

8、基于注解的输入校验
可以简化开发，但是会给维护带来一定的困难

// 使用注解指定必填、正则表达式两个校验规则
@RequiredStringValidator(key = "name.requried"
, message = "")
@RegexFieldValidator(regex = "\\w{4,25}"
,key = "name.regex" , message = "")
public void setName(String name)
{
this.name = name;
}
// age的setter和getter方法
@IntRangeFieldValidator(message = ""
, key = "age.range", min = "1"
, max = "150")
public void setAge(int age)
{
this.age = age;
}

// birth的setter和getter方法
@DateRangeFieldValidator(message = ""
, key = "birth.range", min = "1900/01/01"
, max = "2050/01/21")
public void setBirth(Date birth)
{
this.birth = birth;
}

9、手动完成输入校验
1）重写validate()方法
2）重写validateXxx方法

10、Struts2输入校验步骤
1）类型转换器对字符串的请求参数执行类型转换，并将这些值设置为Action属性值。
2）类型转换过程中如果出现异常，将异常信息保存到ActionContext中，conventionError拦截器负责将其封装到FieldError里。
3）使用Struts2中配置的校验器进行输入校验。
4）通过反射调用validateXxx()方法。
5）调用validate()方法。
6）若没有出现FieldError时调用Action里的处理方法，出现了则转入input逻辑视图所指定的视图资源。