一 转换器的介绍
在Web应用中,页面提交请求的参数都是字符串类型的。但是在以前的学习中,我们都是直接在Action中按照需要来定义属性的类型,比如private int age,也没有出错,照样运行啊,而且还能正确运行呢,这是怎么回事情呢?
这就是由Struts2的类型转换框架默默的帮助我们完成的功能,只要用户输入的数据能合理的转换为需要的属性的类型,Struts2的类型转换框架就会在execute方法执行之前,替我们将参数转换为合适的类型。
二,自定义转换器的实现方式
1. Struts2的类型转换器实际上是基于OGNL实现的,在OGNL项目中有一个ognl.TypeConverter接口,这个接口就是实现类型转换器必须实现的接口,实现类型转换器必须实现上面的TypeConverter,不过上面的接口里的方法过于复杂,所以OGNL项目还提供了一个该接口实现类:ognl.DefaultTypeConverter,通过继承该类实现自己类型转换器,需要实现该类的public Object convertValue(Map context, Object value, Class toType) 方法。
二 ConvertValue方法的说明
该方法完成类型转换,不过这种类型转换是双向的,当需要把字符串转化对象实例时,通过该方法实现,当把对象实例转换成字符串时也通过该方法实现。这种转换是通过toType参数类型是需要转换的目标类型。所以可以根据toType参数来判断转换方向。
ConvertValue方法参数和返回意义
l 第一个参数:context是类型转换环境的上下文
l 第二个参数:value是需要转换的参数,根据转换方向的不同value参数的值也是不一样的。
l 第三个参数:toType是转换后的目标类型
l 该方法的返回值是类型转换后的值。该值的类型也会随着转换的方向的改变而改变。由此可见转换的convertValue方法接受需要转换的值,需要转换的目标类型为参数,然后返回转换后的目标值
l Value为什么是一个字符串数组?
l 对于DefaultTypeConverter转换器而言,它必须考虑到最通用的情形,因此他把所有请求参数都视为字符串数组而不是字符串。相当于getParameterValues()获取的参数值
2.继承org.apache.struts2.util.StrutsTypeConverter,由于StrutsTypeConverter提供了更好的封装,所以建议大家在写转换器时通常采用继承StrutsTypeConverter方式来实现.
StrutsTypeConverter类实质上是DefaultTypeConverter的扩展
publicabstractclass StrutsTypeConverter extendsDefaultTypeConverter {} |
StrutsTypeConverter中的两个核心方法
publicabstract Object convertFromString(Map context, String[] values, Class toClass); publicabstract String convertToString(Map context, Object o); |
convertFromString方法用于从前台页面获取字符串,将字符串转化为对象
convertToString方法用于将对象以字符串的方式输出到页面
我们在写struts2自定义类型转换类的时候主要就是覆盖上面两个方法
三.类型转换器的分类
1 局部类型转换
1.1 普通Action中的类型转换
配置文件存放目录:Action同级目录;
配置文件名:Action名-conversion.properties文件
转换器:自定义转换器实现TypeConverter接口,可以直接继承StrutsTypeConverter来实现;
内容:Action属性名=转换器包路径
1.2 基于模型驱动的类型转换
配置文件存放目录:模型同级目录;
配置文件名:模型名-conversion.properties文件
转换器:自定义转换器实现TypeConverter接口,可以直接继承StrutsTypeConverter来实现;
内容:模型属性名=转换器包路径
2 全局类型转换
配置文件存放目录:项目根目录;
配置文件名:work-conversion.properties文件
转换器:自定义转换器实现TypeConverter接口,可以直接继承StrutsTypeConverter来实现;
内容:要转换的类型包路径=转换器包路径
注意:若在模型驱动情况下,即配置了Action的类型转换器又配置了对应模型的转换器,此时只会选择模型转换器;
四,举例:
在action中能使用如下的代码:
public class testconvert extends ActionSupport { private myUser user333; public myUser getUser333() { System.out.println("getuser333"); return user333; } public void setUser333(myUser user) { System.out.println("setuser333"); this.user333 = user; } @Override public String execute() throws Exception { System.out.println("username: " + user333.getUsername()); System.out.println("age: " + user333.getAge()); System.out.println("execute"); return SUCCESS; } }
DefaultTypeConverter实现
public class UserConverter extends DefaultTypeConverter { @Override public Object convertValue(Map context, Object value, Class toType) { System.out.println("convertValue"); if(myUser.class == toType) //从页面向后台对象转换 { //value是一个数组,因为它是根据表单中可能有多个元素的name属性是相同的,因此只要name属性为指定的表单元素的值都会被传输过来。 String[] str = (String[])value; //通常只会取第一个。 String firstValue = str[0]; System.out.println(firstValue); StringTokenizer st = new StringTokenizer(firstValue, ","); String username = st.nextToken(); int age =Integer.parseInt( st.nextToken()); myUser user = new myUser(); user.setUsername(username); user.setAge(age); return user; } else if(String.class == toType) //从后台对象向页面转换 { myUser user = (myUser)value; String username = user.getUsername(); int age = user.getAge(); String userInfo = "username: " + username + ", age: " + age; return userInfo; } return null; } }
接下来属性文件的命名,必须是按照固定格式的,action类名-conversion.properties,此例中命名为testconvert-conversion.properties,和action类在同一级目录下。如果要寻找某一个action中的某属性对应的转换类,必须按照这种文件名格式寻找对应的文件。属性文件中如下编码格式为:
- <form action=testconvert method="post">
- Please enter your name<br/>
- <input type="text" name="user333"/>
- <input type="submit" value="test"/>
- </form>
ublic class UserConverter2 extends StrutsTypeConverter { @Override public Object convertFromString(Map arg0, String[] arg1, Class arg2) { System.out.println("convertFromString"); //通常只会取第一个。 String firstValue = arg1[0]; System.out.println(firstValue); StringTokenizer st = new StringTokenizer(firstValue, ","); String username = st.nextToken(); int age =Integer.parseInt( st.nextToken()); myUser user = new myUser(); user.setUsername(username); user.setAge(age); return user; } @Override public String convertToString(Map arg0, Object arg1) { System.out.println("convertToString"); myUser user = (myUser)arg1; String username = user.getUsername(); int age = user.getAge(); String userInfo = "username: " + username + ", age: " + age; return userInfo; } }