巧妙使用spring对commons fileUpload的包装

        以前简单使用过spring的文件上传，当时没深入研究，以为spring只能实现单个文件的上传，所以后来就又大致学了下commons fileupload组件。在最近的工作中，有同事提出，他在把commons fileupload组件集成到spring中时总是出错，然后我大致看了一下，发现是spring DispatcherServlet的缘故。然后google了一下，发现sping本身就包装了commons fileupload，并且很好用。汗颜！

一.前台页面        

         我们的目标是要实现多文件上传，并且预先我并不知道客户要上传多少个文件。我们先写个jsp页面吧，要实现可以动态控制上传多少文件，基本代码如下：

         < form  method ="post"  action ="./upload.do"  enctype ="multipart/form-data" >
             < div  id ="uploadDiv" >
                 < input  type ="file"  name ="file1"   />
             </ div >
             < input  type ="button"  value ="继续上传"  onclick ="javascript:btn_click();" >
             < input  type ="hidden"  id ="fileCount"  name ="fileCount"  value ="1" >
             < input  type ="submit"  value ="上传"   />
         </ form >

恩，要实现动态控制上传文件个数，我们需要使用伟大的javascript了

  function  btn_click() ... {
  var fileNo=Number(document.getElementById('fileCount').value)+1;
  newDiv=document.createElement("div")
  newDiv.id="divFile"+fileNo;
  document.getElementById('uploadDiv').appendChild(newDiv)
  document.getElementById('fileCount').value=fileNo;
  newDiv.innerHTML="<input type='file' name='file"+fileNo+"'>";
 }

ok，现在我们的界面如下：http://dl2.youkuaiyun.com/down4/20070710/10163733412.JPG

二.后台实现    

  1. 好了，前台我们搞定了，现在考虑一下后台处理吧。我写了一个Command Bean，非常简单，如下：

public   class  FUploadBean  ... {
 private byte[] file;
 public byte[] getFile() ...{
  return file;
 }
 public void setFile(byte[] file) ...{
  this.file = file;
 }
}

 在spring Web MVC模式中，必须定义一个Command对象，将其和Form表单绑定。这个command class需要在spring上下文中进行配置，可以作为controller的property进行配置。呆会会在配置文件中看到相关配置。

2. 然后就是一个Controller

public   class  FUploadController  extends  SimpleFormController  ... {

 public ModelAndView onSubmit(HttpServletRequest request,
   HttpServletResponse res, Object obj, BindException errors)
   throws Exception ...{

  MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;

  int fileCount = Integer.parseInt(request.getParameter("fileCount"));

  for (int i = 1; i <= fileCount; i++) ...{
   CommonsMultipartFile cFile = (CommonsMultipartFile) multipartRequest.getFile("file" + i);
   File uploadedFile = new File("E:/upload" + "/"+ cFile.getOriginalFilename());
   FileCopyUtils.copy(cFile.getBytes(), uploadedFile);
  }

  return null;
 }

 // 注册一个spring的编辑器非常重要，没有这个方法，上传将不能进行
 protected void initBinder(HttpServletRequest request,
   ServletRequestDataBinder binder) throws ServletException ...{
  binder.registerCustomEditor(byte[].class,
    new ByteArrayMultipartFileEditor());
 }
}

注意:必须定义initBinder方法。

三.配置文件

接下来就是配置文件了，熟悉spring的人应该很容易看懂了。

1.web.xml

     < servlet >
         < servlet-name > springStudy </ servlet-name >
         < servlet-class >
            org.springframework.web.servlet.DispatcherServlet
         </ servlet-class >
         < load-on-startup > 1 </ load-on-startup >
     </ servlet >
     < servlet-mapping >
         < servlet-name > springStudy </ servlet-name >
         < url-pattern > *.do </ url-pattern >
     </ servlet-mapping >

2.springStudy-servlet.xml

     < bean  id ="multipartResolver"
        class ="org.springframework.web.multipart.commons.CommonsMultipartResolver" >
         < property  name ="maxUploadSize"  value ="50000000"   />
         <property name="defaultEncoding" value="utf-8" />
     </ bean >

     < bean  id ="urlMapping"
        class ="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping" >
         < property  name ="mappings" >
             < props >
                 < prop  key ="/upload.do" > uploadServlet </ prop >
             </ props >
         </ property >
     </ bean >
     < bean  id ="uploadServlet"
        class ="chb.spring.study.web.FUploadController" >
         < property  name ="commandClass"
            value ="chb.spring.study.web.FUploadBean"   />
     </ bean >

注：需要注意的是，在spring中要实现文件上传，必须在spring的上下文中定义MultipartResolver，这样spring在发现该表单请求是mutipart时，就会使用spring定义的解析器去解析。这里我们使用的是
CommonsMultipartResolver，也就是会转化为commons fileupload。CommonsMultipartResolver继承自CommonsFileUploadSupport，而CommonsFileUploadSupport是对commons fileupload组件的包装，所以我们可以在定义multipartResolver时设置相关参数，比如最大允许上传文件数，字符编码等。这里设置<property name="defaultEncoding" value="utf-8" />就是为了解决中文问题。