Struts2的类型转换器

关键字: 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)用于将对象object转化为字符串String。

和

String convertFromString(Map context,Object o)。将字符串String转换为对象Object

：我觉得这个转换器好象只能转换一个控件内部的字符串（前台），不能将多个控件内的字符串映射到一个对象。有局限性。看到很多的实例，都是说，将一行string装化为一个对象的，要使大家谁找到多个控件能容通过一个转换器转换为对象，吧他发给我好么！谢谢！！！

三、注册应用
    实现了自定义类型转换器之后，将该类型转换器注册在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  

 

来源：http://aumy2008.iteye.com/blog/150202

另外：

为了让系统知道List里的元素类型，为了让系统的类型转换器起作用，有两种方法： （有泛型了，就不用写类型转换文件了）

1、使用泛型来限制集合里元素的类型；eg:在Action类代码中关于user属性的泛型定义为：private List<user> user;

2、使用Struts2的配置文件：使用局部类型转换的配置文件来指定集合元素的数据类型。

为了在局部类型转换文件中指定集合元素的类型，应该在局部类型转换文件中增加如下的key-value对：

Element_xxx = 复合类型 (说明：key-value对中的Element是固定的，xxx是Action中的集合属性名，复合类型是集合元素类型的全限定数类名[应该增加完整的包前缀])

eg:Element_user = lee.User    //指定Action类的user集合属性的元素为lee.User实例

下面先介绍一下局部类型转换器的注册，要注册类型转换吕只需提供文件名为如下格式的文件：

　　ActionName-conversion.properties:ActionName是需要转换器第一次的Action的类名，后面的-conversion.properties字符串则是固定部分。

　　　eg:对于LoginAcion.java类，则应该提供的类型转换器注册文件的文件名为：LoginAction-conversion.properties,该文件由key-value对组成。文件内容为：　propertyName=类型转换器类

　　LoginAction-conversion.properties文件应该与LoginAction.java文件放在相同路径下（如LoginAction.java的包为lee，则该文件也应放在包lee内）。


有几个要说明的地方，这时封装Set集合时必须要注意的：
1．CustomerInserterAction.java中对orders必须要初始化，如下所示：
   private Set<Order> orders=new HashSet();
2．在jsp页面中给变量命名时必须要按照如下的格式：
   <input name="orders.makeNew[0].orderNumber" type="text"  size="10">
   必须要使用makeNew运算符，这样ognl才能帮我创建新的对象，否则orders会为空。当时如果集合类型是List，就不必这样，直接name="orders[0].orderNumber"就可以了。
3．在Class-conversion.properties文件中加上KeyProperty_orders=id，这是封装Set时必须的。这个主要是用来设置检索集合中元素时的索引，具体含义:
也可以向WebWork传递元素的某个给定属性的值来获取集合中的唯一元素(element). 缺省情况下, 这个属性由 Class-conversion.properties中定义的KeyProperty_xxx=yyy决定, 这里的xxx是返回集合的JavaBean类型名称, yyy是我们用于索引集合中元素的属性名称.

MyAction.java 
/** 
* @return a Collection of Foo objects 
*/ 
public Collection getFooCollection() 
{ 
    return foo; 
}Foo.java 
/** 
* @return a unique identifier 
*/ 
public Long getId() 
{ 
    return id; 
}

 然后将 KeyProperty_fooCollection=id 放在MyAction-conversion.properties文件中. 这样就可以使用 fooCollection(someIdValue) 从集合fooCollection中获取id等于 someIdValue 的Foo对象. 例如, fooCollection(22) 将得到id值为22的Foo对象.

这一点十分有用, 因为这直接将一个集合中的元素与它的唯一标志符联系起来, 而不需要强制使用索引, 从而允许修改一个Bean的集合中的元素而不需要编写额外的代码. 例如, 值为 Phil 的参数 fooCollection(22).name 将集合fooClooection中id属性值为22的Foo对象的name属性设置为"Phil".

Webwork可以使用类型转换自动将参数的类型转换成key属性的类型.

与Map和List元素的属性不同, 如果fooCollection(22)不存在, WebWork不会创建新的对象. 想要做到这一点, 可以使用符号 fooCollection.makeNew[index], 在这里index是一个整数(0, 1等等). 因此, 参数 fooCollection.makeNew[0]=Phil 以及 fooCollection.makeNew[1]=John 将在fooCollection中添加两个新的Foo对象, 一个name属性值为Phil, 另一个为Bar. 注意, 不管用哪种方法, 在使用Set类型时, 必须定义对象的equals方法和hashCode方法来并保证他们不仅仅包含id属性. 这将导致id属性为null的元素可以从Set中删除.
来源：http://zhangzuanqian.iteye.com/blog/215822