Struts2学习笔记(七)——类型转换

1、自动类型转换

Struts2内部提供大量类型转换器,用来完成数据类型转换问题:

  • String和boolean、Boolean:完成字符串与布尔值之间的转换
  • String和char、Character:往常字符串与字符之间的转换
  • String和int、Integer:完成字符串与整型之间的转换
  • String和long、Long:完成字符串与长整型值之间的转换
  • String和double、Double:完成字符串与双精度浮点值的转换
  • String和float、Float:完成字符串和单精度浮点之间的转换
  • String和Date:完成字符串和日期类型之间的转换,可以接收yyyy-MM-dd格式字符串
  • String和数组:可以将多个同名参数,转换到数组中
  • String和Map、List:支持将数据保存到List或者Map集合

自动类型转换例子:

表单信息:

 <form action="${pageContext.servletContext.contextPath}/converterAction.action">
name:<input type="text" name="name"><br>
password:<input type="password" name="password"><br>
age:<input type="text" name="age"><br>
birthday:<input type="text" name="birthday"><br>
hobby:<input name="hobby" type="checkbox" value="music">music
<input name="hobby" type="checkbox" value="movie">movie<br>
<input type="submit" value="提交">
</form>

Action类:

 public class ConverterAction extends ActionSupport {
private String name;
private String password;
private int age;
private Date birthday;
private String[] hobby; public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
public String[] getHobby() {
return hobby;
}
public void setHobby(String[] hobby) {
this.hobby = hobby;
} @Override
public String execute() throws Exception {
System.out.println("name: " + name);
System.out.println("password: " + password);
System.out.println("age: " + age);
System.out.println("birthday: " + birthday);
System.out.print("hobby: ");
for (int i = 0; i < hobby.length; i++) {
System.out.print(hobby[i]);
if (i != hobby.length - 1) {
System.out.print(", ");
}
}
return SUCCESS;
}
}

前台输入信息:

Struts2学习笔记(七)——类型转换

后台显示信息:

Struts2学习笔记(七)——类型转换

2、自定义类型转换

1)基于OGNL的类型转换器

  Struts2的类型转换器实际上是基于OGNL实现的,都需要实现一个TypeConverter接口,该接口位于ognl.jar包内。该接口定义了一个convertValue()方法,实现该接口的类型转换器实现类都需要重写该方法来进行类型转换。

 public Object convertValue(Map<String, Object> context, Object target, Member member, String propertyName, Object value, Class toType);

  由于TypeConverter接口的convertValue()方法过于复杂,OGNL还提供了一个实现TypeConverter接口的类DefaultTypeConverter,开发者只要继承该类,就可以开发类型转换器的实现类。DefaultTypeConverter类的子类需要重写convertValue()方法,来实现字符串类型与复合类型之间的双向转换,convertValue()方法有三个参数:Map context:该参数为类型转换环境的上下文内容;Object value:该参数为需要转换的参数,是一个字符串数组;Class toType:该参数指的是转换目标的类型。

  在Struts2中并没有直接使用ognl.DefaultTypeConverter实现类,甚至都没有使用ognl.TypeConverter接口,而是自己定义了一个与ognl.TypeConverter接口一样的TypeConverter接口,该接口位于com.opensymphony.xwork2.conversion包下,其名称和接口函数定义完全相同。Struts2自行定义TypeConverter接口的目的在于对外屏蔽类型转换的实现细节,从而能够将Struts2对TypeConverter的扩展实现纳入到Struts2的容器中进行管理,从而方便对OGNL原始的TypeConverter接口进行扩展并支持更加广泛的类型转换逻辑。

  在Struts2的com.opensymphony.xwork2.conversion包下DefaultTypeConverter实现类有3个convertValue方法:

Struts2学习笔记(七)——类型转换

所以我们在继承com.opensymphony.xwork2.conversion包下DefaultTypeConverter实现类的时候可以直接重写convertValue(Object value, Class toType)方法即可。

无论是继承ongl包下的DefaultTypeConverter还是继承com.opensymphony.xwork2.conversion包下DefaultTypeConverter,在自定义类型转换的时候,实现方式都一样。

2)基于Struts2的类型转换器

  Struts2框架提供了一个类型转换器的StrutsTypeConverter抽象类,可以继承该类来开发自定义的类型转换器实现类。 该抽象类实际上继承了DefaultTypeConverter类,在该类的基础上进行了简化。StrutsTypeConverter类中提供了两个抽象方法,分别实现"form字符串参数-Struts复合类型"之间的双向转换。

3、注册类型转换器

在Struts2框架中使用自定义类型转换器需要注册,这样Struts2框架在处理用户请求的时候才知道使用哪个类型转换器进行转换。Struts2有两种方式注册类型转换器:

1)注册局部类型转换器

  局部类型转换器仅仅对某个Action的属性其作用,注册局部类型转换器需要建立一个命名规则为ActionName-conversion.properties的属性文件,该属性文件保存在与Action类文件相同的目录下。ActionName就是使用类型转换器的Action类的类名,而-conversion.properties是固定的格式。该文件是一个标准的属性文件,内容为标准的Key-Value格式,该键值对定义如下:

 <!--propertyName为要进行转换的属性名-->
propertyName=类型转换器

Struts2学习笔记(七)——类型转换

如果在model中有两个类User和Product,它们都有Date类型属性,都需要在页面上输入,但是它们格式不一样,例如:

  User birthday 格式:yyyy/MM/dd

  Product producttime 格式:yyyy-MM-dd

如果遇到这种情况,可以在model所在的包下创建注册的properties文件,名称的命名规则为modelname-conversion.properties,该属性文件的内容和上面的一样:

 <!--propertyName为要进行转换的属性名-->
propertyName=类型转换器

2)注册全局类型转换器

  全局类型转换器对所有Action的特定属性都会生效,注册一个全局类型转换器,需要建立一个xwork-conversion.properties属性文件,该文件需要保存在class路径的根目录下,如WEB-INF/classes。该文件的内容为"复合类型-对应的类型转换器",其中复合类型就是Action中需要进行类型转换的属性所属于的类型,对应的类型转换器就是转换该复合类型的对应转换器,比如要对Date类型的属性进行转换:

java.util.Date=com.sunny.converter.DateConverter

4、类型转换器的实现

在类型转换器的实现例子中自定义类型转换器继承的是DefaultTypeConverter,注册局部类型转换器。

表单信息:

 <form action="${pageContext.servletContext.contextPath}/converterAction.action">
name:<input type="text" name="name"><br>
password:<input type="password" name="password"><br>
age:<input type="text" name="age"><br>
birthday:<input type="text" name="birthday"><br>
hobby:<input name="hobby" type="checkbox" value="music">music
<input name="hobby" type="checkbox" value="movie">movie<br>
<input type="submit" value="提交">
</form>

自定义类型转换器类:

 public class DateConverter extends DefaultTypeConverter {
@Override
public Object convertValue(Object value, Class toType) {
if (value == null || toType == null) {
return false;
} if (toType != Date.class) {
return false;
} /*
* 对于DefaultTypeConverter转换器而言,它必须考虑到最通用的情形,
* 因此他把所有请求参数都视为字符串数组而不是字符串。
*/
if (value instanceof String[]) {
String str[] = (String[])value;
if (str[0] != null && str[0].length() > 0) {
SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd");
try {
//把请求参数转换成特定格式的date类
return sdf.parse(str[0]);
} catch (ParseException e) {
/*
* 在struts2框架里,自定义的类型转换器,
* 如果我们不手动抛出异常,struts2框架只捕获异常,但是并不抛出。
* 所以框架就会认为类型转换器转换成功,转向成功页面。
*/
throw new RuntimeException(e);
}
}
}
return new Date();
}
}

注册局部类型转换器,对Date类型的birthday进行转换,接收yyyy/MM/dd类型字符串:

Struts2学习笔记(七)——类型转换

 birthday=com.sunny.converter.DateConverter

