WebWork之－－使用fileUpload interceptor实现文件上传[基本配置+注意事项]

    使用webwork的fileUpload interceptor，可以很方便的实现文件上传功能。以下为我在编写文件上传功能实现中的一些总结：

一：基本配置

开发环境：

服务器：tomcat 5.X

webwork版本：webwork 2.2.2

另外，需要把 apache下的commons FileUpload包放到你的classpath中，我的是直接放置在${app}/WEB-INF/lib目录下

1：webwork.properties配置

 

1. webwork.multipart.parser=jakarta              #文件解析器类型，备选项包括pell、cos、jakarta
2. webwork.multipart.saveDir=someDir      #临时文件保存路径，最好设置否则会在服务器运行日志中看到很多INFO提醒
3. webwork.multipart.maxSize=61000            #上传文件的大小上限，单位：byte   

2：xwork.xml

1. <action name="upload" class="uploadAction">
2.     <result name="success">ok.jsp</result>
3.     <result name="error">err.jsp</result>
4.     <interceptor-ref name="fileUpload">
           <param name="maximumSize">512000</param>
           <param name="allowedTypes">image/pjpeg,image/gif,image/bmp,image/jpeg</param>
      </interceptor-ref>
      <interceptor-ref name="basicStack"/>
5. </action>

3：upload.jsp

 

1. <form name="postForm" method="post" enctype="multipart/form-data" action="upload.action">
2.     <input type="file" name="doc"/>
3. </form>

4：uploadAction.java

1. public class UploadAction extends ActionSupport {
2.     private File doc;                              // 上传保存的临时文件的引用，命名和upload.jsp中doc保持一致
3.     private String docContentType;      // 文件类型，该字段命名＝文件引用名+"ContentType"
4.     private String docFileName;             // 文件名，文件名＝文件引用名+FileName
6.     public String execute() {
7.         if (doc == null) { // 当取道的文件引用为null时，表示文件不符合你设定的条件
8.             return ERROR;
9.         }
11.         // 以下为服务器文件传存、重命名等操作，临时文件不用管，fileUpload interceptor会自己处理善后工作。。。
12.     }
14.     // setters方法省略
15. }

 

二：上传代码流程说明及注意事项

 

1）程序走到fileUpload interceptor之前已经对文件在服务器端进行了保存
2）fileUpload interceptor必须在params  interceptor之前被调用，否则Action无法获取到文件的引用
3）如果能在客户端进行文件名后缀和大小的判断，需要尽量做完善。尽管大小判断的js在ie下才起作用，并且js可以被轻松绕过，也需要这样做，因为http文件传输是很消耗服务器CPU的
4）当文件大小和类型不符合fileUpload interceptor设置时，action仍旧会执行，此时得到的文件引用为null
5）可以通过getFieldErrors()方法获取fileUpload对于文件拦截操作出来结果，虽然提示信息不是很明确，而且是英文，但至少可以从中分析出是什么原因造成的不能上传

 

 

三：参考

WebWork2文档中文化计划 http://wiki.javascud.org/display/ww2cndoc/File+Upload+Interceptor

apache commons FileUpload组件网址   http://commons.apache.org/fileupload/ 

webwork fileUpload intercrptor英文介绍          http://docs.huihoo.com/webwork/2.2.6/File%20Upload%20Interceptor.html