Struts2类型转换器

概述

A 、从一个HTML 表单到一个 Action 对象,类型转换是从字符串到非字符串.

   –HTTP没有“类型” 的概念.每一项表单输入只可能是一个字符串或一个字符串数组.在服务器端, 必须把String 转换为特定的数据类型

B、在struts2中,把请求参数映射到 action 属性的工作由Parameters拦截器负责,它是默认的 defaultStack拦截器中的一员. Parameters拦截器可以自动完成字符串和基本数据类型之间转换.

类型转换错误的处理

A、若Action 类没有实现ValidationAware接口：Struts在遇到类型转换错误时仍会继续调用其Action方法,就好像什么都没发生一样.

B、若Action类实现 ValidationAware接口：Struts在遇到类型转换错误时将不会继续调用其Action方法: Struts将检查相关action元素的声明是否包含着一个name=input的result.  如果有, Struts将把控制权转交给那个 result 元素; 若没有input 结果, Struts将抛出一个异常
C、ActionSupport类实现了此接口，因此，常规的继承ActionSupport即间接的实现了此接口

类型转换错误消息的定制

A、作为默认的default拦截器的一员,ConversionError拦截器负责添加与类型转换有关的出错消息(前提:Action类必须实现了ValidationAware接口)和保存各请求参数的原始值.

B、若字段标签使用的不是simple主题,则非法输入字段将导致一条有着以下格式的出错消息:Invalid field value for field fieldName

C、覆盖默认的出错消息

       –在对应的Action类所在的包中新建 ActionClassName.properties文件,ClassName即为包含着输入字段的Action类的类名

      –在属性文件中添加如下键值对: Invalid fieldvalue.fieldName=errorMsg

D、定制出错消息的样式:

   –每一条出错消息都被打包在一个HTMLspan元素里, 可以通过覆盖其行标为errorMessage的那个css样式来改变出错消息的格式. 

E、显示错误消息: 如果是 simple 主题,可以通过 <s:fielderrorfieldName=“filedname”></s:fielderror>标签显示错误消息

如何自定义类型转换器

1). 为什么需要自定义的类型转换器 ? 因为 Struts 不能自动完成 字符串 到 引用类型 的 转换.
2). 如何定义类型转换器:
    I.  开发类型转换器的类: 扩展 StrutsTypeConverter 类.
    II. 配置类型转换器:
    有两种方式
    ①. 基于字段的配置:
        > 在字段所在的 Model(可能是 Action, 可能是一个 JavaBean) 的包下, 新建一个 ModelClassName-conversion.properties 文件
        > 在该文件中输入键值对: fieldName=类型转换器的全类名.
        > 第一次使用该转换器时创建实例.
        > 类型转换器是单实例的!    
    
    ②. 基于类型的配置:
        > 在 src 下新建 xwork-conversion.properties
        > 键入: 待转换的类型=类型转换器的全类名.
        > 在当前 Struts2 应用被加载时创建实例.
简单的自定义类型转换器实现：

假如有如下action

public class ProductAction {
   
	private int id;
	private String name;
	private Date createtime;
	
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public Date getCreatetime() {
		return createtime;
	}
	public void setCreatetime(Date createtime) {
		this.createtime = createtime;
	}
	
	public String execute(){
		return "success";
	}

}

在页面输入的createtime的时间字符串需要被转换成Date类型，自定义类型转换器如下：

public class DateConvert extends StrutsTypeConverter {
    
    private DateFormat dateFormat;
    
    public DateFormat getDateFormat() {
        if(dateFormat==null){
            
            ServletContext context=ServletActionContext.getServletContext();
            String pattern=context.getInitParameter("pattern");
            dateFormat= new SimpleDateFormat(pattern);
        }
        
        return dateFormat;
    }
    
    @Override
    public Object convertFromString(Map map, String[] values, Class typeClass) {
        if(typeClass==Date.class){
            if(values!=null && values.length>0){
                try {
                    return getDateFormat().parse(values[0]);
                } catch (ParseException e) {
                    e.printStackTrace();
                }
            }
        }
        return values[0];
    }

    @Override
    public String convertToString(Map map, Object o) {
        if(o instanceof Date){
            return getDateFormat().format(o);
        }
        return null;
    }

}

上述Date转换器中的转换后的时间格式可以在web.xml中进行配置，这样可以做到对时间格式的动态配置，在web.xml文件中加入如下配置即可：

 <context-param>
     <param-name>pattern</param-name>
     <param-value>yyyy-MM-dd hh:mm:ss</param-value>
  </context-param>

配置上述的自定义类型转换器，有2种方式：

1、通过字段名来配置：

在ProductAction所在的包下新建配置文件 ：ProductAction-converion.properties ，内容如下：

createtime=com.elgin.convert.DateConvert

2、通过类型匹配

在src下新建配置文件名为：xwork-conversion.properties ，内容如下：

java.util.Date=com.elgin.convert.DateConvert

显然，第二种配置方式是全局的，也就是在其他Action中若存在同样的类型转换问题，只要是此种配置，会自动将字符串转为Date类型。而第一种配置方式，只有ProductAction是createtime字段才会进行转换。