Struts2类型转换(一)----常规类型,自定义类型,错误处理

来源：javaeye    作者：elf8848  


Struts2的类型转换是基于OGNL表达式的.有良好的扩展性.

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

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

　　一, 常规类型的转换:

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

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

　　二,自定义类型的转换(方法一): 　 这种方法用用来转换复杂对象

　　ONGL项目中有一个TypeConverter接口,是实现转换器必须实现的接口,这个接口有点复杂,所以OGNL还提供了该街接口的一个实现类ognl.DefaultTypeConverter , 通过继承该类重写convertValue方法 ,实现自定义类型的转换 .　

　　方法是这样的convertValue(final Map context, final Object value, final Class toType)

　　 第一个参数:context 是类型转换环境的上下文

　　 第二个参数 : value 是须要转换的参数,方向不同,value的类型也是不同的.

　　 第三个参数 : toType是转换后的目标类型,

　　 返回值是 : 转换后的目标类型, 方向不同,类型也是不同的.

　　Struts2自己有一个抽象类继承自 DefaultTypeConverter类,是StrutsTypeConverter .就是转换的两个分别对应两个抽象方法, 其实都一样,换汤不换药,百变不离其中.所以我们也可以继承 StrutsTypeConverter类.

下面做一个自定义类型转换的实例:

　　1. 表单是这样的: 　

输入一个用 豆号分隔的两个数字, 代表一个坐标点的X,Y值 .

　　2.Point 对象如下 ,用来封装表单信息.

　　Java代码　　


package ssh.org.util;
public class Point
{
private int x;
private int y;
}

　　Java代码　　　


public class LoginAction extends ActionSupport
{
private Point point;
set,get方法略...

@Override
public String execute() throws Exception
{
return "success";
}
}
　　3.实现自定义类型转换器 ,我们自己写一个转换类PointConverter

　　Java代码　　　


package ssh.org.util;

import java.util.Map;

import ognl.DefaultTypeConverter;

public class PointConverter extends DefaultTypeConverter
{

@Override
public Object convertValue(final Map context, final Object value, final Class toType)
{
if (Point.class == toType)  //从表单字符串转换为 Point对象
{
final Point point = new Point();
final String[] str = (String[]) value;
final String[] param = str[0].split(",");

final int x = Integer.parseInt(param[0]);
final int y = Integer.parseInt(param[1]);

point.setX(x);
point.setY(y);

return point;
}
if (String.class == toType) //从对象转换为字符串
{
final Point point = (Point) value;
final int x = point.getX();
final int y = point.getY();

final String result = "[x=" + x + ",y=" + y + "]";
return result;

}
return null;
}


4. 把上面的类型转换器PointConverter注册在struts2应用中,Struts2框架才可以正常使用该 转换器.

　　有3种方法,任选其中一种就行 .

　　 1)　 注册局部类型转换器 , 假定请求的LoginAction 来处理　 , 我们就要篇写　 LoginAction-conversion.properties文件 .本文件要与LoginAction.java放再同一文件夹 　　　　　　　

　　Properties代码　　


#本文件名是:LoginAction-conversion.properties
#注册局部的类型转换器的属性文件, 只针对指定名称的Action起作用
#文件名必须 是action类名 + -conversion.properties
#指定LoginAction的point属性由ssh.org.util.PointConverter类完成转换,point是成员属性,不是类
#本文件要与LoginAction.java放再同一文件夹
point=ssh.org.util.PointConverter
　　 　 2) 注册全局类型转换器 .　　　　　　　

　　Properties代码　　　


#本文件名是 xwork-conversion.properties
#注册全局的类型转换的属性文件 , 对所有有ssh.org.util.Point类型成员属性的Action都起作用
#文件名必须是 xwork-conversion.properties
#该文件放在classPath根路径,也就是src包下面,与struts.xml再一起
#指定ssh.org.util.Point类(带包名)   的类型类转换器为ssh.org.util.PointConverter
ssh.org.util.Point=ssh.org.util.PointConverter
　　 　 　 　 　 　 3) 使用JDK1.5的注解 来注册类型转换器,目前还无例子, 暂时略...

　　5 结果页面 success.jsp　　 :

　　Html代码　　　


点对象point:<s:property value="point"/><br>
　　三,自定义类型的转换(方法二): 这种简单,不须要自己写类型转换器,不用写转换器注册文件* -conversion.properties .

1 表单是这样地: 

　
　　 第一个文本框是X坐标,
第二个文本框是Y坐标,
与方法二中一个文本输入x,y不同了.

　　Html代码　　　


<form action="login.action" >
point3.x:<input type="text" name="point3.x"/>
point3.y:<input type="text" name="point3.y"/>
<input type="submit" value="提交"/>
</form>
login.action是class LoginAction类在struts.xml配置的name
　　2 LoginAction 类

　　Java代码　　　


public class LoginAction extends ActionSupport
{
private Point point3;
set,get方法略...

@Override
public String execute() throws Exception
{
return "success";
}
}
　　3 Point 对象如下 ,用来封装表单信息.

　　Java代码　　　


package ssh.org.util;
public class Point
{
private int x;
private int y;
}
　　4 结果页面 success.jsp　　 :

　　Html代码


点对象point:<s:property value="point3"/><br>
　　类型转换错误的处理　　

　　conversionError拦截器被注册在默认的拦截器栈中, 也是在struts-default.xml

　　Xml代码


<interceptor-stack name="defaultStack">
               <!--类型转换错误的拦截器 -->
                <interceptor-ref name="conversionError"/>
                <!--数据校验的拦截器 -->
                <interceptor-ref name="validation">
                    <param name="excludeMethods">input,back,cancel,browse</param>
                </interceptor-ref>
</interceptor-stack>
流程是:　

　　1　 转换出错

　　2　 被 conversionError拦截

　　3　 将错误信息放入ActionContext中

　　4　 读Action的局部资源文件 Action名称.properties　 取得单个字段(成员属性)的提示信息

　　5　 跳转到input逻辑视图,显示提示信息　 ,要struts.xml中 <result name="input">/login/login.jsp</result> 这要指定 input逻辑视图.

　　本例子,处理请求的action 名称为LoginAction.java.

　　LoginAction.properties 文件 必须与LoginAction.java同名(扩展名不同) ,并放在同一文件 夹内

　　Properties代码


#局部资源文件 #文件名为LoginAction.properties, #必须与LoginAction.java同名(扩展名不同) ,并放在一起 # invalid.fieldvalue.成员属性=提示信息 invalid.fieldvalue.point=输入坐标不正确 invalid.fieldvalue.point2=输入坐标不正确 invalid.fieldvalue.point3=输入坐标不正确 invalid.fieldvalue.birthday=生日不正确
　　结果1 　 下面的表单是用Struts2标签写的, 出错误时,会自动显示错信息:





　　结果2 　 下面的表单是用HTML标签写的, 显示错误信息要加<s:fielderror ></s:fielderror>标签 :效果如下:






　　附件中是总个工程文件 ,包括上面的演示代码, 由于jar包较少,打包后大小为2M,就全打包上传了. 开发环境 Eclipse 3.3 + 支持属性文件中文自动编码的插件(忘记名称了)