(十二)struts2的类型转换

所有的MVC框架,都属于表现层的解决方案,都需要负责收集用户请求参数,并将请求参数传给应用的控制器组件。

这时问题出现了,所有的请求参数都是字符串类型数据,因此MVC框架必须具备将这些字符串请求参数转换成相应的数据类型。

struts2提供了非常强大的类型转换机制,struts2的类型转换是基于OGNL表达式。

struts2提供了很好的扩展性,开发者可以开发出自己的类型转换器。完成字符串到自定义类型之间的转换。

如果类型转换中出现未知异常,开发者无须关心异常处理,struts2的conversionError拦截器会自动处理该异常,并且在页面上生成提示信息。

servlet中的类型转换

表单中提交的所有数据都是字符串类型

例如我们有一个User类,name为String类型,age为int类型,birthday为Date类型,我们必须在servlet中获取表单传入的参数,然后将其进行类型转换,然后封装到User对象中。

上述需要程序员自己进行类型转换操作,比较繁琐。

对于一个MVC框架而言,一样需要将请求参数封装成对象,也必须将请求参数转换成对象属性的数据类型,这就是类型转换的意义。

Struts2内建的类型转换器

struts内建的类型转换器能自动将我们的表单数据(字符串)转换成对应的数据类型。

完成字符串和日期类型之间的转换时,日期格式必须使用请求用户本地的格式。一般是yyyy-MM-dd,如果输入的日期格式不是本地的日期格式,例如我们输入1996/01/31,就会出现错误,类型转换失败。

自定义类型转换器

需求:

 

当我们在表单中输入的日期格式不是本地的格式时,就会出现类型转换错误,我们也经常需要将字符串转换成其他的格式,例如字符串转换成对象之类的操作,这时我们就需要自定义类型转换器。 

    struts2的类型转换器实际上是基于OGNL实现的。xwork集成了OGNL。 

    实现类型转换器必须实现TypeConverter接口。这个接口的方法太过复杂,所以还提供了一个该接口的实现类DefaultTypeConverter。 

    我们重写DefaultTypeConverter类的convertValue方法即可。 

    我们基于DefaultTypeConverter类实现类型转换器时,将字符串转换成我们需要的类型通过convertValue方法实现,将我们的类型转换成字符串也是通过convertValue方法实现,因此我们必须判断转换的类型来实现不同的逻辑。 

    为了简化类型转换器的实现,struts2提供了一个StrutsTypeConverter抽象类,这个类是DefaultTypeConverter类的子类。

    我们看下这个类的源码 :

 

  

 继承DefaultTypeConverter
public abstract class StrutsTypeConverter extends DefaultTypeConverter { 

        //重写DefaultTypeConverter类的convertValue方法
        public Object convertValue(Map context, Object o, Class toClass) { 
            //如果要转换的类型是字符串类型,也就是把我们的类型转换成字符串,调用convertToString方法
            if (toClass.equals(String.class)) {
                return convertToString(context, o);
            }
            //如果参数是字符串数组,也就是将字符串转换成我们需要的类型,调用convertFromString方法        
            else if (o instanceof String[]) {
                return convertFromString(context, (String[]) o, toClass);
            } 
            //如果参数是字符串,也就是将字符串转换成我们需要的类型,调用convertFromString方法
            else if (o instanceof String) {
                return convertFromString(context, new String[]{(String) o}, toClass);
            } else {
                return performFallbackConversion(context, o, toClass);
            }
        }


        protected Object performFallbackConversion(Map context, Object o, Class toClass) {
            return super.convertValue(context, o, toClass);
        }

        //将字符串转换成我们需要的类型的方法
        public abstract Object convertFromString(Map context, String[] values, Class toClass);

        //将我们的类型转换成字符串的方法
        public abstract String convertToString(Map context, Object o);
    } 

            三个参数 :
                    Map context:OGNL的上下文。暂时还没学,后面会学到,暂时不用管。
                    value:需要转换的参数。
                    toClass:转换后的类型

 

例子:

需求:我们将我们前面的注册案例中的生日改成 yyyy/MM/dd类型

(1)创建自定义类型转换器

 public class MyConverter extends StrutsTypeConverter { 
                    //日期转换器,转换成指定的类型
                    private DateFormat format=new SimpleDateFormat("yyyy/MM/dd");

                    //将字符串转换成日期类型
                    public Object convertFromString(Map context, String[] values, Class toClass) { 
                        //判断参数是否为空
                        if(values==null||values.length==0){
                            return null;
                        } 
                        //我们只有一个参数,就是表单的birthday
                        String date=values[0]; 
                        //判断目标类型是否是Date
                        if(toClass==java.util.Date.class){
                            try { 
                                //进行转换
                                return format.parse(date);
                            } catch (ParseException e) {
                                e.printStackTrace();
                            }
                        }
                        return null;    
                    }


                    //将日期类型转换成字符串
                    public String convertToString(Map context, Object o) { 
                        //判断当前参数是否是日期类型
                        if(o instanceof java.util.Date){
                            return format.format(o);
                        }
                        return null;
                    }

                }

(2)注册类型转换器

局部类型转换器
        按照属性来注册
        如果属性都在action中,那么应该创建一个文件 Action名字-conversion.properties ,例如LoginAction-conversion.properties 
        如果属性放到了javaBean中,那么创建一个文件 javaBean名称-conversion.properties 例如  User-conversion.properties

        文件由键值对组成。
        键为需要转换的属性名字,值为自己实现的类型转换器全类名。

        我们创建 User-conversion.properties 

        内容 birthday=com.cad.web.convert.MyConverter 

        这时我们注册时使用 1996/01/24这种格式进行注册就不会出现类型转换错误。
        用户提交请求时,请求中的birthday参数会先被该类型转换器处理。

全局类型转换器
        所有的Action都能用。我们需要在src目录下创建一个 xwork-conversion.properties 的文件

        因为是全局的,就不存在只对birthday这个属性进行转换。
        这里的键是要转换的类型,值还是类型转换器类。

        我们创建 xwork-conversion.properties 
        内容 java.util.Date=com.cad.web.convert.MyConverter 
        这样当我们输入日期的表单时,就可以使用我们自定义的日期格式。 

  

类型转换中的错误处理

struts2提供了一个名为conversionError的拦截器,这个拦截器被注册在默认拦截器栈中。

当类型转换器执行类型转换出现错误时,该拦截器负责将对应错误封装成表单域错误(fieldError),并将错误信息放入ActionContext中。

当拦截器对转换异常进行处理后,系统会跳转到名为input的逻辑视图。

 

 我们在struts.xml中配置 <result name="input">/regist.jsp</result> 
            当类型转换失败后,再跳转到注册页面

            跳转到input视图以后,我们发现没有任何错误提示信息。我们前面讲过conversionError拦截器会将转换错误封装成fieldError,并放在ActionContext中。
            为了在页面中输出错误信息,我们需要使用struts的标签。我们先使用一些,后面会详细介绍。

            我们在页面添加<s:fielderror></s:fielderror>标签
            当我们类型转换失败后,就会输出错误信息。

            我们发现输出的错误信息是英文的,我们希望能变为中文的提示信息。

            我们只需要在创建一个properties文件  文件名为  javabean名称.properties  

            键为invalid.fieldvalue.属性名称  例如 :invalid.fieldvalue.birthday 
            值为要输出的内容 例如 invalid.fieldvalue.birthday=生日格式不正确  

  

 

 

posted @ 2018-08-09 14:46  跃小云  阅读(184)  评论(0编辑  收藏  举报