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

本文源代码下载地址:

　　http://flashview.ddvip.com/2009_03/struts2.rar

　　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>标签 :效果如下: