Spring MVC环境中文件上传功能的实现方法详解

前言

我们在实际开发过程中，尤其是web项目开发，文件上传和下载的需求的功能非常场景，比如说用户头像、商品图片、邮件附件等等。其实文件上传下载的本质都是通过流的形式进行读写操作，而在开发中不同的框架都会对文件上传和下载有或多或少的封装，这里就以Spring MVC环境中文件的上传为例，讲解Spirng MVC环境下的文件上传功能实现。下面话不多说了，来一起看看详细的介绍吧。

一、客户端编程

由于多数文件上传都是通过表单形式提交给后台服务器的，因此，要实现文件上传功能，就需要提供一个文件上传的表单。同时该表单必须满足以下3个条件：

form表单的method属性设置为post；
form表单的enctype属性设置为multipart/form-data；
提供<input type="file" name="fileName" />的文件上传输入框。

在HTML5之前，如果想要上传多个文件，必须使用多个<input>元素。但是在HTML5中，在<input>元素配置multiple属性即可进行多个文件的上传。在HTML5中编写以下任意一行代码，便可生成一个按钮供选择多个文件：

<input type="file" name="fileName" multiple />
<input type="file" name="images" multiple="multiple" />
<input type="file" name="images" multiple="" />

具体代码示例如下：

									<form action="uploadUrl" method="post" enctype="multipart/form-data">

									 <input type="file" name="images" multiple="multiple" />

									 <input type="submit" value="文件上传" />

									</form>

二、springmvc-config.xml配置文件配置

当客户端form表单的enctype属性为multipart/form-data时，浏览器就会采用二进制流的方式来处理表单数据，而对于文件上传的处理则涉及在服务器端解析原始的HTTP请求。Spring MVC为文件上传提供了直接的支持，这种支持是用即插即用的MultipartResolver实现的。

在Sring MVC中使用MultipartResolver也非常简单，只需要在Spring MVC配置文件springmvc-config.xml中定义MultipartResolver接口实现类即可，示例如下：

									<!-- 配置文件上传类型解析器 multipartResolver-->

									<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

									 <!-- 设置上传文件最大尺寸，单位为B -->

									 <property name="maxUploadSize" value="5242880" />

									</bean>

注意：

由于MultipartResolver实现类CommonsMultipartResolver内部是引用multipartResolver字符串获取该实现类对象并完成文件上传操作的，所以在配置CommonsMultipartResolver时必须指定该bean的id为multipartResolver。另外由于MultipartResolver实现类CommonsMultipartResolver是Spring MVC内部通过Apache Commons FileUpload技术实现的。因此Spirng MVC的文件上传还需要依赖Apache Commons FileUpload的组件，即需要导入支持文件上传和下载的JAR包，具体如下：

commons-fileupload.jar
commons-io.jar

三、后台文件下载实现（MultipartFile接口介绍）

当完成上述客户端代码的编写及文件上传组件的配置后，在Spring MVC中处理已经上传的文件就十分容易了，上传到Spring MVC程序中的文件会被封装到一个MultipartFile对象中，然后开发者通过该对象的方法就可以进行后续相关处理了。

编写后台文件上传控制器类及方法，具体示例如下：

									/**

									 * 向文件上传页面跳转

									 */

									@RequestMapping("/toFileUpload")

									public String toFileUpload( ){

									 return "fileUpload";

									}

									/**

									 * 接收文件上传请求

									 */

									@RequestMapping("/fileUpload")

									public String fileUpload(List<MultipartFile> images){

									 //对上传图像进行解析操作

									 if(images !=null && images.size()>0){

									  for (MultipartFile image : images) {

									   //获取上传文件的原始名称

									   String originalFilename = image.getOriginalFilename();

									   //设置上传文件的保存地址目录

									   String dirPath="D:\\fileUpload\\";

									   File file =new File(dirPath);

									   //如果保存文件的地址不存在，就先创建目录

									   if(!file.exists()){

									    file.mkdirs();

									   }

									   //使用UUID重新命名上传的文件名称（看公司需求，也可以用日期时间）

									   String newFilename= UUID.randomUUID()+originalFilename.substring(originalFilename.lastIndexOf("."));

									   try {

									    //使用MultipartFile接口的方法完成文件上传到指定位置

									    image.transferTo(new File(dirPath+newFilename));

									    //文件上传成功后，需要将文件存放路径存入数据库中

									    //TODO,省略

									   } catch (Exception e) {

									    e.printStackTrace();

									    //当文件上传出现异常，则重定向到文件上传页面

									    return "redirect:toFileUpload";

									   } 

									  }

									 }

									 //文件上传成功后，跳转到成功页面

									 return "success";

									}