首页 > 代码库 > Struts2类型转换（二）-自定义类型转换器
Struts2类型转换（二）-自定义类型转换器
一、自定义类型转换器
1). 为什么需要自定义的类型转换器 ?
因为Struts不能自动完成字符串到引用类型的转换。
2). 如何定义类型转换器？
I. 开发类型转换器的类: 扩展 StrutsTypeConverter 类；
II. 配置类型转换器。
有两种配置方式
①. 基于字段的配置：
> 在字段所在的 Model(可能是 Action，也可能是一个JavaBean) 的包下， 新建一个 ModelClassName-conversion.properties 文件
> 在该文件中输入键值对: fieldName=类型转换器的全类名。（fieldName即带转换字段的名称）
> 两个相关结论：
·第一次使用该转换器时创建实例.
·类型转换器是单实例的！
②. 基于类型的配置:
> 在 src 下新建 xwork-conversion.properties文件
> 键入: 待转换的类型=类型转换器的全类名.
> 两个相关结论：
·在当前 Struts2 应用被加载时创建实例.
· 在这种情况下类型转换器被创建了两次，即不是单实例的（了解 ）
二、示例
1）基于字段的配置方式
修改“Struts2类型转换（一）”的JSP代码如下：（JSP页面的名称为index.jsp）
1 <s:form action="testConversion" theme="simple"> 2 Age: <s:textfield name="age" label="Age"></s:textfield> 3 ${fieldErrors.age[0]} 4 <s:fielderror fieldName="age"></s:fielderror> 5 <br><br> 6 7 Birth: <s:textfield name="birth"></s:textfield> 8 <s:fielderror fieldName="birth"></s:fielderror> 9 <br><br>10 <s:submit></s:submit>11 </s:form>
当Model为一个Action时，Java代码如下：
package com.atguigu.struts2.app;import java.util.Date;import com.opensymphony.xwork2.ActionSupport;public class ConversionAction extends ActionSupport{ private int age; private Date birth; public int getAge() { return age; } public void setAge(int age) { this.age = age; } public Date getBirth() { return birth; } public void setBirth(Date birth) { this.birth = birth; } public String execute(){ System.out.println("age: " + age); System.out.println("birth: " + birth); return "success"; } }
定义String与Date之间的类型转换器如下：
1 package com.atguigu.struts2.app.converters; 2 3 import java.text.DateFormat; 4 import java.text.ParseException; 5 import java.text.SimpleDateFormat; 6 import java.util.Date; 7 import java.util.Map; 8 9 import javax.servlet.ServletContext;10 11 import org.apache.struts2.ServletActionContext;12 import org.apache.struts2.util.StrutsTypeConverter;13 14 public class DateConverter extends StrutsTypeConverter {15 16 private DateFormat dateFormat;17 18 public DateConverter() {19 System.out.println("DateConverter‘s constructor...");20 21 //获取当前 WEB 应用的初始化参数 pattern22 /**23 * web.xml的根节点中添加有如下配置：24 * <context-param>25 * <param-name>pattern</param-name>26 * <param-value>yyyy-MM-dd HH:mm:ss</param-value>27 * </context-param>28 */29 ServletContext servletContext = ServletActionContext.getServletContext();30 System.out.println(servletContext); 31 String pattern = servletContext.getInitParameter("pattern");32 dateFormat = new SimpleDateFormat(pattern);33 }34 35 @Override36 public Object convertFromString(Map context, String[] values, Class toClass) {37 38 System.out.println("convertFromString...");39 40 if(toClass == Date.class){41 if(values != null && values.length > 0){42 String value = http://www.mamicode.com/values[0];43 try {44 return dateFormat.parseObject(value);45 } catch (ParseException e) {46 e.printStackTrace();47 }48 }49 }50 51 //若没有转换成功, 则返回 values52 return values;53 }54 55 @Override56 public String convertToString(Map context, Object o) {57 58 System.out.println("convertToString...");59 60 if(o instanceof Date){61 Date date = (Date) o;62 return dateFormat.format(date);63 }64 65 //若转换失败返回 null66 return null;67 }68 69 }
对应的配置文件名称为：ConversionAction-conversion.properties，配置内容如下：
birth=com.atguigu.struts2.app.converters.DateConverter
当Model为一个JavaBean时，Java代码如下：
1 //JavaBean为Customer 2 package com.atguigu.struts2.model; 3 4 import java.util.Date; 5 6 public class Customer { 7 8 private int age; 9 10 public void setAge(int age) {11 this.age = age;12 }13 14 public int getAge() {15 return age;16 }17 18 private Date birth;19 20 public void setBirth(Date birth) {21 this.birth = birth;22 }23 24 public Date getBirth() {25 return birth;26 }27 28 @Override29 public String toString() {30 return "Customer [age=" + age + ", birth=" + birth + "]";31 }32 33 }34 35 //Action代码，Action实现了ModelDriven接口36 package com.atguigu.struts2.app;37 38 import com.atguigu.struts2.model.Customer;39 import com.opensymphony.xwork2.ActionSupport;40 import com.opensymphony.xwork2.ModelDriven;41 42 public class ConversionAction extends ActionSupport implements ModelDriven<Customer>{43 44 public String execute(){45 System.out.println("model: " + model);46 return "success";47 }48 49 private Customer model;50 51 @Override52 public Customer getModel() {53 model = new Customer();54 return model;55 }56 57 }
对应的配置文件名称为：Customer-conversion.properties，配置内容如下：
birth=com.atguigu.struts2.app.converters.DateConverter
struts.xml中的基本配置如下：
<action name="testConversion" class="com.atguigu.struts2.app.ConversionAction"> <result>/success.jsp</result> <result name="input">/index.jsp</result></action>
通过以上代码即可完成字符串与Date类型之间的类型转换工作。
2）基于类型的配置方式
在基于类型的配置方式中，JSP页面代码与Action的代码都与基于字段的配置方式的代码相同，但是在类型转换器的代码有所不同：
1 package com.atguigu.struts2.app.converters; 2 3 import java.text.DateFormat; 4 import java.text.ParseException; 5 import java.text.SimpleDateFormat; 6 import java.util.Date; 7 import java.util.Map; 8 9 import javax.servlet.ServletContext;10 11 import org.apache.struts2.ServletActionContext;12 import org.apache.struts2.util.StrutsTypeConverter;13 14 public class DateConverter extends StrutsTypeConverter {15 16 private DateFormat dateFormat;17 18 public DateConverter() {19 System.out.println("DateConverter‘s constructor...");20 }21 22 public DateFormat getDateFormat(){23 if(dateFormat == null){24 //获取当前 WEB 应用的初始化参数 pattern25 /**26 * web.xml的根节点中添加如下配置：27 * <context-param>28 * <param-name>pattern</param-name>29 * <param-value>yyyy-MM-dd HH:mm:ss</param-value>30 * </context-param>31 */32 ServletContext servletContext = ServletActionContext.getServletContext();33 System.out.println(servletContext); 34 String pattern = servletContext.getInitParameter("pattern");35 dateFormat = new SimpleDateFormat(pattern);36 }37 38 return dateFormat;39 }40 41 @Override42 public Object convertFromString(Map context, String[] values, Class toClass) {43 44 System.out.println("convertFromString...");45 46 if(toClass == Date.class){47 if(values != null && values.length > 0){48 String value = http://www.mamicode.com/values[0];49 try {50 return getDateFormat().parseObject(value);51 } catch (ParseException e) {52 e.printStackTrace();53 }54 }55 }56 57 //若没有转换成功, 则返回 values58 return values;59 }60 61 @Override62 public String convertToString(Map context, Object o) {63 64 System.out.println("convertToString...");65 66 if(o instanceof Date){67 Date date = (Date) o;68 return getDateFormat().format(date);69 }70 71 //若转换失败返回 null72 return null;73 }74 75 }
★★★★★注意：关于两种配置方法情况下类型转换器创建时机不同引出的问题
在基于字段配置的方式下，类型转换器的创建时机是在第一次使用该类型转换器的时候，因此对于dateFormat的初始化工作可以在其构造方法中完成，而在基于类型的配置方式下，类型转换器是在Struts2应用被加载时创建的，由于这时ServletContext对象还未被装载到ServletActionContext中，因此获取到的servletContext对象为null，就不能在类型转换器的构造方法中对dateFormat进行初始化，因此要在使用时判断dateFormat是否为null，然后在执行操作。
基于类型配置方式的配置文件名称为：xwork-conversion.properties，配置内容如下：
java.util.Date=com.atguigu.struts2.app.converters.DateConverter
三、关于示例的说明
以上示例中对于字符串与java.util.Date类型之间的转换，在教程中所演示时无论在页面输入日期格式为“yyyy-MM-dd HH:mm:ss”，还是"yyyy/MM/dd HH:mm:ss"，不使用类型转换器Struts2框架都无法正常进行转换，而自己在进行测试的时候，只要按照中文语言环境下的格式输入日期“yyyy-MM-dd”或"yyyy-MM-dd HH:mm:ss"都可以正常执行，而不需要使用类型转换器。
在网上查找后网友给出的相关解释及解决方法如下：
1）Struts2中转换Date类型的问题：http://polaris.blog.51cto.com/1146394/315403/
2）网友给出另一个解决方法：在struts.xml中定义参数：<constant name="struts.locale" value="http://www.mamicode.com/zh_CN" />
注：该Struts2学习教程来自尚硅谷-佟刚-Struts2教程，感谢尚硅谷及佟刚老师的分享。