struts2_大纲07_框架数据校验

 * struts2数据校验分为手工验证和自动验证(XML)
 * 手工验证：指的是在对应的action里面通过validate方法对这个action里面的属性进行校验
 * validate方法是重写，它是在ValidateAble接口中定义的
 * 所以我们这个action要实现ValidateAble接口才能完成校验
 * 但是ActionSupport已经实现了ValidateAble接口，所以我们创建的action
 * 只要继承了ActionSupport，就可以重写validate
对action中所有的方法进行校验:
@Override
public void validate() {

}
对action中指定的方法进行校验(Xxx为需要校验的方法名)
public void validateXxx() {

}
输入校验流程:
1.类型转换器对请求参数执行类型转换,并把转换后的值赋给action中的属性


2.如果在执行类型转换的过程中出现异常,系统会将异常信息保存到ActionContext;conversionError拦截器将异常信息封装到fieldError里,不管类型转换是否出现异常,都会进入到第3步


3.系统通过反射,先调用action中的validateXxx()方法,Xxx为action中的方法名


4.再调用action中的validate方法


5.如果系统中的fieldErrors存在错误信息,系统自动将请求转发至名为input的result中,如果系统中的fieldErrors没有任何错误信息,系统将执行action中的处理方法






 * 自动验证：使用xwork里面提供的验证，通过配置文件对action的属性进行验证
 使用基于xml配置的方式实现输入校验时,Action也需要继承ActionSupport,并且提供校验文件,校验文件和action类应该在同一个包中,文件命名格式为:ActionClassName-validation.xml,其中ActionClassName为action的类名,-validation是固定写法
 例子:
 对整个actionClass进行验证例:com.softeem.action.UserAction
 用于验证的配置文件命名:UserAction-validation.xml
<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE validators PUBLIC 
  "-//OpenSymphony Group//XWork Validator 1.0.2//EN" 
  "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">
  <validators>
  <field name="username">
  <field-validator type="requiredstring">
<param name="trim">true</param>
  <message>用户名不能为空</message>
  </field-validator>
  </field>
  </validators>
<field>指定action中需要校验的属性,<field-validator>指定校验器type为校验器的类型;
<param>中name值指定先调用String类的trim()方法去掉前后空格再来校验
<message>未校验失败后的提示信息


*系统提供的校验器如下：
required (必填校验器,要求field的值不能为null)


requiredstring (必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格)


stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格)


regex(正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进行正则表达式匹配时,是否区分大小写,默认值为true)


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中的复合属性,它指定一个校验文件用于校验复合属性中的属性)


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


*如果只需要对action中的某个方法执行输入校验,那么校验文件命名应该为ActionClassName-ActionName-validation.xml,其中ActionName为struts.xml中action的名称,例如:
<action name="user_*" class="com.softeem.action.UserAction" method={1}>
<result>/success.jsp</result>
<result name="input">/fail.jsp</result>
</action>
UserAction.java中的方法
public String add(){
...
}
public String update(){
...
}
若要对add()方法实施验证,校验文件的取名为:UserAction-user_add-validation.xml
若要对update()方法实施验证,校验文件的取名为:UserAction-user_update-validation.xml