在写前几篇文章的时候，有些朋友建议我的写一篇关于表单数据校验的文章。 正如文章的开头所引用的《Writing Secure Code》的名言：“所有的输入都是罪恶的”，所以我们应该对所有的外部输入进行校验。而表单是应用程序最简单的入口，对其传进来的数据，我们必须进行校验。

转换与校验（Conversion & Validation）

package tutorial;

import java.util.Locale;

import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.util.LocalizedTextUtil;

public class HelloWorld extends ActionSupport {
    private String msg;
    private Locale loc = Locale.US;
   
    public String getMsg() {
        return msg;        
   }
   
    public Locale getLoc() {
        return loc;
   }
   
    public void setLoc(Locale loc) {
        this .loc = loc;
   }
   
   @Override
    public void validate() {
       System.out.println( " Calling validate() " );
        if ( ! (loc.equals(Locale.US) || loc.equals(Locale.CHINA))) {
                   addFieldError( " loc " , getText( " validation.loc " ));
       }
   }
       
    public void validateExecute() {
       System.out.println( " Calling validateExecute() by reflection " );
   }
   
   @Override
    public String execute() {
       System.out.println( " Calling execute() " );
        // LocalizedTextUtil是Struts 2.0中国际化的工具类，<s:text>标志就是通过调用它实现国际化的
           msg = LocalizedTextUtil.findDefaultText( " HelloWorld " , loc);
        return SUCCESS;
   }
}

package tutorial;

import java.util.Locale;
import java.util.Map;
import java.util.regex.Pattern;

public class LocaleConverter extends ognl.DefaultTypeConverter {
   @Override
    public Object convertValue(Map context, Object value, Class toType) {
        if (toType == Locale. class ) {            
           System.out.println( " Converting String to Locale " );
           String locale = ((String[]) value)[ 0 ];
            return new Locale(locale.substring( 0 , 2 ), locale.substring( 3 ));
       } else if (toType == String. class ) {
           System.out.println( " Converting Locale to String " );
           Locale locale = (Locale) value;
            return locale.toString();
       }
        return null ;
   }
}

globalMessages_zh_CN.properties

 

globalMessages_en_US.properties

1. 通过转换器将请求参数转换成相应的Bean属性；
2. 判断转换过程是否出现异常。如果有，则将其保存到ActionContext中，conversionError拦截器再封装为fieldError；如果没有，进行下一步；
3. 通过反射（Reflection）来调用validateXxx()方法（其中，Xxx表示Action的方法名）；
4. 调用validate()方法；
5. 如果经过上述步骤没有出现fieldError，则调用Action方法；如果有，则会跳过Action方法，通过国际化将fieldError输出到页面。

图1 校验顺序图

1. 如果需要转换的数据，通常做法在转换的时候做格式的校验，在Action中的校验方法中校验取值。假如用户填错了格式，我们可以通过在资源文件配置invalid.fieldvalue.xxx（xxx为属性名）来提示用户正确的格式，不同的阶段出错显示不同的信息。具体做法请参考上面的例子；
2. 至于用validate()还是validateXxx()，我推荐使用validate()。原因是validateXxx()使用了反射，相对来说性能稍差，而validate()则是通过接口com.opensymphony.xwork2.Validateable调用。当然如果你的表单数据取值是取决于特定Action方法，则应该使用validateXxx()。

图2 错误格式

图3 取值错误

使用Struts 2.0的校验框架

package tutorial;

import com.opensymphony.xwork2.ActionSupport;

public class ValidationAction extends ActionSupport {
    private String reqiuredString;

    public String getReqiuredString() {
        return reqiuredString;
   }

    public void setReqiuredString(String reqiuredString) {
        this .reqiuredString = reqiuredString;
   }
   
   @Override
    public String execute() {
        return SUCCESS;
   }    
}

Input.jsp

 

Output.jsp

图4 Input.jsp

图5 错误提示

图6 Output.jsp

1. 还没有国际化错误消息；
2. 没有实现客户端的校验。

1. 在Xxx-validation.xml文件中的<message>元素中加入key属性；
2. 在Input.jsp中的<s:form>标志中加入validate="true"属性，就可以在用Javascript在客户端校验数据。

图7 客户端校验

配置文件查找顺序

1. 接口 Animal;
2. 接口 Quadraped 扩展了 Animal;
3. 类 AnimalImpl 实现了 Animal;
4. 类 QuadrapedImpl 扩展了 AnimalImpl 实现了 Quadraped;
5. 类 Dog 扩展了 QuadrapedImpl;

1. Animal-validation.xml
2. Animal-别名-validation.xml
3. AnimalImpl-validation.xml
4. AnimalImpl-别名-validation.xml
5. Quadraped-validation.xml
6. Quadraped-别名-validation.xml
7. QuadrapedImpl-validation.xml
8. QuadrapedImpl-别名-validation.xml
9. Dog-validation.xml
10. Dog-别名-validation.xml

已有的校验器

总结

struts2（五） Spring中注入概念的简单介绍

评论 (0) All