Struts2学习笔记 | 类型转换与自定义类型转换器

概述

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

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

关于类型转换错误

当类型转换失败时

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

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

  • 所以一般情况下需要实现ValidationAware接口,但是该接口有很多方法需要实现,而我们有时候不需要用到那么多方法,ActionSupport已经有该接口的实现了,所以我们可以通过继承ActionSupport来间接实现ValidationAware接口

类型转换错误消息的定制

  • 作为默认的default拦截器的一员,ConversionError拦截器负责添加与类型转换有关的出错信息与保存各请求参数的原始值,前提是Action类必须实现了ValidationAware接口

  • 如果字段标签使用的不是simple主题,则非法输入字段的话将会打印一条出错信息。但是有时候我们需要自己定义出错信息。所以需要覆盖出错信息。

  • 覆盖默认的出错信息
    在对应的Action类所在的包中新建ActionClassName.properties文件,ActionClassName即为包含着输入字段的Action类的类名。
    在属性文件中添加如下键对invalid.fieldvalue.fieldName=xxx,注意,不能使用平时的字符。native2ascii命令可以进行编码转换。
    例如设置为invalid.fieldvalue.age=\u9519\u8bef\u7684\u5e74\u9f84,则错误消息会打印:错误的年龄

  • 其错误消息其实是存在值栈栈顶的,举个例子,有一个age字段非法输入,通过s:debug标签我们就可以发现,其结构如下:

    image.png
    有一个fieldErrors字段存放着错误消息。
    因此如果是simple主题的话,虽然不会自动的打印错误消息,但是我们也可以手动的显示错误消息:${fieldErrors.age[0]}。也可以使用<s:fielderror fieldName="错误字段名"></s:fielderror>,对于上述的例子是<s:fielderror fieldName="age"></s:fielderror>

  • <s:fielderror></s:fielderror>标签显示错误消息的样式是在template.simple目录下的fielderror.ftl文件中定义的。我们要修改其显示样式时修改配置文件即可。可以在java代码目录下新建template.simple包,新建fielderror.ftl文件,然后进行替换。

定义类型转换器

Struts2不能自动完成字符串到引用类型的转换,有时候需要自己定义类型转换器。

  • 自定义类型转换器必须实现ongl.TypeConverter接口或对这个接口的某种实现进行扩展,一般是对StrutsTypeConverter类。

  • 定义类型转换器的步骤
    先开发类型转换器类,再配置类型转换器。

类型转换器有两种配置方式

  • 基于字段的配置
    在字段所在的Model(可能是Action,可能是一个JavaBean)的包下,新建一个ModelClassName-converter.properties,然后在该文件中输入键值对:fieldName(待转换的字段名)=类型转换器的全类名
    类型转换器是单实例的。在第一次使用该转换器时创建实例。
  • 基于类型的配置
    在src下新建xwork-conversion.properties文件,键入:待转换的类型=类型转换器的全类名
    在当前Struts2应用被加载时创建实例。
  • 有一点值得注意
    如果使用第二种配置方式,并且要在定义类型转换器时需要使用到web.xml文件中的配置参数,那么就不能在类型转换器的构造器中来初始化,应该提供一个方法来初始化,因为第二种方式类型转换器初始化的时候,ServletContext对象还没装配到ServletActionContext中,因此该对象为空,就获取不到配置参数。

关于两种配置方式的Demo
首先定义一个DateConverter类继承StrutsTypeConverter

package struts.app2;

import org.apache.struts2.util.StrutsTypeConverter;

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

public class DateConverter extends StrutsTypeConverter {
    private DateFormat dateFormat;

    public DateConverter() {

        dateFormat = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
    }

    @Override
    public Object convertFromString(Map map, String[] strings, Class aClass) {
        System.out.println("convertFromString");
        if(aClass == Date.class){
            if (strings != null && strings.length > 0){
                String value = strings[0];
                try {
                    return dateFormat.parseObject(value);
                } catch (ParseException e) {
                    e.printStackTrace();
                }
            }
        }
        //若没有转换成功,则返回
        return strings;
    }

    @Override
    public String convertToString(Map map, Object o) {
        System.out.println("convertToString");
        if (o instanceof Date){
            Date date = (Date) o;
            return dateFormat.format(date);
        }
        return (String) o;
    }
}

第一种配置方式:

然后在该类所在的包下新建ConversionAction-conversion.properties文件:

birth=struts.app2.DateConverter

第二种配置方式:
src目录下新建xwork-conversion.properties文件,配置如下:

java.util.Date=struts.app2.DateConverter

类型转换与复杂属性配合使用

这里的复杂属性是指一个对象中套一个对象,例如有一个类Department,其成员变量有个manager,这个成员变量又是一个对象

public class Department {
    private String deptName;
    private Manager manager;
}
public class Manager {
    private String name;
    private Date birth;
}

在这两个类中,涉及到的类型有StringDate,我们在上面说到字符串和基本数据类型之间会自动转换。Date到字符串的转换我们也已经写了。那么在对于下面的代码会自动转换吗?

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <s:form action="testComplextProperty">
        <!--映射属性的属性 -->
        <s:textfield name="deptName" label="DeptName"></s:textfield>
        <s:textfield name="manager.name" label="MgrName"></s:textfield>
        <s:textfield name="manager.birth" label="MgrBirth"></s:textfield>
        <s:submit></s:submit>
    </s:form>
</body>
</html>

上面的代码中manager.namemanager.birth,就属于我们说的复杂属性。把其代码补充完整后去运行发现其可以转换。只要其最里面的属性支持自动转换(name字段)的或者是有自定义类型转换(birth字段)的,就可以实现转换

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351