Spring MVC的文件上传

概述
文件上传是Java Web项目中的常用功能，未达到上传文件的目的，需进行下列步骤：
1.表单的method属性必须设置为POST。
2.表单的enctype属性必须设置为multipart/form-data(浏览器才会使用二进制流的方式来处理表单数据)。
3.pom文件中添加commons-fileupload依赖。
4.在Spring MVC的配置文件中配置MultipartResolver。
文件上传示例
示例程序依然在前文的SpringMVCProject项目中完成（前文连接：https://www.jianshu.com/p/fde4557c527c）。
文件上传页面的背景图片
在项目的webapp目录下创建文件夹“images”，放入一张背景图片，命名为“backImage.jpg”：

POM文件配置
在项目的pom文件中添加commons-fileupload依赖：

  1 <dependency>
  2     <groupId>commons-fileupload</groupId>
  3     <artifactId>commons-fileupload</artifactId>
  4     <version>1.4</version>
  5 </dependency>

创建JSP文件
在项目的webapp目录下创建uploadfile.jsp文件，编写如下程序：

  1 <%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8"%>
  2 <html>
  3 <head>
  4     <meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
  5     <title>uploadfile</title>
  6     <style type="text/css">
  7         body{
  8             background-image: url(images/backImage.jpg);
  9             background-size:cover;
 10         }
 11     </style>
 12 </head>
 13 <body>
 14 <center>
 15 <h3>文件上传页面</h3>
 16 <br>
 17 <form action="upload" method="post" enctype="multipart/form-data">
 18     <table>
 19         <tr>
 20             <td><label>文件信息：</label></td>
 21             <td><input type="text" name="information"></td>
 22         </tr>
 23         <tr>
 24             <td><label>选择文件：</label></td>
 25             <td><input type="file" name="file"></td>
 26         </tr>
 27         <tr>
 28             <td><input type="submit" id="submit" value="上传"></td>
 29         </tr>
 30     </table>
 31 </form>
 32 </center>
 33 </body>
 34 </html>

创建Controller类
在com.snow.dcl.controller包下创建UploadFileController类文件，编写如下程序：

  1 @Controller
  2 public class UploadFileController {
  3     @RequestMapping(value = "/upload", method = RequestMethod.POST)
  4     @ResponseBody
  5     public String upload(HttpServletRequest request, @RequestParam("information") String information, @RequestParam("file") MultipartFile file) throws IOException {
  6         if (!file.isEmpty()) {
  7             String path = request.getServletContext().getRealPath("file");
  8             String fileName = file.getOriginalFilename();
  9             File uploadFile = new File(path, fileName);
 10             if (!uploadFile.getParentFile().exists()) {
 11                 uploadFile.getParentFile().mkdirs();
 12             }
 13             file.transferTo(new File(path + File.separator + fileName));
 14             return "Success!";
 15         } else {
 16             return "No File!";
 17         }
 18     }
 19 }

在该控制器程序中使用了@ResponseBody注解，可以给前端返回“文件上传成功！”和“未添加上传文件！”的字符串数据，否则在Spring MVC的配置文件springmvc-servlet.xml中配置的是返回视图jsp文件。
springmvc-servlet.xml文件配置
在springmvc-servlet.xml文件中配置MultipartResolver，配置文件增加内容如下：

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <beans xmlns="http://www.springframework.org/schema/beans"
  3       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4       xmlns:context="http://www.springframework.org/schema/context"
  5       xmlns:mvc="http://www.springframework.org/schema/mvc"
  6       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
  7 
  8     <!--spring可以自动扫描base-package设置的包或子包下的java类，如果扫描到有spring相关注解的类，则注册为spring的bean-->
  9     <context:component-scan base-package="com.snow.dcl.controller"/>
 10 
 11     <mvc:annotation-driven />
 12     <mvc:default-servlet-handler/>
 13 
 14     <!--视图解析器-->
 15     <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
 16         <property name="prefix">
 17             <value>/WEB-INF/content/</value>
 18         </property>
 19         <property name="suffix">
 20             <value>.jsp</value>
 21         </property>
 22     </bean>
 23 
 24     <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
 25         <!-- 上传文件大小20M以内 -->
 26         <property name="maxUploadSize">
 27             <value>20971520</value>
 28         </property>
 29         <!-- 请求的编码格式，必须与JSP文件中的pageEncoding属性值相同 -->
 30         <property name="defaultEncoding">
 31             <value>UTF-8</value>
 32         </property>
 33     </bean>
 34 
 35 </beans>
 36

注意：
1. 配置MultipartResolver的同时还添加了mvc的命名空间。
2. 添加<mvc:default-servlet-handler/>配置用来处理背景图片等静态资源。
3. 添加<mvc:default-servlet-handler/>配置就必须添加<mvc:annotation-driven />否则会出现@Controller注解无法解析的情况，导致请求时候都没有匹配的处理请求类，就都去<mvc:default-servlet-handler/>即default servlet处理了，静态资源（如图片资源）因为没有对应的Controller则会被default servlet处理。
测试
启动TomcatServer，启动完成后，打开浏览器输入：http://localhost:8080/uploadfile.jsp，访问成功。

不添加任何文件，直接提交：

添加测试用的txt文件：

提交：

查看项目目录，在target目录的项目目录下会生成file目录，上传的文件在file目录中：

至此，文件上传功能记录完毕。

Spring MVC的文件上传

猜你喜欢