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:fielderror fieldName = “ 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字段才会进行转换。