Struts2的类型转换器

一、概述
    在B/S应用中，将字符串请求参数转换为相应的数据类型，是MVC框架提供的功能，而Struts2是很好的MVC框架实现者，理所当然，提供了类型转换机制。

    Struts2的类型转换是基于OGNL表达式的，只要我们把HTML输入项（表单元素和其他GET/POET的参数）命名为合法的OGNL表达式，就可以充分利用Struts2的转换机制。

    除此之外，Struts2提供了很好的扩展性，开发者可以非常简单的开发自己的类型转换器，完成字符串和自定义复合类型之间的转换。总之，Struts2的类型转换器提供了非常强大的表现层数据处理机制，开发者可以利用Struts2的类型转换机制来完成任意的类型转换。

二、实现自定义类型转换器
    实现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、类型转换类

public class DateConverter extends StrutsTypeConverter {

	private static String DATE_TIME_FOMART_IE = "yyyy-MM-dd HH:mm:ss";

	private static String DATE_TIME_FOMART_FF = "yy/MM/dd hh:mm:ss";

	@Override
	public Object convertFromString(Map context, String[] values, Class toClass) {
		Date date = null;
		String dateString = null;
		if (values != null && values.length > 0) {
			dateString = values[0];
			if (dateString != null) {
				// 匹配IE浏览器
				SimpleDateFormat format = new SimpleDateFormat(DATE_FOMART_IE);
				try {
					date = format.parse(dateString);
				} catch (ParseException e) {
					date = null;
				}
				// 匹配Firefox浏览器
				if (date == null) {
					format = new SimpleDateFormat(DATE_FOMART_FF);
					try {
						date = format.parse(dateString);
					} catch (ParseException e) {
						date = null;
					}
				}
			}
		}
		return date;
	}

	@Override
	public String convertToString(Map context, Object o) {
		// 格式化为date格式的字符串
		Date date = (Date) o;
		String dateTimeString=DateUtils.formatDate(date);
	}

}

注：DateUtils.formatDate(date);是调用该项目一个基础包的公用方法，如果单独使用，直接用日期格式化代码代替。

2、xwork-conversion.properties配置文件

java.util.Date=com.aumy2008.converter.DateConverter

评论

9 楼 Ethip 2008-10-21  

你开头的讲解很到位，基本可以掌握自定义转换器的流程.

我在做全局转换的时候，出现了问题。我的实例中，因为要转换多个相同类型的属性，用到泛型。
如果你有空的话，麻烦帮我看看哦 ^_^

http://ethip.iteye.com/blog/254754

8 楼 danielye 2008-05-23  

guying1028 写道

是啊，好像还要在struts.properties配置文件中配置一下，但具体我也不是很清楚，看看吧

不需要修改struts.properties的

7 楼 guying1028 2008-05-21  

是啊，好像还要在struts.properties配置文件中配置一下，但具体我也不是很清楚，看看吧

6 楼 aumy2008 2008-04-30  

引用

saturn 前天
如何对Date类型 实现多个类型转换 呢？？

例如：

1.年月日 Date <---> String

2.年月日时分 Date <---> String

可以采用全局类型转换器和局部类型转换器来分别实现。

5 楼 myoldman 2008-04-28  

补充一个case
页面上不是直接引用action某个属性,而是引用action中某个bo的某个字段,这个时候如果我们需要对bo中的某个字段做特定的类型转化.
例如我想把某个bo类中的某个double字段显示成百分比的格式,并且实现toString和fromString的双向转换,则需要如下步骤.
1.页面上代码:

<s:textfield  cssStyle="width:50%" name="userClientInfo.flatRate" id="userClientInfo.flatRate" cssClass="bodytext requiredPercent"  />

2.action中的userClientInfo字段的声明

private UserClientInfo userClientInfo;

3.UserClientInfo类所在的包路径中需要定义UserClientInfo-conversion.properties文件内容如下:

flatRate = com.fjimt.common.utils.PercentTypeConverter

4.定义PercentTypeConverter

private static final Logger log = Logger.getLogger(DateTypeConverter.class);
	private static final String DEFAULT_DOUBLE_FORMAT = "0.00";
	private static final NumberFormat doubleFormater = new  DecimalFormat(DEFAULT_DOUBLE_FORMAT);
	@Override
	public Object convertFromString(Map context, String[] values, Class toClass) {
		if (values[0] == null || values[0].trim().equals(""))
			return 0.00d;
		try {
			return doubleFormater.parse(values[0].substring(0,values[0].length() - 1 ));
		} catch (ParseException e) {
			log.error("Error parsing" + values[0] +" to percent");
		}
		return 0.00d;
	}

	@Override
	public String convertToString(Map arg0, Object o) {
		if (o instanceof Double) {
			try {
				return doubleFormater.format(o) + "%";
			} catch (RuntimeException e) {
				return "0.00%";
			}
		}
		return "0.00%";
	}

4 楼 myoldman 2008-04-28  

saturn 写道

如何对Date类型 实现多个类型转换 呢？？

例如：

1.年月日     Date <---> String

2.年月日时分 Date <---> String

对于这种case可以采用如下的代码解决(btw偶也是从别人那边看来的)

public static final DateFormat[] ACCEPT_DATE_FORMATS = {
			new SimpleDateFormat(DEFAULT_DATE_FORMAT),
			new SimpleDateFormat("yyyy-MM-dd"),
			new SimpleDateFormat("yyyy/MM/dd") };

	/**
	 * 
	 */
	public DateTypeConverter() {
	}

	/*
	 * (non-Javadoc)
	 * 
	 * @see org.apache.struts2.util.StrutsTypeConverterconvertFromString(java.util.Map,
	 *      java.lang.String[], java.lang.Class)
	 */
	@Override
	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 static final Object[][] ACCEPT_DATE_FORMATS_REGEX =
	{
		{Pattern.compile("dd/MM/yyyy"),new SimpleDateFormat(DEFAULT_DATE_FORMAT)},
		{Pattern.compile("yyyy-MM-dd"),new SimpleDateFormat("yyyy-MM-dd")},
		{Pattern.compile("yyyy/MM/dd"),new SimpleDateFormat("yyyy/MM/dd")}
	};

	public Object convertFromString(Map context, String[] values, Class toClass) {
		for (Object[] regexFormat : ACCEPT_DATE_FORMATS_REGEX) {
			Pattern pattern = (Pattern) regexFormat[0];
			SimpleDateFormat dateFormat =  (SimpleDateFormat)regexFormat[1];
			if(pattern.matcher(values[0]).find())
			{
				try {
					return dateFormat.parse(values[0]);
				} catch (ParseException e) {
					continue;
				}
			}
		}

3 楼 saturn 2008-04-27  

如何对Date类型 实现多个类型转换 呢？？

例如：

1.年月日     Date <---> String

2.年月日时分 Date <---> String

2 楼 longgue 2008-04-23  

有没有什么方法可以将验证的字段不用写在Action类中而实现验证呢？

比如: Foo 域对象，有Date类型的字段date;
自定义了DateConverter之后，Action中不用setDate(),getDate()就可以实现验证呢？

1 楼 deadeye 2007-12-23  

有报错啊
Conversion registration error
java.lang.ClassCastException:  com.abc.util.DateConverter