Struts温习(7)--自定义类型转换器

一、概述 

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

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

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

　WEB应用接收到表单提交的数据都是String类型的,Struts2可方便的转换为 常规类型(数值,日期) / 自定义类型(User,Point类).

  如果转换中出现异常,conversionError拦截器会自动处理该异常.

二、 常规类型的转换

　　比如表单提交的信息有 用户名,生日, 年龄, Action中对应的数据类型分别是 String, Date, int.　 没什么好说的, Struts2会自动完成.

　　Struts2内建了常用的类型转换器,如String ,boolean,char,int,long,float,double,Date, 数组(假定元素是String类型), 集合(假定元素是String类型,用ArrayList封装)

三、页面中常用类型的OGNL表达式写法

     在html表单中的文本框里输入的不管是数值类型还是字符类型，最后都是以String类传到后台。如果后台bean的属性是int、double、Date等，Struts就会自动把字符类型转换成相应的类型。

    Struts2中默认提供了一些内置的转换器，包括8个基本类型，Date，array数组，List，Map类。也可以自定义转换器。通过实现ogln.TypeConverter接口实现它的方法就可以定义其他类型的转换，不过还要配置相应的资源文件。其实那几个内置的转换器已经足够使用了，很少会专门定义一个转换器。

    基本数据类型转换器没有什么特殊要求，只要输入的值符合基本数据类型，它都会自动转换，否则会出现错误提示。比如对于int类型，前天就不能输入跟数字无关的字符。再来就是日期类型，默认好像是YY-MM-DD，比如2008-8-8，如果写成8-8-2008提交后就会出现错误提示。

    对于Array数组，List，Map则需要配合OGNL表达式一起使用。比如后台有个属性是String [] name,在前台界面 

  <s:textfield name="names[0]" label="names"/>

   <s:textfield name="names[1]" label="names"/>

   <s:textfield name="names[2]" label="names"/> 

就会对这个数组赋值。List跟数组使用方式一样，但只针对不加泛型的基本数据类型的的List，如果加了泛型则是

<s:textfield name="users[0].username" label="Usernames"/>

<s:textfield name="users[1].username" label="Usernames"/>

<s:textfield name="users[2].username" label="Usernames"/>

比如User类中有个username属性，List<User> users这个属性对应上面的写法。

最后是Map的转换方式

<s:textfield name="maidenNames['beth']" label="Maiden Name"/>

<s:textfield name="maidenNames['sharon']" label="Maiden Name"/>

<s:textfield name="maidenNames['martha']" label="Maiden Name"/>

[]里的值对应到Map中的Key

四、自定义类型转换器

  实现TypeCoverter接口，或者继承DefaultTypeConverter实现类（该类实现了TypeCoverter接口），通过继承该实现类来实现自己的类型转换器。重写convertValue方法即可。 

    为了简化类型转换器的实现，Struts2提供了一个StrutsTypeConverter抽象类，这个抽象类是DefaultConverter的子类。实现了方法，并提供了2个不同转换方向的方法：Object 

convertToString(Map context,String[] values,Class toClass)和String convertFromString(Map context,Object o)。 

 具体使用步骤：

 1）注册应用 

    实现了自定义类型转换器之后，将该类型转换器注册在Web应用中，Struts2框架才可以正常使用该类型转换器。 

关于类型转换器的注册方式，主要有3中： 

A、注册局部类型转换器：仅仅对某个Action的属性起作用。 

B、注册全局类型转换器：对所有Action的特定类型的属性都会生效。 

C、使用JDK1.5的注释来注册类型转换器：通过注释方式来生成类型转换器。 

2）局部类型转换器 

    提供如下格式的文件 

文件名：  ActionName-conversion.properties  

内容：多个propertyName（属性名）=类型转换器类（含包名）,如  date=com.aumy.DateConverter 

存放位置：和ActionName类相同路径。 

3）全局类型转换器 

    提供如下格式的文件 

文件名：  xwork-conversion.properties 

内容：   多个“复合类型＝对应类型转换器”项组成，如  java.Util.Date=com.aumy.DateConverter 

存放位置：WEB-INF/classes/目录下。 

应用示例

先看几个实体类

 User.java

