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)和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/目录下。


为了让系统知道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中删除.