轻量级JavaEE企业应用实战(十六)

Struts2类型转换

HTTP请求参数都是字符串类型，但JAVA是强类型的语言，因此MVC框架必须将这些字符串参数转换成相应的数据类型—所有的MVC框架都应该提供的功能
Struts2有很好的扩展性
一个数据处理，可以非常简单的开发出自己的类型转换器；如果类型转换中出现未知异常，开发者无需关心异常处理逻辑，conversionError拦截器会自动处理该异常，并在页面生成提示信息
另一个数据处理是数据校验，可分为客户端校验和服务端校验。都是必不可少：
客户端校验：主要用来过滤用户的误操作，拒绝误操作输入提交到服务器处理，降低服务器端的开销
服务端校验：防止非法数据进入程序，导致程序异常、底层数据库异常

内建的类型转换器

boolean和Boolean //字符串和布尔值之间的转换
char和Character //字符串和字符之间的转换
int和Integer
long和Long
float和Float
double和Double
Date //字符串和日期类型之间转换，日期格式使用用户请求所在Locale的SHORT格式
数组 //默认情况下，数组元素是字符串，如果提供了自定义的转换器，也可以是其他复合类型数组
集合 //默认情况下，假定集合元素类型为String，并创建新的ArrayList封装所有字符串

基于OGNL的类型转换

public class LoginAction implements Action {
    private User user;
    ...
    public String execute() throws Exception {
        ...
    }
}

<s:textField name="user.name" label="用户名" />

struts2可以将普通请求参数转换成复合类型对象，有几点要注意：
1.Struts2将通过反射来创建一个复合类的实例，因此系统必须为该复合类提供无参构造器
2.希望使用user.name请求参数的形式为实例的属性赋值，必须为user属性对应的复合类提供setName()方法，Action还应包括getUser()方法

public class LoginAction implement Action {
    private Map<String, User> users;
    public void setUsers(Map<String, User> user) {
        this.users = users;
    }
    public void getUsers() {
        return users;
    }
    ...
}

<s:textField name="users['one'].name" /> //one是key

如果使用List进行封装
private List<User>;

<s:textField name="user[0].name" />

指定集合元素的类型

Struts2允许开发者通过局部类型转换文件来指定集合元素的类型。类型转换文件是一个普通的Properties文件，类型转换文件里提供了类型转换的相关配置信息

public class LoginAction implements Action {
    private List users;
    //get、set方法省略

    public String execute() throws Exception {
        User firstUser = (User)getUsers().get(0);
    }
}

局部类型转换文件的文件名应为：ActionName-conversion.properties形式，其中ActionName是需要Action的类名，后边的-conversion.properties字符串则是固定部分；类型转换文件应该放在和Action文件相同的位置

为了指定List集合里元素的数据类型，需要指定两个部分
1.List集合属性的名称
2.List集合里元素的类型

Element_<ListPropName>=<ElementType>
Element_users=com.entity.User

如果是Map
Key_<MapPropName>=<KeyType>

自定义类型转换器

public class LoginAction implements Action {
    private User user;
    //get、set方法省略

    public String execute() throws Exception {
        if(getUser().getName().equals("111")) {
            ...
        }
    }
}

Struts2类型转换器基于OGNL框架，接口是TypeConverter
public interface TypeConverter {
    public Object convertValue(Map context, Object target,
    Member member, String propertyName, Object value, Class toType);
}

public class UserConverter extends DefaultTypeConverter {
    //类型转换器必须重写convertValue方法，该方法需要完成双向转换
    public Object convertValue(Map context, Object value, Class toType) {
        //将需要将字符串向User类型转换
        if(toType == User.class) {
            //系统的请求参数是一个字符串数组
            String[] params = (String[]) value;
            User user = new User();
            //只处理请求参数的第一个数组元素，病讲该字符串以英文逗号分隔
            String[] userValues = params[0].split(",");
            user.setName(userValues[0]);
            user.setPassword(userValues[1]);

            return user;
        } else if(toType == String.class) {
            User user = (User) value;
            return "<" + user.getName() + ">";
        }

        return null;
    }
}

convertValue方法的作用是完成类型的转换，不过这种转换是双向的：当需要把字符串转换成User实例时，是通过该方法实现的；当需要把User转换成字符串，也是通过该方法

convertValue方法参数和返回值的意义：
参数一：context是类型转换环境的上下文
参数二：value是需要转换的参数，可能是字符串数组或对象
参数三：toType是转换后的目标类型

为什么value是字符串数组而不是字符串？
答：在前边了解中，说：浏览器发送的请求参数类型是字符串，而不是字符串数组；但是发送参数时，可能出现多个选中值，因此可能出现字符串数组形式
对于DefaultTypeConverter而言，必须考虑到最通用的情形，因此把所有的清秋参数都视为字符串数组，而不是字符串；对于字符串，当做长度为1的字符串数组

注册类型转换器

Struts2支持三种类型的类型转换器
注册局部类型转换器：仅仅对某个Action的属性起作用
注册全局类型转换器：对所有Action的特定类型的属性都起效
使用jDK1.5的注释来注册类型转换器：使用注释方式来注册类型转换器

局部
文件放在对应Action的路径下，文件名ActionName-conversion.properties
user=com.converter.UserConverter

全局
文件放在WEB-INF/class路径下，名称xwork-conversion.properties
com.entity.User=com.conversion.UserConverter

说明：
局部类型转换器只对指定Action的指定属性进行转换，无论是数组还是集合，该转换器的转换方法对该属性只进行一次
全局类型转换器对所有Action的特定类型进行转换，如果一个Action的某个属性是数组或集合，二数组或集合元素是需要该转换器转换的方法，那么全局类型转换对该集合的每个元素进行转换

处理set集合

Set集合处于无序状态，所以不能准确将参数转换成Set元素；并且Struts2也不能准确读取Set集合里的元素
除非Set集合里的元素有一个标识属性，该属性可以唯一的表示集合元素

为了让Struts2明白set属性的标识属性，指定它使用标识属性来读取Set集合元素
public class LoginAction implements Action {
    private Set users;
    //省略get和set
}

public class UserConverter extends StrutsTypeConverter {
    public Object convertFromString(Map context, String[] values, Class toClass) {
        Set result = new HashSet();
        for(int i=0; i<values.length; i++) {
            User user = new User();
            String[] userValues=values[i].split(",");
            user.setName(userValues[0]);
            user.setPassword(userValue[1]);
            result.add(user);
        }
        return result;
    }
}

重写User的equals和hashCode方法
public class User {
    private String name;
    private String password;

    public boolean equals(Object obj) {
        if(this == obj)
            return true;
        if(obj != null && obj.getClass() == User.class){
            User user = (User) obj;
            if(this.getName().equals(user.getName()))
                return true;
        }
        return false;
    }

    public int hashCode() {
        return name.hashCode();
    }
}

在局部类型转换文件中添加
users=com.converter.UserConverter
KeyProperty_users=name

获取
<s:property value="users('111').name">

类型转换中的错误处理

Struts2提供了一个名为conversionError的拦截器，被注册在默认的拦截器栈中

<interceptor-stack name="defaultStack">
    ...
    <interceptor-ref name="conversionError" />
    <interceptor-ref name="validation">
        <param name="excludemethods">input,back,cancel,browse</param>
    </interceprot-ref>
</interceptor>