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

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 对象如下 ,用来封装表单信息.

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

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

	@Override
	public String execute() throws Exception
	{
		return "success";
	}
}

3.实现自定义类型转换器 ,我们自己写一个转换类PointConverter

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放再同一文件夹

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

2) 注册全局类型转换器 .

#本文件名是 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 :

点对象point:<s:property value="point"/><br>

三,自定义类型的转换(方法二): 这种简单,不须要自己写类型转换器,不用写转换器注册文件* -conversion.properties .

1 表单是这样地: 第一个文本框是X坐标,第二个文本框是Y坐标, 与方法二中一个文本输入x,y不同了.

	<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 类

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

	@Override
	public String execute() throws Exception
	{
		return "success";
	}
}

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

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

4 结果页面 success.jsp :

点对象point:<s:property value="point3"/><br>

--------------------------------------------------------------------------------------------------------

类型转换错误的处理

conversionError拦截器被注册在默认的拦截器栈中, 也是在struts-default.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同名(扩展名不同) ,并放在同一文件 夹内

#局部资源文件 
#文件名为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 + 支持属性文件中文自动编码的插件(忘记名称了)