概述
-
从一个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
,则错误消息会打印:错误的年龄 -
其错误消息其实是存在值栈栈顶的,举个例子,有一个
image.png 有一个age
字段非法输入,通过s:debug
标签我们就可以发现,其结构如下:
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字段
)的,就可以实现转换
网友评论