【图】关于Struts2的类型转换详解

一、类型转换的意义

对于一个智能的MVC框架而言,不可避免的需要实现类型转换.因为B/S(浏览器/服务器)结构应用的请求参数是通过浏览器发送到服务器的,这些参数不可能有丰富的数据类型,因此必须在服务器端完成数据类型的转换

MVC框架是一个表现层解决方案,理应提供类型转换的支持,Struts2提供了功能非常强大的类型转换支持.

二、表现层数据的处理

1、对于web应用而言,表现层主要用于与用户交互,包括收集用户输入数据，向用户呈现服务器的状态。因此表现层的数据的流向主要有两个方向：输入数据和输出数据。

2、对于输入数据：则需要完成由字符串数据向多种类型数据的转化。程序通常无法自动完成,需要在代码中手动转化

3、对于输出数据：不管是java或是jsp都支持多种数据类型的直接输出。

4、表现层另外一个数据处理是：数据校验,分为客户校验和服务器端校验.后边会重点讲解

三、类型转换

1、HTTP参数都是字符串类型。保存的数据可能是字符串、数字、布尔、日期时间等或者JavaBean类型。手工的类型转换，比如将字符串转换为日期，通过：通过request.getParameter方法获取字符串；检查是否为空；通过DateFormat.parse方法将字符串转换为Date对象

2、Struts2类型转换

Struts2内置的类型转换
String和boolean 完成字符串与布尔值之间的转换
String和char 往常字符串与字符之间的转换
String和int、Integer 完成字符串与整型之间的转换
String和Long 完成字符串与长整型值之间的转换
String和double、Double 完成字符串与双精度浮点值的转换
String和Float 完成字符串和单精度浮点之间的转换
String和Date 完成字符串和日期类型之间的转换,日期格式使用格式用户请求所在Locale的SHORT格式
String和数组在默认的情况,数组元素是字符串，如果用户定义类型转换器,也可以是其它复合数据类型
String和Map、List

3、内置类型转换

4、Struts类型转换的API

Struts2的类型转换器实际上是基于OGNL实现的，在OGNL项目中有一个ognl.TypeConverter接口,这个接口就是实现类型转换器必须实现的接口。该接口定义如下：

public interface TypeConverter {
     public Object convertValue(Map arg0, Object arg1, Member arg2, String arg3,
          Object arg4, Class arg5) {
              return null;
}

实现类型转换器必须实现上面的TypeConverter,不过上面的接口里的方法过于复杂,所以OGNL项目还提供了一个该接口实现类：ognl.DefaultTypeConverter,通过继承该类实现自己类型转换器.该类定义如下：

    public class DefaultTypeConverter extends Object implements TypeConverter{
             public Object convertValue(MapString,Object context, Object value, Class toType) {
              }
             ……//其他的方法
     }

ConvertValue方法的作用
该方法完成类型转换，不过这种类型转换是双向的,当需要把字符串转化对象实例时,通过该方法实现，当把对象实例转换成字符串时也通过该方法实现。这种转换是通过toType参数类型是需要转换的目标类型。所以可以根据toType参数来判断转换方向。
ConvertValue方法参数和返回意义
第一个参数：context是类型转换环境的上下文
第二个参数：value是需要转换的参数，根据转换方向的不同value参数的值也是不一样的。
第三个参数：toType是转换后的目标类型
该方法的返回值是类型转换后的值。该值的类型也会随着转换的方向的改变而改变。由此可见转换的convertValue方法接受需要转换的值，需要转换的目标类型为参数，然后返回转换后的目标值
Value为什么是一个字符串数组?
对于DefaultTypeConverter转换器而言,它必须考虑到最通用的情形，因此他把所有请求参数都视为字符串数组而不是字符串。相当于getParameterValues()获取的参数值

四、类型转换器的实现

1、第一步注册页面

2、第二步骤：实现User封装类

3、第三步骤：实现Action类

5、第五步骤：实现类型转换器的注册,注册方式有以下三种:

1、注册局部类型转换器:局部类型转换器仅仅对某个Action的属性其作用
2、注册全局类型转换器：全局类型转换器对所有Action的特定属性都会生效
3、使用JDK1.5的注释来注册类型转换器：通过注册方式来生成类型转换器

6、局部类型转换器注册
注册文件名格式：ActionName-conversion.properties:ActionName是需要转换器生效的Action的类名,后面的-conversion.properties字符串是固定部分
以上文件时典型的properties文件,文件有key-value对组成.文件内容为：propertyName=类型转换器类
下面是UserAction-conversion.properties文件的内容：
#指定UserAction中的user属性需要使用redarmy.user.UserConverter类完成类型转换
user=redarmy.user.UserConverter
注意：以上properties文件一定要与UserAction在同一个包中
即上述案例可采用上面的方式实现局部类型转换

7、全局类型转换器
注册名的文件格式：xwork-conversion.properties文件该文件也是properties文件,其内容也是由”复合类型=对应的类型转换器类”项组成的。
以下是xwork-conversion.properties文件内容：
     #指定所有redarmy.user.User类的类型转换器为redarmy.user.UserConverter
     redarmy.user.User=redarmy.user.UserConverter
     注意：xwork-conversion.properties文件必须为class文件夹下即在src下面创建

五、Struts2自定义类型转换

在Struts2中提供了StrutsTypeConverter类来简化自定义类型转换的设计，这个类有两个抽象方法需要实现：

