传智播客－struts2（6）－数据校验、数据转换与文件上传

struts2并不仅仅只有前面所写的这点内容，不过本人又不是写书，加这篇已经写了六篇，对得起观众了（咳咳。。如果有的话。。。）～～～另外，要强调的是，struts2的OGNL表达式功能其实无比强大，远不止前面写的那一点点皮毛，开发时如果希望能将struts2的功能运用得得心应手的话，还是要多看文档，多实践的，当然最好的捷径是－－来传智播客，这边的授课老师已经把官方文档过了一遍，所以可以省却我们自学struts2的很多时间，诸如查看，理解，重点和细节等等，而且因为这里的老师普遍技术功底扎实而且从业经验丰富，还可以避免我们自学时绕弯路。最重要的是，传智的老师都是很尽责的！知无不言，言无不尽！

 

数据校验
在struts2中，我们可以实现对action的所有方法进行校验或者对action的指定方法进行校验。

 

对于输入校验struts2提供了两种实现方法:
1、采用手工编写代码实现。
通过重写validate() 方法实现， validate()方法会校验action中所有与execute方法签名相同的方法。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。

 

2、基于XML配置方式实现。
使用基于XML配置方式实现输入校验时，Action也需要继承ActionSupport，并且提供校验文件，校验文件和action类放在同一个包下，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为cn.itcast.UserAction，那么该文件的取名应为：UserAction-validation.xml。下面是校验文件的模版：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
    <field name="username">
        <field-validator type="requiredstring">
            <param name="trim">true</param>
            <message>用户名不能为空!</message>
        </field-validator>
    </field>
</validators>

<field>指定action中要校验的属性，<field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。
<message>为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。
在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。

 

数据转换
举例来说，java.util.Date类型的属性可以接收格式为2009-07-20的请求参数值。但如果我们需要接收格式为20091221的请求参数，就必须定义类型转换器，否则struts2无法自动完成类型转换。
public class HelloWorldAction {
 private Date createtime;

 public Date getCreatetime() {
  return createtime;
 }

 public void setCreatetime(Date createtime) {
  this.createtime = createtime;
 }
}
// Struts2的转换器为双向的，转换器要实现TypeConverter接口，或者继承DefaultTypeConverter和StrutsTypeConverter两个类中的一个
public class DateConverter extends DefaultTypeConverter {
 @Override
 public Object convertValue(Map context, Object value, Class toType) {
  SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMdd");
  try {
   if (toType == Date.class) { // 当字符串向Date类型转换时
    String[] params = (String[]) value; // Request.getParameterValues()
    return dateFormat.parse(params[0]);
   } else if (toType == String.class) { // 当Date转换成字符串时

    Date date = (Date) value;
    return dateFormat.format(date);
   }
  } catch (ParseException e) {
  }
  return null;
 }
}

 

1、将上面的类型转换器注册为局部类型转换器。
在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties。在properties文件中的内容为：属性名称=类型转换器的全类名。
对于本例而言，HelloWorldAction-conversion.properties文件中的内容为：createtime= cn.itcast.conversion.DateConverter。

 

2、将上面的类型转换器注册为全局类型转换器。
在WEB-INF/classes下放置xwork-conversion.properties文件。在properties文件中的内容为：待转换的类型=类型转换器的全类名。
对于本例而言，xwork-conversion.properties文件中的内容为：java.util.Date= cn.itcast.conversion.DateConverter。

 

文件上传
这个其实很容易实现滴，底层struts2已经帮忙写好了，咱会用就成。
1、把form表单的enctype设置为：“multipart/form-data“。
2、在action中要定义与浏览器端的File表单元素名称相同的File类型的属性来接收浏览器上传的文件，还可以定义两个String类型的变量分别接收文件的名称和内容大小，它们的属性名称分为File类型的属性名后面加上“FileName”和“ContentType”。Struts2对于没有上传文件的file字段，不生成后台对应的属性结果，即其后台对应的属性为null。

 

示例代码：
public class HelloWorldAction {
 private File[] uploadImages; // 得到上传的文件
 private String[] uploadImagesContentType; // 得到文件的类型
 private String[] uploadImagesFileName; // 得到文件的名称

 // 这里略省了属性的getter/setter方法
 public String upload() throws Exception {
  String realpath = ServletActionContext.getServletContext().getRealPath("/images");
  File file = new File(realpath);
  if (!file.exists())
   file.mkdirs();
  for (int i = 0; i < uploadImages.length; i++) {
   File uploadImage = uploadImages[i];
   FileUtils.copyFile(uploadImage, new File(file,
     uploadImagesFileName[i]));
  }
  return "success";
 }
}