Action类:

 public class ConverterAction extends ActionSupport {
private String name;
private String password;
private int age;
private Date birthday;
private String[] hobby; public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
public String[] getHobby() {
return hobby;
}
public void setHobby(String[] hobby) {
this.hobby = hobby;
} @Override
public String execute() throws Exception {
System.out.println("name: " + name);
System.out.println("password: " + password);
System.out.println("age: " + age);
System.out.println("birthday: " + birthday);
System.out.print("hobby: ");
for (int i = 0; i < hobby.length; i++) {
System.out.print(hobby[i]);
if (i != hobby.length - 1) {
System.out.print(", ");
}
}
return SUCCESS;
}
}

前台输入信息:

Struts2学习笔记(七)——类型转换

后台显示信息:

Struts2学习笔记(七)——类型转换

注意事项:

  • 在进行自定义类型转换时,如果转换错误,我们不手动抛出异常,struts2框架只捕获异常,并不抛出,框架就会认为转换成功,转向成功页面,所以一定要手动抛出异常。
  • 不管是自动类型转换还是自定义类型转换,如果类型转换错误,会跳转到input视图,如果在struts.xml文件中没有name值为"input"的<result>,会跳转到错误页面。

5、错误处理机制

Struts2的错误处理是由conversionError拦截器自动完成的,当发生类型转换错误时,conversionError拦截器拦截此错误并封装成fieldError,将此错误信息放入ActionContext中,并返回input逻辑视图,我们前面提到过此时必须在struts.xml文件中有name值为"input"的<result>,在jsp页面中可以使用<s:fielderror/>即可显示错误信息,默认显示的错误信息是在属性文件xwork-messages.properties中定义的:

 xwork.error.action.execution=Error during Action invocation
xwork.exception.missing-action=There is no Action mapped for action name {0}.
xwork.exception.missing-package-action=There is no Action mapped for namespace {0} and action name {1}.
xwork.default.invalid.fieldvalue=Invalid field value for field "{0}".

当birthday输入格式错误时,根据action中的<result name="input">/error.jsp</result>会跳转到error.jsp页面,

jsp页面信息:

 <body>
<s:fielderror fieldName="birthday"/>
</body>

jsp页面显示信息:

Struts2学习笔记(七)——类型转换

如果我们需要配置显示的错误信息,有方式有两种:
1)在国际化资源文件中配置
xwork.default.invalid.fieldvalue={0},错误;
在项目中建立一个国际化资源文件converter.properties,文件名可以随便,在文件中输入下面内容:
xwork.default.invalid.fieldvalue={0},错误;
然后,在struts.xml文件中配置<constant name="struts.custom.i18n.resources" value="com.sunny.action.converter" />
 <struts>
<constant name="struts.devMode" value="true" />
<constant name="struts.custom.i18n.resources" value="com.sunny.action.converter" />
<package name="default" namespace="/" extends="struts-default">
<action name="converterAction" class="com.sunny.action.ConverterAction">
<result>/success.jsp</result>
<result name="input">/error.jsp</result>
</action>
</package> </struts>

Struts2学习笔记(七)——类型转换

说明:资源文件的定义有好几种方式,会在国际化中讲到

如果birthday输入格式错误,显示如下:

Struts2学习笔记(七)——类型转换

2)配置Action特定属性错误信息
在Action所在包中,创建ActionName.properties,在文件中配置提示信息: invalid.fieldvalue.属性名= 错误信息,其中invalid.fieldvalue为固定格式
invalid.fieldvalue.birthday=日期类型转换错误,要求格式必须是yyyy/MM/dd;
显示效果:
Struts2学习笔记(七)——类型转换
这种配置方式的内容:invalid.fieldvalue.birthday=日期类型转换错误,要求格式必须是yyyy/MM/dd;也可以配置在国际化资源文件中,同样可以起作用。
注意:类型转换的Action在struts.xml中配置所在包需要extends="struts-default",因此在此文件中包含conversionError拦截器
上一篇:DevOps之服务手册


下一篇:python修炼第一天