你的位置:首页 > Java教程

[Java教程]请求参数到表述层的类型转换——Struts2

一、简介

说明:HTTP 协议传输数据没有类型的概念,在服务器端是通过 request.getParameter()、request.getParameterValue() 方法得到请求参数为 String 或 String[] 类型。

但是这样使用起来不方便,我们希望开源框架能自动的完成类型转换,到使用的时候能直接获取目标类型。

二、Struts2 类型转换

1. Struts2 本身完成了字符串类型到基本数据类型的自动转换,其他情况需要我们定义自己的类型转换器。

2.类型转换失败时的处理方式

(1) 默认情况下 Struts2 对于类型转换失败后是不做任何处理的。

(2) 若请求参数到目标基本类型转化出错时,会对目标基本类型赋值为默认值。

(3) 若请求参数到目标基本类型包装类转化出错时,会对目标字段赋值为 null。

(4) 若希望在发生错误时给出提示,则需要让目标 Action 类实现 com.opensymphony.xwork2.ValidationAware 接口,这个接口 ActionSupport 已经帮我们实现。

说明:com.opensymphony.xwork2.ValidationAware

包含了 ActionErrors 和 FieldErrors 两个级别的错误消息,实现了该接口的 Action 类,在类型转换出错时,会前往 name=input 的 result,若没有配置,则返回404。

在类型转换出错时,不会到目标方法,而是直接返回。对应的是一个拦截器。

(5) 在错误显示页面,可以从值栈的 Action 类中获取到错误消息,且此错误消息可以自定义。

自定义错误提示消息:在当前 Action 类所在的包下添加 ActionName.properties 的属性文件,然后在该属性文件中添加如下键值对:

invalid.fieldvalue.目标字段名=定制的错误提示消息

(6) 在值栈中,错误消息的数据结构为:Map<String, List<String>>,可以通过 OGNL 表达式的方式来获取,也可以通过 Struts2 标签来获取,如下:

<s:fielderror fieldName="errorFiledName"></s:fielderror>

3.自定义类型转换器

继承 StrutsTypeConverter 类,两个抽象方法

public Object convertFromString(Map context, String[] values, Class toClass) : context 可以看做是 Map 栈,values 代表传入的请求参数, toClass 代表要转换的目标类。

public String convertToString(Map context, Object o) : 将传入的 o 转换为字符串。

(1) 类级别的

同包下创建包含要转换的属性的类简单类名 + "-conversion.properties", 如:TypeConverterTestAction-conversion.properties,TypeConverterTestAction 类中包含一个 person 属性。

在创建的类型转换资源文件中添加:要转换的属性=类型转换器全类名,如: person=com.nucsoft.struts2.convert.MyTypeConverter

(2) 全局级别的

在类路径的根目录下创建:xwork-conversion.properties 属性文件

内容:需要转换的类的全类名=类型转换器的全类名,如:com.nucsoft.struts2.helloworld.Person=com.nucsoft.struts2.convert.MyTypeConverter

自定义类型转换出错的处理方式也和之前一样。

4.复杂类型数据的类型转换

(1)目标 Action 不实现 ModelDriven 接口,也就是说栈顶对象是当前 Action 类的情况

[1]单独的一个复杂对象,表单标签与对象属性对应:person

<s:form action="converter/typeConverter" method="post">    <s:textfield name="person.userName" label="userName"/>    <s:textfield name="person.age" label="age"/>    <s:submit value="submit"/></s:form>

(2) 目标 Action 实现 ModelDriven 接口,栈顶对象为 getModel 返回值类型。

[1] 单独一个复杂类型,对应多个标签

<s:form action="converter/typeConverter" method="post">    <s:textfield name="userName" label="person"/>    <s:textfield name="age" label="age"/>    <s:submit value="submit"/></s:form>

[2]单独的一个复杂对象,只有一个表单标签,按照指定格式进行转换为对应的复杂对象:

<s:form action="converter/typeConverter" method="post">    <s:textfield name="person" label="person"/>    <s:submit value="submit"/></s:form>

输入的格式:

AA,12

需要对目标 Action 自定义 person 类型转换器,或定义全局的类型转换器,如:

/** * @author solverpeng * @create 2016-07-09-11:00 */public class MyTypeConverter extends StrutsTypeConverter {  @Override  public Object convertFromString(Map context, String[] values, Class toClass) {    Person person = null;    if(Person.class == toClass)      try {        person = (Person) toClass.newInstance();        String strs = values[0];        person.setUserName(strs.split(",")[0]);        person.setAge(Integer.parseInt(strs.split(",")[1]));      } catch(InstantiationException e) {        e.printStackTrace();      } catch(IllegalAccessException e) {        e.printStackTrace();      }    return person;  }  @Override  public String convertToString(Map context, Object o) {    return null;  }}

MyTypeConverter

[3]复杂对象中包含另一个复杂对象,如 Person 中包含 Address。

对应多个标签:

<s:form action="converter/typeConverter" method="post">    <s:textfield name="userName" label="person"/>    <s:textfield name="age" label="age"/>    <s:textfield name="address.addressName" label="addressName"/>    <s:textfield name="address.location" label="location"/>    <s:submit value="submit"/></s:form>

三个标签,固定格式:address 用一个标签,固定格式 addressName,location

<s:form action="converter/typeConverter" method="post">    <s:textfield name="userName" label="userName"/>    <s:textfield name="age" label="age"/>    <s:textfield name="address" label="address"/>    <s:submit value="submit"/></s:form>

因为 Person 类中包含 Address 属性,所以在 Person 同包下新建 Person-conversion.properties 文件

内容:address=com.nucsoft.struts2.convert.MyTypeConverter

类型转换器:

/** * @author solverpeng * @create 2016-07-09-11:00 */public class MyTypeConverter extends StrutsTypeConverter {  @Override  public Object convertFromString(Map context, String[] values, Class toClass) {    if(Person.class == toClass) {      Person person = null;      try {        person = (Person) toClass.newInstance();        String strs = values[0];        person.setUserName(strs.split(",")[0]);        person.setAge(Integer.parseInt(strs.split(",")[1]));      } catch(InstantiationException e) {        e.printStackTrace();      } catch(IllegalAccessException e) {        e.printStackTrace();      }      return person;    }    if(Address.class == toClass) {      Address address = null;      try {        address = (Address) toClass.newInstance();        String strs = values[0];        address.setAddressName(strs.split(",")[0]);        address.setLocation(strs.split(",")[1]);      } catch(InstantiationException e) {        e.printStackTrace();      } catch(IllegalAccessException e) {        e.printStackTrace();      }      return address;    }    return null;  }  @Override  public String convertToString(Map context, Object o) {    return null;  }}

MyTypeConverter

5.集合元素对象中的类型转换

[1] 目标 Action 类包含 List 的复杂对象,如 List<Person>,其中 Address 进行类型转换时,还是使用 Person 转换器,且因为为 List<Person>,所以不需要实现 ModelDriven 接口,所以栈顶对象为 当前Action类对象。

<s:form action="converter/typeConverter" method="post">    <s:textfield name="persons[0].userName" label="userName[0]"/>    <s:textfield name="persons[0].age" label="age[0]"/>    <s:textfield name="persons[0].address" label="address[0]"/>    <s:textfield name="persons[1].userName" label="userName[1]"/>    <s:textfield name="persons[1].age" label="age[1]"/>    <s:textfield name="persons[1].address" label="address[1]"/>    <s:submit value="submit"/> </s:form>

[2] 只有一个复杂对象,但是该复杂对象包含 List 属性,如 Person 类存在 List<Address> 属性。因为只有一个复杂对象,所以实现 ModelDriven 接口

<s:form action="converter/typeConverter" method="post">    <s:textfield name="userName" label="userName"/>    <s:textfield name="age" label="age"/>    <s:textfield name="addresses[0].addressName" label="address[0].addressName" />    <s:textfield name="addresses[0].location" label="address[0].location" />    <s:textfield name="addresses[1].addressName" label="address[1].addressName" />    <s:textfield name="addresses[1].location" label="address[1].location" />    <s:submit value="submit"/></s:form>

6.json类型的数据的类型转换

 

未完,待续