     (1) public Object convertFromString(Map context, String[] values, Class toClass) ;
          用于String类型数据转成自定义类型的处理方法
          参数：
             context --- 与Action有关的上下文信息
             values   --- 从请求中获取的参数值
             toClass --- 要转换的目标类型

     (2) public String convertToString(Map context, Object obj) ;
    用于自定义类型转换成String
      参数:
         context --- 与Action有关的上下文信息
         obj --- 自定义类型对象

实例分析：一个日期类型转换的设计和配置

(1) 设计MyDateTypeConverter，继承StrutsTypeConverter，覆盖其中的两个方法，参考代码如下:
public Object convertFromString(Map context, String[] values, Class toClass) {
  SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
  try{
   Date v = sdf.parse(values[0]);
   return v;
  }catch(Exception e){
   e.printStackTrace();
   return new Date();
  }

}

续
public String convertToString(Map context, Object obj) {
      SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日");
   Date v = (Date)obj;
   return sdf.format(v);
}
虽然Struts2默认可支持String和Date的转换，但仅支持短格式和本地化有关日期格式转换，不一定符合自己的需要,我们需要实现自己的类型转换。
(2) 为UserInfo类增加一个birthday属性，其类型为java.util.Date
public class UserInfo {
private Integer id;
private String name;
private String password;
private Date birthday;
     ...
}

(3)为UserInfo这个组件配置该类型转换器
首先，以UserInfo组件的类名为基础创建一个特性文件，文件命名格式为类名-conversion.properties

比如UserInfo-conversion.properties

该文件必须和UserInfo组件在同一个包下。

该特性文件内容格式如下:
birthday=demo.converter.MyDateTypeConverter
说明:
birthday 为UserInfo组件中java.util.Date类型的属性名
demo.converter.MyDateTypeConverter为自定义转换实现类

Strus2框架为我们考虑到这一点，提供了一种简单的处理方式。

将类型转换器配置为全局级别，只需编写一个名为xwork-conversion.properties的特性文件,该文件必须位于/WEB-INF/classes目录下,内容如下:
java.util.Date=demo.converter.MyDateTypeConverter

六、自定义类型转换器

java.util.Date类型的属性可以接收格式为2009-07-20的请求参数值。但如果我们需要接收格式为20091221的请求参数，我们必须定义类型转换器，否则struts2无法自动完成类型转换。

import java.util.Date;
public class HelloWorldAction {
private Date createtime;

public Date getCreatetime() {
return createtime;
}

public void setCreatetime(Date createtime) {
this.createtime = createtime;
}
}

public class DateConverter extends DefaultTypeConverter {
                @Override public Object convertValue(Map context, Object value, Class toType) {
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMdd");
try {
  if(toType == Date.class){//当字符串向Date类型转换时
   String[] params = (String[]) value;// Request.getParameterValues()
   return dateFormat.parse(params[0]);
  }else if(toType == String.class){//当Date转换成字符串时
   Date date = (Date) value;
   return dateFormat.format(date);
  }
} catch (ParseException e) {}
return null;
}
}
将上面的类型转换器注册为局部类型转换器：
在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties 。在properties文件中的内容为：
属性名称=类型转换器的全类名
对于本例而言， HelloWorldAction-conversion.properties文件中的内容为：
createtime= cn.csdn.conversion.DateConverter

将上面的类型转换器注册为全局类型转换器：
在WEB-INF/classes下放置xwork-conversion.properties文件。在properties文件中的内容为：
待转换的类型=类型转换器的全类名
对于本例而言， xwork-conversion.properties文件中的内容为：
java.util.Date= cn.csdn.conversion.DateConverter

import java.util.Date;
public class HelloWorldAction {
private Date createtime;

public Date getCreatetime() {
return createtime;
}

public void setCreatetime(Date createtime) {
this.createtime = createtime;
}
}