package com.javacrazyer.domain; import java.util.Date; public class User { private Integer id; private String loginname; private Double score; private Character cha; private Date birthday; private Gender gender; public User(){} public User(Integer id, String loginname, Double score, Gender gender, Character cha, Date birthday) { this.id = id; this.loginname = loginname; this.score = score; this.gender = gender; this.cha = cha; this.birthday = birthday; } public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getLoginname() { return loginname; } public void setLoginname(String loginname) { this.loginname = loginname; } public Double getScore() { return score; } public void setScore(Double score) { this.score = score; } public Gender getGender() { return gender; } public void setGender(Gender gender) { this.gender = gender; } public Character getCha() { return cha; } public void setCha(Character cha) { this.cha = cha; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public String toString() { return "User [birthday=" + birthday + ", cha=" + cha + ", gender=" + gender + ", id=" + id + ", loginname=" + loginname + ", score=" + score+ "]"; } }

 Gender.java

package com.javacrazyer.domain; public enum Gender { M,F; }

 Tel.java

package com.javacrazyer.domain; public class Tel { private String areaCode; private String phoneCode; public String getAreaCode() { return areaCode; } public void setAreaCode(String areaCode) { this.areaCode = areaCode; } public String getPhoneCode() { return phoneCode; } public void setPhoneCode(String phoneCode) { this.phoneCode = phoneCode; } }

 

看看自定义Tel类型的转换器

package com.javacrazyer.converter; import java.util.Map; import org.apache.struts2.util.StrutsTypeConverter; import com.javacrazyer.domain.Tel; public class TelConverter extends StrutsTypeConverter { //把String转换成Tel类型 //context：OGNL上下文的Map对象 //values ：需要转换的字符串数组 //toClass：要转换的目标类型 @Override public Object convertFromString(Map context, String[] values, Class toClass) { if(toClass == Tel.class){ String str = values[0]; String[] strArr = str.split("-"); Tel tel = new Tel(); tel.setAreaCode(strArr[0]); tel.setPhoneCode(strArr[1]); return tel; } return null; } //把Tel类型转换成String类型 //context：OGNL上下文的Map对象 //o：需要转换的对象 @Override public String convertToString(Map context, Object o) { if(o instanceof Tel){ Tel tel = (Tel)o; return tel.getAreaCode() + "-" + tel.getPhoneCode(); } return null; } }

 

业务处理UserAction.java

package com.javacrazyer.web.action; import java.util.HashMap; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.Set; import java.util.Map.Entry; import com.javacrazyer.domain.Tel; import com.javacrazyer.domain.User; import com.opensymphony.xwork2.ActionSupport; /** * 使用注解来配置Action * */ public class UserAction extends ActionSupport { private static final long serialVersionUID = -2554018432709689579L; private User user; private List<String> list; private List<User> userList; private Set<User> userSet = new HashSet<User>(); private Map<String, String> map = new HashMap<String, String>(); private Tel tel; public String execute() throws Exception{ System.out.println(user); System.out.println(list); for(User user : userList){ System.out.println(user); } System.out.println("========================="); for(User user : userSet){ System.out.println(user); } for (Entry entry:map.entrySet()){ System.out.println(entry.getKey()+"=="+entry.getValue()); } System.out.println("区号：" + this.tel.getAreaCode()); System.out.println("电话号：" + this.tel.getPhoneCode()); return SUCCESS; } public User getUser() { return user; } public void setUser(User user) { this.user = user; } public List<String> getList() { return list; } public void setList(List<String> list) { this.list = list; } public List<User> getUserList() { return userList; } public void setUserList(List<User> userList) { this.userList = userList; } public Set<User> getUserSet() { return userSet; } public void setUserSet(Set<User> userSet) { this.userSet = userSet; } public Map<String, String> getMap() { return map; } public void setMap(Map<String, String> map) { this.map = map; } public Tel getTel() { return tel; } public void setTel(Tel tel) { this.tel = tel; } }

 局部类型转换器，与UserAction.java在同一目录

UserAction-conversion.properties

tel=com.javacrazyer.converter.TelConverter #集合属性－Set类型 Element_userSet=com.javacrazyer.domain.User #指定索引 KeyProperty_userSet=id #指定key类型 Key_map=java.lang.String #指定value类型 Element_map=java.lang.String

 全局类型转换器src/xwork-conversion.properties

com.qiujy.domain.Tel=com.javacrazyer.converter.TelConverter

 src/struts.xml

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN" "http://struts.apache.org/dtds/struts-2.1.7.dtd"> <struts> <!-- 请求参数的编码方式 --> <constant name="struts.i18n.encoding" value="UTF-8"/> <!-- 指定被struts2处理的请求后缀类型。多个用逗号隔开 --> <constant name="struts.action.extension" value="action,do,go,xkk"/> <!-- 当struts.xml改动后，是否重新加载。默认值为false(生产环境下使用),开发阶段最好打开 --> <constant name="struts.configuration.xml.reload" value="true"/> <!-- 是否使用struts的开发模式。开发模式会有更多的调试信息。默认值为false(生产环境下使用),开发阶段最好打开 --> <constant name="struts.devMode" value="false"/> <!-- 设置浏览器是否缓存静态内容。默认值为true(生产环境下使用),开发阶段最好关闭 --> <constant name="struts.serve.static.browserCache" value="false" /> <!-- 是否允许在OGNL表达式中调用静态方法，默认值为false --> <constant name="struts.ognl.allowStaticMethodAccess" value="true"/> <!-- 指定由spring负责action对象的创建 <constant name="struts.objectFactory" value="spring" /> --> <!-- 是否开启动态方法调用 --> <constant name="struts.enable.DynamicMethodInvocation" value="false"/> <package name="my" extends="struts-default" namespace="/"> <global-results> <result name="input">/error.jsp</result> </global-results> <action name="info" class="com.javacrazyer.web.action.UserAction"> <result name="success">/info.jsp</result> <result name="input">/error.jsp</result> </action> </package> </struts>

 converter.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>Struts2中的转换器</title> </head> <body> <h3>Struts2中的转换器</h3><hr/> <form action="info.action" method="post"> <table> <tr> <td>登录名</td> <td><input type="text" name="user.loginname"/></td> </tr> <tr> <td>生日</td> <td><input type="text" name="user.birthday"/></td> </tr> <tr> <td>性别</td> <!--OGNL表达式：user属性的gender属性[由于是日期类型，程序中自定义有日期转换器]写法 --> <td><input type="radio" name="user.gender" value="M" checked="checked"/>男<input type="radio" name="user.gender" value="F"/>女</td> </tr> <tr> <td>考试成绩</td> <td><input type="text" name="user.score"/></td> </tr> <tr> <td colspan="2"><input type="submit" value=" 提交 "/></td> </tr> </table> <!--OGNL表达式：元素类型为String类型的List的写法 --> <input type="hidden" name="list[0]" value="张三"/> <input type="hidden" name="list[1]" value="李四"/> <input type="hidden" name="list[2]" value="王五"/> <!--OGNL表达式：元素类型为user类型的LIST属性的写法 --> <input type="hidden" name="userList[0].loginname" value="张三"/> <input type="hidden" name="userList[1].loginname" value="李"/> <input type="hidden" name="userList[2].loginname" value="王"/> <!--OGNL表达式：元素类型为user类型的set属性的写法 --> <input type="hidden" name="userSet.makeNew[0].loginname" value="xxx"/> <input type="hidden" name="userSet.makeNew[1].loginname" value="yyy"/> <input type="hidden" name="userSet.makeNew[2].loginname" value="ggg"/> <!--OGNL表达式：map属性的写法 --> <input type="hidden" name="map['jolin']" value="caiyilin"/> <input type="hidden" name="map['jay']" value="zhoujielun"/> <!--OGNL表达式：Tel属性的写法 --> <input type="hidden" name="tel" value="010-66298878"/> </form> </body> </html>

 info.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>显示提交的数据</title> </head> <body> <h3>显示提交的数据</h3><hr/> <table> <tr> <td>登录名</td> <td><s:property value="user.loginname"/> </td> </tr> <tr> <td>生日</td> <td><s:date name="user.birthday" format="yyyy-MM-dd HH:mm:ss"/></td> </tr> <tr> <td>性别</td> <td><s:property value="user.gender"/> </td> </tr> <tr> <td>考试成绩</td> <td><s:property value="user.score"/></td> </tr> <tr> <td>电话号</td> <td><s:property value="tel"/></td> </tr> <tr> <td colspan="2"><input type="button" value=" 返回 " onclick="history.go(-1);" /></td> </tr> </table> <hr/><s:debug/> </body> </html>

 error.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>出现内部错误</title> </head> <body> <h3>出现内部错误</h3><hr/> <s:actionerror/> </body> </html>

 

总结

Struts2中的类型转换器

   1) Struts2中内置了一些常用的类型转换器 ：可以把客户端提交的String数据转换成对应类型的数据。

     a) 基本类型

     b) java.util.Date：

     c) 数组和列表

   2) 自定义类型转换器:  

     a) 继承自org.apache.struts2.util.StrutsTypeConverter类

  public abstract Object convertFromString(Map context, String[] values, Class toClass);

        context：OGNL上下文的Map对象

        values ：需要转换的字符串数组

        toClass：要转换的目标类型

  public abstract String convertToString(Map context, Object o);

         context：OGNL上下文的Map对象

         o：需要转换的对象

     b) 注册：以全局方式

                    在应用程序的classpath下创建一属性文件，名为：xwork-conversion.properties

                    文件内容：待转换类型的全限定名=类型转换器类的全限定名

  3) 转换Set:

     0) Action中的Set属性需要进行初始化：如：

        private Set<User> userSet = new HashSet<User>();

     a) 添加针对某个Action的转换器配置文件：ActionName-conversion.properties 如：

        UserAction-conversion.properties

        

     b) 在这个文件中添加：Action的Set属性的相关配置

        Element_属性名=Set中的元素类型的全限定名                 #指定Set中的元素类型

        KeyProperty_属性名=Set中的元素类型中的某个属性  #指定Set的索引字段

                   如下示例：

        Element_userSet=com.qiujy.domain.User

        KeyProperty_userSet=id

        

     c) JSP页面: <input type="text" name="Set属性名.makeNew[0].属性名"/>

                    如：<input type="text" name="userSet.makeNew[0].loginname"/>