一、概述
Struts2的类型转换器都需要实现一个TypeConverter接口,该接口位于ognl.jar包内,也是就Struts2框架的转换器使用了OGNL技术。该接口定义了一个convertValue()方法,实现该接口的类型转换器实现类都需要重写该方法来进行类型转换。OGNL还提供了一个实现TypeConverter接口的类DefaultTypeConverter,开发者只要继承该类,就可以开发类型转换器的实现类。 DefaultTypeConverter类的子类需要重写convertValue()方法,来实现字符串类型与复合类型之间的双向转换。convertValue()方法有三个参数:Map context:该参数为类型转换环境的上下文内容;Object value:该参数为需要转换的参数;Class toType:该参数指的是转换目标的类型。
二、实现自定义类型转换器
实现TypeCoverter接口,或者继承DefaultTypeConverter实现类(该类实现了TypeCoverter接口),通过继承该实现类来实现自己的类型转换器。重写convertValue方法即可。
为了简化类型转换器的实现,Struts2提供了一个StrutsTypeConverter抽象类,这个抽象类是DefaultConverter的子类。实现了方法,并提供了2个不同转换方向的方法:Object
convertToString(Map context,String[] values,Class toClass)和String convertFromString(Map context,Object o)。
三、注册应用
实现了自定义类型转换器之后,将该类型转换器注册在Web应用中,Struts2框架才可以正常使用该类型转换器。
关于类型转换器的注册方式,主要有3中:
A、注册局部类型转换器:仅仅对某个Action的属性起作用。
B、注册全局类型转换器:对所有Action的特定类型的属性都会生效。
C、使用JDK1.5的注释来注册类型转换器:通过注释方式来生成类型转换器。
1、局部类型转换器
提供如下格式的文件
文件名: ActionName-conversion.properties
内容:多个propertyName(属性名)=类型转换器类(含包名),如 date=com.aumy.DateConverter
存放位置:和ActionName类相同路径。
2、全局类型转换器
提供如下格式的文件
文件名: xwork-conversion.properties
内容: 多个“复合类型=对应类型转换器”项组成,如 java.Util.Date=com.aumy.DateConverter
存放位置:WEB-INF/classes/目录下。
四、应用示例
由于Struts2对日期转换显示时,会显示日期和时间,现在项目只需要显示日期,所以采用自定义的类型转换器来实现日期显示。
1、类型转换类
package com.globalzt.framework.common;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;
import org.apache.log4j.Logger;
import org.apache.struts2.util.StrutsTypeConverter;
public class DateTypeConverter extends StrutsTypeConverter{
private static final Logger log = Logger.getLogger(DateTypeConverter.class);
public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
public static final DateFormat[] ACCEPT_DATE_FORMATS = {new SimpleDateFormat(DEFAULT_DATE_FORMAT),new SimpleDateFormat("yyyy年MM月dd日"),new SimpleDateFormat("yyyy/MM/dd")};
public DateTypeConverter() {
}
public Object convertFromString(Map context, String[] values, Class toClass) {
if (values[0] == null || values[0].trim().equals(""))
return null;
for (DateFormat format : ACCEPT_DATE_FORMATS){
try{
return format.parse(values[0]);
} catch(ParseException e){
continue;
} catch(RuntimeException e){
continue;
}
}
log.debug("can not format date string:" + values[0]);
return null;
}
public String convertToString(Map context, Object o){
if(o instanceof Date){
SimpleDateFormat format = new SimpleDateFormat(DEFAULT_DATE_FORMAT);
try {
return format.format((Date)o);
} catch(RuntimeException e){
return "";
}
}
return "";
}
}
2、xwork-conversion.properties配置文件,放在src根目录下
java.util.Date=com.aumy2008.converter.DateConverter