Struts2入门---消息处理和类型转换

Struts2 在表单提交时,难免会出现数据格式与服务端不匹配的情况这时struts便会提示我们错误信息..

基本概述

  从一个 HTML 表单到一个 Action 对象, 类型转换是从字符串到非字符串.

  HTTP 没有 “类型” 的概念. 每一项表单输入只可能是一个字符串或一个字符串数组. 在服务器端, 必须把 String 转换为特定的数据类型

  在 struts2 中, 把请求参数映射到 action 属性的工作由 Parameters 拦截器负责, 它是默认的 defaultStack 拦截器中的一员. Parameters 拦截器可以自动完成字符串和基本数据类型之间转换.

如果类型转换失败

  若 Action 类没有实现 ValidationAware 接口： Struts 在遇到类型转换错误时仍会继续调用其 Action 方法, 就好像什么都没发生一样.

  若 Action 类实现 ValidationAware 接口：Struts 在遇到类型转换错误时将不会继续调用其 Action 方法: Struts 将检查相关 action 元素的声明是否包含着一个 name=input 的 result. 如果有, Struts 将把控制权转交给那个 result 元素; 若没有 input 结   果, Struts 将抛出一个异常

类型转换错误消息定制

问题1: 如何覆盖默认的错误信息?(默认的信息一般都不用,自定义提示信息)
1). 在对应的 Action 类所在的包中新建
　　ActionClassName.properties 文件, ActionClassName 即为包含着输入字段的 Action 的类名
2). 在属性文件中添加如下键值对: invalid.fieldvalue.fieldName=xxxx

问题2: 如果是 simple 主题, 还会显示错误消息吗? 如果不会显示, 怎么办?
1). 通过s:debug 标签, 可知转换出错, 则在值栈的 Action (实现了ValidationAware 接口) 对象中有一个 fieldErrors 属性.
　　该属性的类型为 Map<String,List<String>> 键 : 字段(属性名), 值: 错误消息组成的List.
　　所以可以使用EL 或者 OGNL 的方式来显示错误消息: ${fieldErrors.age[0] }
2). 还可以使用 s:fielderror 标签来显示. 可以通过 fieldName 属性来显示指定字段的错误消息.

问题3. 如果是 simple 主题, 且使用 <s:fielderror fieldName="age"></s:fielderror> 来显示错误消息, 则该消息在一个
　　ul, li ,span 中(不方便我们排版). 如何去除 ul, li, span 呢?
　　在 /template/simple/fielderror.ftl 里面 定义了 simple 主题下, s:fielderror 标签显示错误消息的样式.
　　所以修改该配置文件即可.在 src 下新建 template.simple 包, 新建 fielderror.ftl 这个文件, 把原生的内容复制进去,在去除不需要的部分即可.(ul,li,span标签)           　  这样可以覆盖原来的模板.

　　
定制类型转换器
问题4. 如何自定义类型转换器?
1). 为什么需要自定义类型转换器? 因为Struts2 不能自动完成字符串到引用类型的转换.
2). 如何定义类型转换器:
I. 开发类型转换器的类: 扩展 StrutsTypeConverter 类.

package com.struts.app.converters;

import java.util.Date;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Map;

import javax.servlet.ServletContext;

import org.apache.struts2.ServletActionContext;
import org.apache.struts2.util.StrutsTypeConverter;

public class DateConverter extends StrutsTypeConverter {

    private DateFormat dateFormat;
    public DateConverter() {
        System.out.println("DateConverter..");
    }
    public DateFormat getDateFormat() {
        //获取当前 web 应用的初始化参数 pattern
        ServletContext servletContext = ServletActionContext.getServletContext();
        String pattern = servletContext.getInitParameter("pattern");
        dateFormat = new SimpleDateFormat(pattern);
        return dateFormat;
    }
    @Override
    public Object convertFromString(Map context, String[] values, Class toClass) {
        System.out.println("convertFromString..");
        //如果转换器定义的类型是 Date 类型
        if(toClass == Date.class){
            if(values != null && values.length > 0){
                String value = values[0];
                try {
                    return getDateFormat().parseObject(value);
                } catch (ParseException e) {
                    e.printStackTrace();
                }
            }
        }
        //若转换没有成功, 则返回 values
        return values;
    }

    @Override
    public String convertToString(Map context, Object o) {
        System.out.println("convertToString..");
        //若 o 是 Date 类型的对象 就把 o的值赋给 date 并返回.
        if(o instanceof Date){
            Date date = (Date) o;
            return getDateFormat().format(date);
        }
        //若转换没有成功, 则返回 null
        return null;
    }

}

II. 配置类型转换器
有两种方式:
①. 基于字段的配置:(局部)
　　> 在字段所在的 Model(可能是Action 也可能是 Javabeen) 的包下, 新建 ModelClassName-converter.properties 文件
　　> 在该文件中输入键值对: fieldName=类型转换器的全类名.(brith = com.struts.app.converters.DateConverter)
　　> 第一次使用该转换器时 创建实例.
　　> 类型转换器是单实例的.
②. 基于类型的配置:(全局)
　　> 在src 下新建 xwork-converter.properties
　　> 键入: 待转换的类型=类型转换器的全类名.(java.util.Date = com.struts.app.converters.DateConverter)
　　> 在当前 Struts2 应用被加载时创建实例(2次).