Struts2学习笔记 | 类型转换与自定义类型转换器
概述
-
从一个HTML表单到Action对象，类型转换是从字符串到非字符串。
-
把请求参数映射到action属性的工作由
Parameters拦截器负责，它是默认的defaultStack拦截器中的一员，Parameters拦截器可以自动完成字符串和基本数据类型之间转换。
关于类型转换错误
当类型转换失败时
-
若Action类没有实现
ValidationAware接口
Struts在遇到类型转换错误时仍会继续调用其Action方法，就好像什么都没发生一样 -
若Action类实现
ValidationAware接口
Struts在遇到类型转换错误时将不会调用其Action方法，Struts将检查相关action元素的声明是否包含着一个name=input的result。如果有，Struts将把控制权转交给那个result元素，如果没有，Struts将抛出一个异常。 -
所以一般情况下需要实现
ValidationAware接口，但是该接口有很多方法需要实现，而我们有时候不需要用到那么多方法，ActionSupport已经有该接口的实现了，所以我们可以通过继承ActionSupport来间接实现ValidationAware接口
类型转换错误消息的定制
-
作为默认的
default拦截器的一员，ConversionError拦截器负责添加与类型转换有关的出错信息与保存各请求参数的原始值，前提是Action类必须实现了ValidationAware接口。 -
如果字段标签使用的不是simple主题，则非法输入字段的话将会打印一条出错信息。但是有时候我们需要自己定义出错信息。所以需要覆盖出错信息。
-
覆盖默认的出错信息
在对应的Action类所在的包中新建ActionClassName.properties文件，ActionClassName即为包含着输入字段的Action类的类名。
在属性文件中添加如下键对invalid.fieldvalue.fieldName=xxx，注意，不能使用平时的字符。native2ascii命令可以进行编码转换。
例如设置为invalid.fieldvalue.age=\u9519\u8bef\u7684\u5e74\u9f84，则错误消息会打印：错误的年龄 -
其错误消息其实是存在值栈栈顶的，举个例子，有一个
age字段非法输入，通过s:debug标签我们就可以发现，其结构如下：
image.png
有一个fieldErrors字段存放着错误消息。
因此如果是simple主题的话，虽然不会自动的打印错误消息，但是我们也可以手动的显示错误消息：${fieldErrors.age[0]}。也可以使用<s:fielderror fieldName="错误字段名"></s:fielderror>，对于上述的例子是<s:fielderror fieldName="age"></s:fielderror>。 -
<s:fielderror></s:fielderror>标签显示错误消息的样式是在template.simple目录下的fielderror.ftl文件中定义的。我们要修改其显示样式时修改配置文件即可。可以在java代码目录下新建template.simple包，新建fielderror.ftl文件，然后进行替换。
定义类型转换器
Struts2不能自动完成字符串到引用类型的转换，有时候需要自己定义类型转换器。
-
自定义类型转换器必须实现
ongl.TypeConverter接口或对这个接口的某种实现进行扩展，一般是对StrutsTypeConverter类。 -
定义类型转换器的步骤
先开发类型转换器类，再配置类型转换器。
类型转换器有两种配置方式。
- 基于字段的配置
在字段所在的Model（可能是Action，可能是一个JavaBean）的包下，新建一个ModelClassName-converter.properties，然后在该文件中输入键值对：fieldName(待转换的字段名)=类型转换器的全类名。
类型转换器是单实例的。在第一次使用该转换器时创建实例。- 基于类型的配置
在src下新建xwork-conversion.properties文件，键入：待转换的类型=类型转换器的全类名。
在当前Struts2应用被加载时创建实例。
-
有一点值得注意
如果使用第二种配置方式，并且要在定义类型转换器时需要使用到web.xml文件中的配置参数，那么就不能在类型转换器的构造器中来初始化，应该提供一个方法来初始化，因为第二种方式类型转换器初始化的时候，ServletContext对象还没装配到ServletActionContext中，因此该对象为空，就获取不到配置参数。
关于两种配置方式的Demo
首先定义一个DateConverter类继承StrutsTypeConverter：
package struts.app2;
import org.apache.struts2.util.StrutsTypeConverter;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;
public class DateConverter extends StrutsTypeConverter {
private DateFormat dateFormat;
public DateConverter() {
dateFormat = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
}
@Override
public Object convertFromString(Map map, String[] strings, Class aClass) {
System.out.println("convertFromString");
if(aClass == Date.class){
if (strings != null && strings.length > 0){
String value = strings[0];
try {
return dateFormat.parseObject(value);
} catch (ParseException e) {
e.printStackTrace();
}
}
}
//若没有转换成功，则返回
return strings;
}
@Override
public String convertToString(Map map, Object o) {
System.out.println("convertToString");
if (o instanceof Date){
Date date = (Date) o;
return dateFormat.format(date);
}
return (String) o;
}
}
第一种配置方式：
然后在该类所在的包下新建ConversionAction-conversion.properties文件：
birth=struts.app2.DateConverter
第二种配置方式：
在src目录下新建xwork-conversion.properties文件，配置如下：
java.util.Date=struts.app2.DateConverter
类型转换与复杂属性配合使用
这里的复杂属性是指一个对象中套一个对象，例如有一个类Department，其成员变量有个manager，这个成员变量又是一个对象
public class Department {
private String deptName;
private Manager manager;
}
public class Manager {
private String name;
private Date birth;
}
在这两个类中，涉及到的类型有String和Date，我们在上面说到字符串和基本数据类型之间会自动转换。Date到字符串的转换我们也已经写了。那么在对于下面的代码会自动转换吗？
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<s:form action="testComplextProperty">
<!--映射属性的属性 -->
<s:textfield name="deptName" label="DeptName"></s:textfield>
<s:textfield name="manager.name" label="MgrName"></s:textfield>
<s:textfield name="manager.birth" label="MgrBirth"></s:textfield>
<s:submit></s:submit>
</s:form>
</body>
</html>
上面的代码中manager.name和manager.birth，就属于我们说的复杂属性。把其代码补充完整后去运行发现其可以转换。只要其最里面的属性支持自动转换(name字段)的或者是有自定义类型转换(birth字段)的，就可以实现转换
