一 转换器的介绍
在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;
- }
- }